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_LEADINGDWRITE_TEXT_ALIGNMENT_CENTERDWRITE_TEXT_ALIGNMENT_TRAILING的文本。

前导、居中和尾随对齐的文本段落图示
注意 对齐方式取决于阅读方向,以上为从左到右的阅读方向。 对于从右到左的阅读方向,情况正好相反。
 
有关详细信息 ,请参阅DWRITE_TEXT_ALIGNMENT

示例

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

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 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