QTextCharFormat Class

メンバ関数のドキュメント

QTextCharFormat::QTextCharFormat()

新しい文字形式オブジェクトを作成します。

QString QTextCharFormat::anchorHref() const

テキスト形式のハイパーテキストリンクを返します。設定されていない場合は、空の文字列を返します。

setAnchorHref()も参照してください 。

QStringList QTextCharFormat::anchorNames() const

このテキスト形式に関連付けられたアンカー名を返します。アンカー名が設定されていない場合は、空の文字列リストを返します。アンカー名が設定されている場合、この形式のテキストをハイパーテキストリンクのリンク先として指定できます。

setAnchorNames()も参照してください 。

[since 6.0] qreal QTextCharFormat::baselineOffset() const

ベースラインのオフセットを％単位で返します。

この関数は Qt 6.0 で導入されました。

setBaselineOffset()、setSubScriptBaseline()、subScriptBaseline()、setSuperScriptBaseline()、およびsuperScriptBaseline()も参照してください 。

QFont QTextCharFormat::font() const

この文字フォーマットのフォントを返します。

この関数は、フォーマットのフォント属性（fontWeight() やfontPointSize() など）を考慮し、以下のように定義されたデフォルトのフォントに基づいてそれらを解決します。フォーマットがドキュメントの一部である場合、そのドキュメントのデフォルトフォントが使用されます。それ以外の場合は、デフォルトで生成されたQFont に基づいてプロパティが解決されます。

たとえば、このフォーマットのフォントサイズがデフォルトのフォントから変更されていない場合、fontPointSize() は 0 を返し、font().pointSize() は描画に使用される実際のサイズを返します。

setFont() およびQTextDocument::defaultFont()も参照してください 。

QFont::Capitalization QTextCharFormat::fontCapitalization() const

フォントの現在の大文字小文字の区別方式を返します。

setFontCapitalization()も参照してください 。

QVariant QTextCharFormat::fontFamilies() const

テキスト形式のフォントファミリーを返します。

setFontFamilies() およびfont()も参照してください 。

[since 6.11] QMap<QFont::Tag, quint32> QTextCharFormat::fontFeatures() const

テキスト形式のフォントの組版上の特徴を取得します。

この関数は Qt 6.11 で導入されました。

setFontFeatures()も参照してください 。

bool QTextCharFormat::fontFixedPitch() const

テキスト形式のフォントが等幅フォントの場合は `true ` を返し、それ以外の場合は `false` を返します。

setFontFixedPitch() およびfont()も参照してください 。

QFont::HintingPreference QTextCharFormat::fontHintingPreference() const

このテキスト形式に設定されているヒンティング設定を返します。

setFontHintingPreference()、font()、およびQFont::hintingPreference()も参照してください 。

bool QTextCharFormat::fontItalic() const

テキスト形式のフォントがイタリック体の場合は `true ` を返し、それ以外の場合は `false` を返します。

setFontItalic() およびfont()も参照してください 。

bool QTextCharFormat::fontKerning() const

フォントのカーニングが有効になっている場合、true を返します。

setFontKerning() およびfont()も参照してください 。

qreal QTextCharFormat::fontLetterSpacing() const

現在の文字間隔を返します。

setFontLetterSpacing()、setFontLetterSpacingType()、およびfontLetterSpacingType()も参照してください 。

QFont::SpacingType QTextCharFormat::fontLetterSpacingType() const

このフォーマットの文字間隔の種類を返します。

setFontLetterSpacingType()、setFontLetterSpacing()、およびfontLetterSpacing()も参照してください 。

bool QTextCharFormat::fontOverline() const

テキスト形式のフォントに上線が付いている場合は `true ` を返し、そうでない場合は `false` を返します。

setFontOverline() およびfont()も参照してください 。

qreal QTextCharFormat::fontPointSize() const

この形式でテキストを表示する際に使用されるフォントサイズを返します。

setFontPointSize() およびfont()も参照してください 。

int QTextCharFormat::fontStretch() const

現在のフォントの伸縮率を返します。

setFontStretch()も参照してください 。

bool QTextCharFormat::fontStrikeOut() const

テキスト形式のフォントが取り消し線付き（横線が引かれている）場合は `true ` を返し、それ以外の場合は `false` を返します。

setFontStrikeOut() およびfont()も参照してください 。

QFont::StyleHint QTextCharFormat::fontStyleHint() const

フォントスタイルのヒントを返します。

