CD2DTextFormat 类

项目
10/12/2023

IDWriteTextFormat 的包装器。

语法

class CD2DTextFormat : public CD2DResource;

成员

公共构造函数

名称	描述
CD2DTextFormat::CD2DTextFormat	构造 CD2DTextFormat 对象。
CD2DTextFormat::~CD2DTextFormat	析构函数。在销毁 D2D 文本格式对象时调用。

公共方法

名称	描述
CD2DTextFormat::Create	创建 CD2DTextFormat。（替代 CD2DResource::Create。）
CD2DTextFormat::Destroy	销毁 CD2DTextFormat 对象。（重写 CD2DResource::Destroy）
CD2DTextFormat::Get	返回 IDWriteTextFormat 接口
CD2DTextFormat::GetFontFamilyName	获取字体系列名称的副本。
CD2DTextFormat::GetLocaleName	获取区域设置名称的副本。
CD2DTextFormat::IsValid	检查资源的有效性（重写 CD2DResource::IsValid）。
CD2DTextFormat::ReCreate	重新创建 CD2DTextFormat。（替代 CD2DResource::ReCreate。）

公共运算符

“属性”	描述
CD2DTextFormat::operator IDWriteTextFormat*	返回 IDWriteTextFormat 接口

受保护的数据成员

名称	描述
CD2DTextFormat::m_pTextFormat	指向 IDWriteTextFormat 的指针。

继承层次结构

CObject

CD2DResource

CD2DTextFormat

要求

标头：afxrendertarget.h

CD2DTextFormat::~CD2DTextFormat

析构函数。在销毁 D2D 文本格式对象时调用。

virtual ~CD2DTextFormat();

CD2DTextFormat::CD2DTextFormat

构造 CD2DTextFormat 对象。

CD2DTextFormat(
    CRenderTarget* pParentTarget,
    const CString& strFontFamilyName,
    FLOAT fontSize,
    DWRITE_FONT_WEIGHT fontWeight = DWRITE_FONT_WEIGHT_NORMAL,
    DWRITE_FONT_STYLE fontStyle = DWRITE_FONT_STYLE_NORMAL,
    DWRITE_FONT_STRETCH fontStretch = DWRITE_FONT_STRETCH_NORMAL,
    const CString& strFontLocale = _T(""),
    IDWriteFontCollection* pFontCollection = NULL,
    BOOL bAutoDestroy = TRUE);

参数

pParentTarget
指向渲染目标的指针。

strFontFamilyName
一个包含字体系列名称的 CString 对象。

fontSize
字体的逻辑大小，以 DIP（“与设备无关的像素”）为单位。 DIPequals 1/96 英寸。

fontWeight
指示文本对象的字体粗细的值。

fontStyle
指示文本对象的字体样式的值。

fontStretch
指示文本对象的字体伸缩的值。

strFontLocale
包含区域设置名称的 CString 对象。

pFontCollection
指向字体集合对象的指针。如果为 NULL，则指示系统字体集合。

bAutoDestroy
指示对象将由所有者 (pParentTarget) 销毁。

CD2DTextFormat::Create

创建 CD2DTextFormat。

virtual HRESULT Create(CRenderTarget* */);

返回值

如果该方法成功，则它会返回 S_OK。否则，它将返回 HRESULT 错误代码。

CD2DTextFormat::Destroy

销毁 CD2DTextFormat 对象。

virtual void Destroy();

CD2DTextFormat::Get

返回 IDWriteTextFormat 接口

IDWriteTextFormat* Get();

返回值

指向 IDWriteTextFormat 接口的指针，如果对象尚未初始化，则为 NULL。

CD2DTextFormat::GetFontFamilyName

获取字体系列名称的副本。

CString GetFontFamilyName() const;

返回值

包含当前字体系列名称的 CString 对象。

CD2DTextFormat::GetLocaleName

获取区域设置名称的副本。

CString GetLocaleName() const;

返回值

包含当前区域设置名称的 CString 对象。

CD2DTextFormat::IsValid

检查资源有效性

virtual BOOL IsValid() const;

返回值

如果资源有效，则为 TRUE；否则为 FALSE。

CD2DTextFormat::m_pTextFormat

指向 IDWriteTextFormat 的指针。

IDWriteTextFormat* m_pTextFormat;

CD2DTextFormat::operator IDWriteTextFormat*