Класс CD2DTextLayout

Замечание

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Оболочка для IDWriteTextLayout.

Синтаксис

class CD2DTextLayout : public CD2DResource;

Участники

Открытые конструкторы

Имя	Описание
CD2DTextLayout::CD2DTextLayout	Создает объект CD2DTextLayout.
CD2DTextLayout::~CD2DTextLayout	Деструктор Вызывается при уничтожении объекта текстового макета D2D.

Открытые методы

Имя	Описание
CD2DTextLayout::Create	Создает CD2DTextLayout. (Переопределения CD2DResource::Create.)
CD2DTextLayout::D elayout	Уничтожает объект CD2DTextLayout. (Переопределения CD2DResource::D eтяж.)
CD2DTextLayout::Get	Возвращает интерфейс IDWriteTextLayout
CD2DTextLayout::GetFontFamilyName	Копирует имя семейства шрифтов текста в указанной позиции.
CD2DTextLayout::GetLocaleName	Возвращает имя языкового стандарта текста в указанной позиции.
CD2DTextLayout::IsValid	Проверяет допустимость ресурсов (переопределяет CD2DResource::IsValid.)
CD2DTextLayout::ReCreate	Повторно создает CD2DTextLayout. (Переопределения CD2DResource::ReCreate.)
CD2DTextLayout::SetFontFamilyName	Задает имя семейства шрифтов, завершаемых null, для текста в заданном диапазоне текста
CD2DTextLayout::SetLocaleName	Задает имя языкового стандарта для текста в указанном текстовом диапазоне

Открытые операторы

Имя	Описание
CD2DTextLayout::operator IDWriteTextLayout*	Возвращает интерфейс IDWriteTextLayout

Защищенные члены данных

Имя	Описание
CD2DTextLayout::m_pTextLayout	Указатель на IDWriteTextLayout.

Иерархия наследования

CObject

CD2DResource

CD2DTextLayout

Требования

Заголовок: afxrendertarget.h

CD2DTextLayout::~CD2DTextLayout

Деструктор Вызывается при уничтожении объекта текстового макета D2D.

virtual ~CD2DTextLayout();

CD2DTextLayout::CD2DTextLayout

Создает объект CD2DTextLayout.

CD2DTextLayout(
    CRenderTarget* pParentTarget,
    const CString& strText,
    CD2DTextFormat& textFormat,
    const CD2DSizeF& sizeMax,
    BOOL bAutoDestroy = TRUE);

Параметры

pParentTarget
Указатель на целевой объект отрисовки.

strText
Объект CString, содержащий строку для создания объекта CD2DTextLayout.

textFormat
Объект CString, содержащий формат, применяемый к строке.

sizeMax
Размер поля макета.

bAutoDesk
Указывает, что объект будет уничтожен владельцем (pParentTarget).

CD2DTextLayout::Create

Создает CD2DTextLayout.

virtual HRESULT Create(CRenderTarget* */);

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В противном случае будет возвращен код ошибки HRESULT.

CD2DTextLayout::D elayout

Уничтожает объект CD2DTextLayout.

virtual void Destroy();

CD2DTextLayout::Get

Возвращает интерфейс IDWriteTextLayout

IDWriteTextLayout* Get();

Возвращаемое значение

Указатель на интерфейс IDWriteTextLayout или NULL, если объект еще не инициализирован.

CD2DTextLayout::GetFontFamilyName

Копирует имя семейства шрифтов текста в указанной позиции.

CString GetFontFamilyName(
    UINT32 currentPosition,
    DWRITE_TEXT_RANGE* textRange = NULL) const;

Параметры

currentPosition
Позиция проверяемого текста.

textRange
Диапазон текста, который имеет то же форматирование, что и текст в позиции, указанной currentPosition. Это означает, что выполнение имеет точное форматирование в качестве указанной позиции, включая, но не ограничено именем семейства шрифтов.

Возвращаемое значение

Объект CString, содержащий текущее имя семейства шрифтов.

CD2DTextLayout::GetLocaleName

Возвращает имя языкового стандарта текста в указанной позиции.

CString GetLocaleName(
    UINT32 currentPosition,
    DWRITE_TEXT_RANGE* textRange = NULL) const;

Параметры

currentPosition
Позиция проверяемого текста.

textRange
Диапазон текста, который имеет то же форматирование, что и текст в позиции, указанной currentPosition. Это означает, что выполнение имеет точное форматирование в качестве указанной позиции, включая, но не ограничено именем языкового стандарта.

Возвращаемое значение

Объект CString, содержащий текущее имя языкового стандарта.

CD2DTextLayout::IsValid

Проверка допустимости ресурсов

virtual BOOL IsValid() const;

Возвращаемое значение

ЗНАЧЕНИЕ TRUE, если ресурс действителен; в противном случае ЗНАЧЕНИЕ FALSE.

CD2DTextLayout::m_pTextLayout

Указатель на IDWriteTextLayout.

IDWriteTextLayout* m_pTextLayout;

CD2DTextLayout::operator IDWriteTextLayout*

Возвращает интерфейс IDWriteTextLayout

operator IDWriteTextLayout*();

Возвращаемое значение

Указатель на интерфейс IDWriteTextLayout или NULL, если объект еще не инициализирован.

CD2DTextLayout::ReCreate

Повторно создает CD2DTextLayout.

virtual HRESULT ReCreate(CRenderTarget* */);

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В противном случае будет возвращен код ошибки HRESULT.

CD2DTextLayout::SetFontFamilyName

Задает имя семейства шрифтов, завершаемых null, для текста в заданном диапазоне текста

BOOL SetFontFamilyName(
    LPCWSTR pwzFontFamilyName,
    DWRITE_TEXT_RANGE textRange);

Параметры

pwzFontFamilyName
Имя семейства шрифтов, которое применяется ко всей текстовой строке в диапазоне, заданном textRange

textRange
Диапазон текста, к которому применяется это изменение

Возвращаемое значение

Если метод выполнен успешно, возвращает значение TRUE. В противном случае возвращает значение FALSE

CD2DTextLayout::SetLocaleName

Задает имя языкового стандарта для текста в указанном текстовом диапазоне

BOOL SetLocaleName(
    LPCWSTR pwzLocaleName,
    DWRITE_TEXT_RANGE textRange);

Параметры

pwzLocaleName
Строка имени языкового стандарта, завершаемого значением NULL

textRange
Диапазон текста, к которому применяется это изменение

Возвращаемое значение

Если метод выполнен успешно, возвращает значение TRUE. В противном случае возвращает значение FALSE

См. также

Классы