setFontStyleHint() およびfont()も参照してください 。

QVariant QTextCharFormat::fontStyleName() const

テキスト形式のフォントスタイル名を返します。

setFontStyleName()、font()、およびQFont::styleName()も参照してください 。

QFont::StyleStrategy QTextCharFormat::fontStyleStrategy() const

現在のフォントスタイル戦略を返します。

setFontStyleStrategy() およびfont()も参照してください 。

bool QTextCharFormat::fontUnderline() const

テキスト形式のフォントに下線が引かれている場合は `true ` を返し、そうでない場合は `false` を返します。

setFontUnderline() およびfont()も参照してください 。

[since 6.11] QMap<QFont::Tag, float> QTextCharFormat::fontVariableAxes() const

テキスト形式のフォントの可変軸を取得します。

この関数は Qt 6.11 で導入されました。

setFontVariableAxes()も参照してください 。

int QTextCharFormat::fontWeight() const

テキスト形式のフォントの太さを返します。

setFontWeight()、font()、およびQFont::Weightも参照してください 。

qreal QTextCharFormat::fontWordSpacing() const

現在の単語間隔の値を返します。

setFontWordSpacing()も参照してください 。

bool QTextCharFormat::isAnchor() const

テキストがアンカーとしてフォーマットされている場合は `true ` を返し、そうでない場合は `false` を返します。

setAnchor()、setAnchorHref()、およびsetAnchorNames()も参照してください 。

bool QTextCharFormat::isValid() const

この文字形式が有効な場合は `true ` を返し、そうでない場合は `false` を返します。

void QTextCharFormat::setAnchor(bool anchor)

anchor が true の場合、この形式のテキストはアンカーを表し、適切な形式で表示されます。そうでない場合は、テキストは通常通り表示されます。（アンカーとはハイパーリンクのことで、多くの場合、下線が引かれ、プレーンテキストとは異なる色で表示されます。）

テキストの表示方法は、その書式に有効なアンカーが定義されているかどうかとは無関係です。ハイパーテキストリンクを作成するには、setAnchorHref() を使用し、必要に応じてsetAnchorNames() を使用してください。

isAnchor()も参照してください 。

void QTextCharFormat::setAnchorHref(const QString &value)

テキスト形式のハイパーテキストリンクを、指定されたvalue に設定します。これは通常、「http://example.com/index.html」のようなURLです。

アンカーは、value を表示テキストとして表示されます。別のテキストを表示したい場合は、setAnchorNames() を呼び出してください。

テキストをハイパーテキストリンクとしてフォーマットするには、setAnchor() を使用します。

anchorHref()も参照してください 。

void QTextCharFormat::setAnchorNames(const QStringList &names)

テキスト形式のアンカーnames を設定します。アンカーをハイパーリンクとして機能させるには、setAnchorHref() でリンク先を設定し、setAnchor() でアンカーを有効にする必要があります。

anchorNames()も参照してください 。

[since 6.0] void QTextCharFormat::setBaselineOffset(qreal baseline)

テキストのベースライン（高さの％で指定）を `baseline` に設定します。正の値はテキストをその％分だけ上に移動させ、負の値は下に移動させます。デフォルト値は 0 です。

この関数は Qt 6.0 で導入されました。

baselineOffset()、setSubScriptBaseline()、subScriptBaseline()、setSuperScriptBaseline()、およびsuperScriptBaseline()も参照してください 。

void QTextCharFormat::setFont(const QFont &font, QTextCharFormat::FontPropertiesInheritanceBehavior behavior = FontPropertiesAll)

テキスト形式の「font 」を設定します。

behavior がQTextCharFormat::FontPropertiesAll の場合、明示的に設定されていないフォントプロパティは、デフォルト値が設定されたものとして扱われます。behavior がQTextCharFormat::FontPropertiesSpecifiedOnly の場合、明示的に設定されていないフォントプロパティは無視され、それぞれのプロパティ値は変更されません。

font()も参照してください 。

void QTextCharFormat::setFontCapitalization(QFont::Capitalization capitalization)

このフォントで表示されるテキストの大文字小文字の設定を「capitalization 」に設定します。

フォントの大文字化設定により、テキストは選択された大文字化モードで表示されます。

fontCapitalization()も参照してください 。

void QTextCharFormat::setFontFamilies(const QStringList &families)

テキスト形式のフォントを設定します。families 。

fontFamilies() およびsetFont()も参照してください 。

