次の方法で共有

値の書式設定

  • [アーティクル]

このセクションでは、DrawThemeText および GetThemeTextExtent関数の dwTextFlags パラメーターで使用される値一覧表示します。 これらの値の 1 つ以上を使用して、テキスト文字列の書式設定方法を指定します。 DrawThemeText 関数は、pRect パラメーターで指定された表示四角形内にテキスト文字列を描画します。 GetThemeTextExtent 関数を使用して、指定した長さと形式のテキストに必要な外接する四角形を決定できます。

値の書式設定

次の表に、書式の値を示します。

価値 形容
DT_BOTTOM 表示四角形の下部にテキスト文字列をレンダリングします。 この値は、DT_SINGLELINE値でのみ使用されます。
DT_CALCRECT 表示する四角形の幅と高さを指定します。
DT_CENTER 表示四角形内のテキストを水平方向に中央揃えします。
DT_EDITCONTROL 複数行編集コントロールのテキスト表示特性を複製します。 具体的には、平均文字幅は編集コントロールの場合と同じ方法で計算され、関数は部分的に表示される最後の行を表示しません。
DT_END_ELLIPSIS 表示する四角形よりも広いテキスト文字列を切り捨て、省略記号を追加して切り捨てを示します。 DT_MODIFYSTRING フラグが指定されていない限り、文字列は変更されません。
DT_EXPANDTABS タブ文字を展開します。 タブあたりの既定の文字数は 8 文字です。 DT_WORD_ELLIPSIS、DT_PATH_ELLIPSIS、およびDT_END_ELLIPSISの値をDT_EXPANDTABS値と共に使用することはできません。
DT_EXTERNALLEADING フォントの外部先頭を行の高さに含めます。 通常、外部の先頭はテキスト行の高さに含まれません。
DT_HIDEPREFIX テキスト内のプレフィックス文字 & を無視します。 次の文字は下線付きではありませんが、他のプレフィックス文字は引き続き処理されます。 例えば：
入力文字列: "A&bc&&d"
normal: "Abc&d"
DT_HIDEPREFIX: "Abc&d"
DT_LEFT テキストを左揃えにします。
DT_MODIFYSTRING 表示されるテキストと一致するように文字列を変更します。 DT_END_ELLIPSISまたはDT_PATH_ELLIPSISが指定されていない限り、この値は無効です。
DT_NOCLIP 表示四角形をクリッピングせずにテキスト文字列を描画します。
DT_NOFULLWIDTHCHARBREAK 2 バイト文字セット (DBCS) での改行を防ぎ、改行規則が 1 バイト文字セット (SBCS) と同等になるようにします。 これは、たとえば、韓国語テキストで書かれたアイコン ラベルを読みやすくするために使用できます。 DT_WORDBREAKが指定されていない限り、この値は無効です。
DT_NOPREFIX プレフィックス文字の処理をオフにします。 通常、DrawThemeTextは、プレフィックス文字 & を次の文字をアンダースコア付けするディレクティブとして解釈し、プレフィックス文字は 1 つの &を出力するディレクティブとして && します。 DT_NOPREFIXを指定すると、この処理はオフになります。 例えば：
入力文字列: "A&bc&&d"
normal: "Abc&d"
DT_NOPREFIX: "A&bc&&d"
DT_PATH_ELLIPSIS 結果が表示四角形に収まるように、テキストの中央の文字を省略記号に置き換えます。 文字列に円記号 (\) 文字が含まれている場合、DT_PATH_ELLIPSISは最後の円記号の後のテキストをできるだけ保持します。 DT_MODIFYSTRING フラグが指定されていない限り、文字列は変更されません。
DT_PREFIXONLY プレフィックス文字 &の後の文字の位置に下線のみを描画します。 通常 DrawThemeText は、& をディレクティブとして解釈し、後に続く文字に下線を付け、プレフィックス文字を 1 つの &を出力するディレクティブとして && します。 DT_PREFIXONLYを指定すると、文字は描画されません。下線のみが表示されます。 空白は、文字が通常表示される位置に配置されます。 例えば：
入力文字列: "A&bc&&d"
normal: "Abc&d
DT_PREFIXONLY: " "
DT_RIGHT テキストを右揃えにします。
DT_RTLREADING ヘブライ語またはアラビア語のフォントのテキストなど、双方向テキストのテキストを右から左の順序でレイアウトします。 テキストの既定の方向は左から右です。
DT_SINGLELINE 1 行にテキストを表示します。 復帰と改行は行を中断しません。
DT_TABSTOP タブ位置を設定します。
DT_TOP 表示四角形の上部にテキストをレンダリングします。
DT_VCENTER テキストを垂直方向に中央揃えします。 この値は、DT_SINGLELINE値でのみ使用されます。
DT_WORDBREAK 表示する四角形の端を越えて単語が拡張される場合は、単語間の線を区切ります。 復帰/改行 (CR/LF) シーケンスも改行します。
DT_WORD_ELLIPSIS 表示四角形に収まらない単語を切り捨て、省略記号を追加します。