IDWriteTextFormat::SetTextAlignment メソッド (dwrite.h)

IDWriteTextFormat インターフェイスのレイアウト ボックスの前後の端を基準にして、段落内のテキストの配置を設定します。

構文

HRESULT SetTextAlignment(
  DWRITE_TEXT_ALIGNMENT textAlignment
);

パラメーター

textAlignment

種類: DWRITE_TEXT_ALIGNMENT

DWRITE_TEXT_ALIGNMENT型の段落に設定されているテキスト配置オプション。 詳細については、「解説」を参照してください。

戻り値

種類: HRESULT

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	textAlignment 引数が無効です。

解説

テキストは、レイアウト ボックスの先頭または末尾の端に配置することも、中央揃えにすることもできます。 次の図は、配置が DWRITE_TEXT_ALIGNMENT_LEADING、DWRITE_TEXT_ALIGNMENT_CENTER、DWRITE_TEXT_ALIGNMENT_TRAILING に設定されたテキストを示しています。

メモ アラインメントは読み取り方向に依存し、上記は左から右の読み取り方向用です。 右から左への読み取り方向の場合は、逆になります。

 

詳細については、「 DWRITE_TEXT_ALIGNMENT 」を参照してください。

例

if (SUCCEEDED(hr))
{
    hr = pTextFormat_->SetTextAlignment(DWRITE_TEXT_ALIGNMENT_CENTER);
}

要件

サポートされている最小のクライアント	Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	dwrite.h
Library	Dwrite.lib
[DLL]	Dwrite.dll

関連項目

IDWriteTextFormat