Classe CD2DTextLayout

  • Artigo

Um wrapper para IDWriteTextLayout.

Sintaxe

class CD2DTextLayout : public CD2DResource;

Membros

Construtores públicos

Nome Descrição
CD2DTextLayout::CD2DTextLayout Constrói um objeto CD2DTextLayout.
CD2DTextLayout::~CD2DTextLayout O destruidor. Chamado quando um objeto de layout de texto D2D está sendo destruído.

Métodos públicos

Nome Descrição
CD2DTextLayout::Create Cria um CD2DTextLayout. (Substitui CD2DResource::Create.)
CD2DTextLayout::Destroy Destrói um objeto CD2DTextLayout. (Substitui CD2DResource::Destroy.)
CD2DTextLayout::Get Retorna a interface IDWriteTextLayout
CD2DTextLayout::GetFontFamilyName Copia o nome da família de fontes do texto na posição especificada.
CD2DTextLayout::GetLocaleName Copia o nome da localidade do texto na posição especificada.
CD2DTextLayout::IsValid Verifica a validade do recurso (substitui CD2DResource::IsValid.)
CD2DTextLayout::ReCreate Recria um CD2DTextLayout. (Substitui CD2DResource::Create.)
CD2DTextLayout::SetFontFamilyName Define o nome da família de fontes com término nulo para texto dentro de um intervalo de texto especificado
CD2DTextLayout::SetLocaleName Define o nome da localidade do texto em um intervalo de texto especificado

Operadores públicos

Nome Descrição
CD2DTextLayout::operator IDWriteTextLayout* Retorna a interface IDWriteTextLayout

Membros de Dados Protegidos

Nome Descrição
CD2DTextLayout::m_pTextLayout Um ponteiro para um IDWriteTextLayout.

Hierarquia de herança

CObject

CD2DResource

CD2DTextLayout

Requisitos

Cabeçalho: afxrendertarget.h

CD2DTextLayout::~CD2DTextLayout

O destruidor. Chamado quando um objeto de layout de texto D2D está sendo destruído.

virtual ~CD2DTextLayout();

CD2DTextLayout::CD2DTextLayout

Constrói um objeto CD2DTextLayout.

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

Parâmetros

pParentTarget
Um ponteiro para o destino de renderização.

strText
Um objeto CString que contém a cadeia de caracteres para criar um novo objeto CD2DTextLayout.

textFormat
Um objeto CString que contém o formato a ser aplicado à cadeia de caracteres.

sizeMax
O tamanho da caixa de layout.

bAutoDestroy
Indica que o objeto será destruído pelo proprietário (pParentTarget).

CD2DTextLayout::Create

Cria um CD2DTextLayout.

virtual HRESULT Create(CRenderTarget* */);

Valor de Devolução

Se o método for bem-sucedido, retornará S_OK. Caso contrário, ela retornará um código de erro HRESULT.

CD2DTextLayout::Destroy

Destrói um objeto CD2DTextLayout.

virtual void Destroy();

CD2DTextLayout::Get

Retorna a interface IDWriteTextLayout

IDWriteTextLayout* Get();

Valor de Devolução

Ponteiro para uma interface IDWriteTextLayout, ou NULL se o objeto ainda não estiver inicializado.

CD2DTextLayout::GetFontFamilyName

Copia o nome da família de fontes do texto na posição especificada.

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

Parâmetros

currentPosition
A posição do texto a ser examinado.

textRange
O intervalo de texto que tem a mesma formatação que o texto na posição especificada por currentPosition. Isso significa que a execução tem a formatação exata como a posição especificada, incluindo, mas não se limitando ao nome da família de fontes.

Valor de Devolução

Objeto CString que contém o nome atual da família de fontes.

CD2DTextLayout::GetLocaleName

Copia o nome da localidade do texto na posição especificada.

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

Parâmetros

currentPosition
A posição do texto a ser examinado.

textRange
O intervalo de texto que tem a mesma formatação que o texto na posição especificada por currentPosition. Isso significa que a execução tem a formatação exata da posição especificada, incluindo, mas não se limitando ao nome da localidade.

Valor de Devolução

Objeto CString que contém o nome atual da localidade.

CD2DTextLayout::IsValid

Verifica a validade do recurso

virtual BOOL IsValid() const;

Valor de Devolução

TRUE se o recurso for válido; caso contrário, FALSE.

CD2DTextLayout::m_pTextLayout

Um ponteiro para um IDWriteTextLayout.

IDWriteTextLayout* m_pTextLayout;

CD2DTextLayout::operator IDWriteTextLayout*

Retorna a interface IDWriteTextLayout

operator IDWriteTextLayout*();

Valor de Devolução

Ponteiro para uma interface IDWriteTextLayout, ou NULL se o objeto ainda não estiver inicializado.

CD2DTextLayout::ReCreate

Recria um CD2DTextLayout.

virtual HRESULT ReCreate(CRenderTarget* */);

Valor de Devolução

Se o método for bem-sucedido, retornará S_OK. Caso contrário, ela retornará um código de erro HRESULT.

CD2DTextLayout::SetFontFamilyName

Define o nome da família de fontes com término nulo para texto dentro de um intervalo de texto especificado

BOOL SetFontFamilyName(
    LPCWSTR pwzFontFamilyName,
    DWRITE_TEXT_RANGE textRange);

Parâmetros

pwzFontFamilyName
O nome da família de fontes que se aplica a toda a cadeia de caracteres de texto dentro do intervalo especificado por textRange

textRange
Intervalo de texto ao qual essa alteração se aplica

Valor de Devolução

Se o método for bem-sucedido, retornará TRUE. Caso contrário, retorna FALSE

CD2DTextLayout::SetLocaleName

Define o nome da localidade do texto em um intervalo de texto especificado

BOOL SetLocaleName(
    LPCWSTR pwzLocaleName,
    DWRITE_TEXT_RANGE textRange);

Parâmetros

pwzLocaleName
Uma cadeia de caracteres de nome de localidade terminada em nulo

textRange
Intervalo de texto ao qual essa alteração se aplica

Valor de Devolução

Se o método for bem-sucedido, retornará TRUE. Caso contrário, retorna FALSE

Confira também

Classes