SetTextAlign 関数 (wingdi.h)

  • [アーティクル]

SetTextAlign 関数は、指定したデバイス コンテキストのテキスト配置フラグを設定します。

構文

UINT SetTextAlign(
  [in] HDC  hdc,
  [in] UINT align
);

パラメーター

[in] hdc

デバイス コンテキストへのハンドル。

[in] align

次の一覧の値のマスクを使用したテキストの配置。 水平方向と垂直方向の配置に影響を与えるフラグは 1 つだけ選択できます。 さらに、現在の位置を変更する 2 つのフラグのうちの 1 つだけを選択できます。

値 説明
TA_BASELINE
 参照ポイントは、テキストの基準行に配置されます。
TA_BOTTOM
 参照ポイントは、外接する四角形の下端に配置されます。
TA_TOP
 参照ポイントは、外接する四角形の上端に配置されます。
TA_CENTER
 基準点は、外接する四角形の中心に水平方向に配置されます。
TA_LEFT
 参照ポイントは、外接する四角形の左端にあります。
TA_RIGHT
 参照ポイントは、外接する四角形の右端にあります。
TA_NOUPDATECP
 現在の位置は、各テキスト出力呼び出し後に更新されません。 参照ポイントは、テキスト出力関数に渡されます。
TA_RTLREADING
 Windows の中東言語エディション: テキストは、既定の左から右の順序ではなく、右から左の読み取り順にレイアウトされます。 これは、デバイス コンテキストで選択されているフォントがヘブライ語またはアラビア語である場合にのみ適用されます。
TA_UPDATECP
 現在の位置は、各テキスト出力呼び出しの後に更新されます。 現在の位置が参照ポイントとして使用されます。
 

現在のフォントに漢字と同様に、既定の縦線がある場合は、TA_BASELINEとTA_CENTERの代わりに次の値を使用する必要があります。

値 説明
VTA_BASELINE
 参照ポイントは、テキストの基準行に配置されます。
VTA_CENTER
 基準点は、外接する四角形の中心に垂直方向に配置されます。
 

既定値は、TA_LEFT、TA_TOP、TA_NOUPDATECPです。

戻り値

関数が成功した場合、戻り値は前のテキスト配置設定です。

関数が失敗した場合、戻り値はGDI_ERROR。

解説

TextOut 関数と ExtTextOut 関数は、テキスト配置フラグを使用して、テキストの文字列をディスプレイまたはその他のデバイスに配置します。 フラグは、参照ポイントとテキストをバインドする四角形の間のリレーションシップを指定します。 参照ポイントは、現在の位置またはテキスト出力関数に渡されるポイントです。

テキストを囲む四角形は、テキスト文字列内の文字セルによって形成されます。

左揃えのテキストを取得する最善の方法は、次のいずれかを使用することです


SetTextAlign (hdc, GetTextAlign(hdc) & (~TA_CENTER))

or


SetTextAlign (hdc,TA_LEFT | <other flags>)

この目的で SetTextAlign (hdc、TA_LEFT) を使用することもできますが、垂直方向または右から左への設定は失われます。

メモ選択したテキストが正しくレンダリングされないため、ScriptStringOut を使用している場合は、SetTextAlign を TA_UPDATECPと共に使用しないでください。 このフラグを使用する必要がある場合は、問題を回避するために、必要に応じて設定を解除してリセットできます。
 

例

例については、「 テキストの配置の設定」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wingdi.h (Windows.h を含む)
Library Gdi32.lib
[DLL] Gdi32.dll

関連項目

ExtTextOut

フォント関数とテキスト関数

フォントとテキストの概要

GetTextAlign

ScriptStringOut

Textout