[since 6.11] void QTextCharFormat::setFontFeatures(const QMap<QFont::Tag, quint32> &fontFeatures)

テキスト形式のフォントの組版特性を「fontFeatures 」に設定します。

この関数は Qt 6.11 で導入されました。

fontFeatures() およびQFont::setFeature()も参照してください 。

void QTextCharFormat::setFontFixedPitch(bool fixedPitch)

fixedPitch が true の場合、テキスト形式のフォントを等幅フォントに設定します。そうでない場合は、等幅ではないフォントが使用されます。

fontFixedPitch() およびsetFont()も参照してください 。

void QTextCharFormat::setFontHintingPreference(QFont::HintingPreference hintingPreference)

テキスト形式のフォントのヒンティング設定を「hintingPreference 」に設定します。

fontHintingPreference()、setFont()、およびQFont::setHintingPreference()も参照してください 。

void QTextCharFormat::setFontItalic(bool italic)

italic が true の場合、テキスト形式のフォントをイタリック体に設定します。そうでない場合は、フォントはイタリック体以外になります。

fontItalic() およびsetFont()も参照してください 。

void QTextCharFormat::setFontKerning(bool enable)

enable がtrueの場合、このフォントのカーニングを有効にします。そうでない場合は無効にします。

カーニングが有効になっている場合、ラテン文字のテキストであっても、グリフのメトリクスの合計値はもはや正確ではなくなります。つまり、width('a') + width('b') が width("ab") に等しいという仮定は、必ずしも成り立たないということです。

fontKerning() およびsetFont()も参照してください 。

void QTextCharFormat::setFontLetterSpacing(qreal spacing)

この書式の文字間隔を、指定されたspacing に設定します。この値の意味は、フォントの文字間隔タイプによって異なります。

パーセンテージ単位の文字間隔の場合、値 100 はデフォルトの間隔を示し、値 200 は 1 文字が占めるスペースを 2 倍にします。

fontLetterSpacing()、setFontLetterSpacingType()、およびfontLetterSpacingType()も参照してください 。

void QTextCharFormat::setFontLetterSpacingType(QFont::SpacingType letterSpacingType)

このフォーマットの文字間隔の種類を「letterSpacingType 」に設定します。

fontLetterSpacingType()、setFontLetterSpacing()、およびfontLetterSpacing()も参照してください 。

void QTextCharFormat::setFontOverline(bool overline)

overline が true の場合、テキスト形式のフォントに下線を引いた状態を設定します。そうでない場合は、フォントは下線なしの状態で表示されます。

fontOverline() およびsetFont()も参照してください 。

void QTextCharFormat::setFontPointSize(qreal size)

テキスト形式のフォントを設定します。size 。

fontPointSize() およびsetFont()も参照してください 。

void QTextCharFormat::setFontStretch(int factor)

フォントのストレッチ係数をfactor に設定します。

ストレッチ係数は、フォント内のすべての文字の幅を、その係数（パーセント）分だけ変更します。 たとえば、factor を150に設定すると、フォント内のすべての文字の幅が1.5倍（つまり150%）になります。デフォルトのストレッチ係数は100です。ストレッチ係数の最小値は1、最大値は4000です。

ストレッチ係数はアウトラインフォントにのみ適用されます。ビットマップフォントの場合、ストレッチ係数は無視されます。

fontStretch()も参照してください 。

void QTextCharFormat::setFontStrikeOut(bool strikeOut)

strikeOut が true の場合、テキスト形式のフォントを、取り消し線（横線）が有効な状態に設定します。そうでない場合は、取り消し線なしで表示されます。

fontStrikeOut() およびsetFont()も参照してください 。

void QTextCharFormat::setFontStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = QFont::PreferDefault)

フォントスタイル「hint 」および「strategy 」を設定します。

Qtは、X11におけるスタイルヒントをサポートしていません。これは、ウィンドウシステムがこの情報を提供していないためです。

fontStyleHint()、setFont()、およびQFont::setStyleHint()も参照してください 。

void QTextCharFormat::setFontStyleName(const QString &styleName)

テキスト形式のフォント「styleName 」を設定します。

fontStyleName()、setFont()、およびQFont::setStyleName()も参照してください 。

void QTextCharFormat::setFontStyleStrategy(QFont::StyleStrategy strategy)

フォントスタイルを「strategy 」に設定します。

fontStyleStrategy()、setFont()、およびQFont::setStyleStrategy()も参照してください 。

void QTextCharFormat::setFontUnderline(bool underline)

underline が true の場合、テキスト形式のフォントに下線を設定します。そうでない場合は、下線なしの状態で表示されます。

fontUnderline() およびsetFont()も参照してください 。

[since 6.11] void QTextCharFormat::setFontVariableAxes(const QMap<QFont::Tag, float> &fontVariableAxes)

テキスト形式のフォントの変数軸を `fontVariableAxes` に設定します。

この関数は Qt 6.11 で導入されました。

fontVariableAxes() およびQFont::setVariableAxis()も参照してください 。

void QTextCharFormat::setFontWeight(int weight)

テキスト形式のフォントの太さを「weight 」に設定します。

fontWeight()、setFont()、およびQFont::Weightも参照してください 。

void QTextCharFormat::setFontWordSpacing(qreal spacing)

この書式の文字間隔を、指定されたspacing （ピクセル単位）に設定します。

fontWordSpacing()も参照してください 。

[since 6.0] void QTextCharFormat::setSubScriptBaseline(qreal baseline)

下付き文字の基線を、フォント高さの%としてbaseline に設定します。デフォルト値は16.67%（高さの1/6）です。

この関数は Qt 6.0 で導入されました。

subScriptBaseline()、setSuperScriptBaseline()、superScriptBaseline()、setBaselineOffset()、およびbaselineOffset()も参照してください 。

[since 6.0] void QTextCharFormat::setSuperScriptBaseline(qreal baseline)

baseline に対して、上付き文字の基線をフォント高さのパーセンテージとして設定します。デフォルト値は 50%（高さの 1/2）です。

この関数は Qt 6.0 で導入されました。

superScriptBaseline()、setSubScriptBaseline()、subScriptBaseline()、setBaselineOffset()、およびbaselineOffset()も参照してください 。

void QTextCharFormat::setTextOutline(const QPen &pen)

文字の輪郭を描く際に使用するペンを、指定されたpen に設定します。

textOutline()も参照してください 。

void QTextCharFormat::setToolTip(const QString &text)

テキストの一部に対するツールチップを、指定されたtext に設定します。

toolTip()も参照してください 。

void QTextCharFormat::setUnderlineColor(const QColor &color)

この書式が適用された文字のアンダーライン、オーバーライン、および取り消し線を表示する際に使用する色を、指定されたcolor に設定します。

underlineColor()も参照してください 。

void QTextCharFormat::setUnderlineStyle(QTextCharFormat::UnderlineStyle style)

テキストの下線スタイルを「style 」に設定します。

underlineStyle()も参照してください 。

void QTextCharFormat::setVerticalAlignment(QTextCharFormat::VerticalAlignment alignment)

この書式を持つ文字に使用される垂直方向の位置合わせを、指定されたalignment に設定します。

verticalAlignment()も参照してください 。

[since 6.0] qreal QTextCharFormat::subScriptBaseline() const

添字の基準線を、フォント高に対するパーセンテージとして返します。

この関数は Qt 6.0 で導入されました。

関連項目： setSubScriptBaseline()、setSuperScriptBaseline()、superScriptBaseline()、setBaselineOffset()、およびbaselineOffset()。

[since 6.0] qreal QTextCharFormat::superScriptBaseline() const

上付き文字のベースラインを、フォント高に対するパーセンテージとして返します。

この関数は Qt 6.0 で導入されました。

setSuperScriptBaseline()、setSubScriptBaseline()、subScriptBaseline()、setBaselineOffset()、およびbaselineOffset()も参照してください 。

QPen QTextCharFormat::textOutline() const

この形式で文字の輪郭を描画するために使用されたペンを返します。

setTextOutline()も参照してください 。

QString QTextCharFormat::toolTip() const

テキストの一部に対して表示されるツールチップを返します。

setToolTip()も参照してください 。

QColor QTextCharFormat::underlineColor() const

この書式を持つ文字に対して、下線、上線、および取り消し線を引く際に使用される色を返します。

setUnderlineColor()も参照してください 。

QTextCharFormat::UnderlineStyle QTextCharFormat::underlineStyle() const

テキストに下線を引くスタイルを返します。

setUnderlineStyle()も参照してください 。

QTextCharFormat::VerticalAlignment QTextCharFormat::verticalAlignment() const

このフォーマットを持つ文字に対して使用される垂直方向の位置合わせを返します。

setVerticalAlignment()も参照してください 。