Clase CD2DTextLayoutCD2DTextLayout Class

Un contenedor para IDWriteTextLayout.A wrapper for IDWriteTextLayout.

SintaxisSyntax

class CD2DTextLayout : public CD2DResource;

MiembrosMembers

Constructores públicosPublic Constructors

NombreName DescripciónDescription
CD2DTextLayout::CD2DTextLayoutCD2DTextLayout::CD2DTextLayout Construye un CD2DTextLayout objeto.Constructs a CD2DTextLayout object.
CD2DTextLayout::-CD2DTextLayoutCD2DTextLayout::~CD2DTextLayout Destructor.The destructor. Se llama cuando se destruye un objeto de diseño de texto D2D.Called when a D2D text layout object is being destroyed.

Métodos públicosPublic Methods

NombreName DescripciónDescription
CD2DTextLayout::CreateCD2DTextLayout::Create Crea un CD2DTextLayout.Creates a CD2DTextLayout. (Reemplaza CD2DResource::Create.)(Overrides CD2DResource::Create.)
CD2DTextLayout::DestroyCD2DTextLayout::Destroy Destruye un objeto CD2DTextLayout.Destroys a CD2DTextLayout object. (Reemplaza CD2DResource::Destroy.)(Overrides CD2DResource::Destroy.)
CD2DTextLayout::GetCD2DTextLayout::Get Devuelve IDWriteTextLayout interfazReturns IDWriteTextLayout interface
CD2DTextLayout::GetFontFamilyNameCD2DTextLayout::GetFontFamilyName Copia el nombre de la familia de fuentes del texto en la posición especificada.Copies the font family name of the text at the specified position.
CD2DTextLayout::GetLocaleNameCD2DTextLayout::GetLocaleName Obtiene el nombre de configuración regional del texto en la posición especificada.Gets the locale name of the text at the specified position.
CD2DTextLayout::IsValidCD2DTextLayout::IsValid Comprueba la validez de los recursos (reemplaza CD2DResource::IsValid.)Checks resource validity (Overrides CD2DResource::IsValid.)
CD2DTextLayout::ReCreateCD2DTextLayout::ReCreate Vuelve a crear un CD2DTextLayout.Re-creates a CD2DTextLayout. (Reemplaza CD2DResource::ReCreate.)(Overrides CD2DResource::ReCreate.)
CD2DTextLayout::SetFontFamilyNameCD2DTextLayout::SetFontFamilyName Establece el nombre de familia de fuentes terminada en null para el texto dentro de un intervalo de texto especificadoSets null-terminated font family name for text within a specified text range
CD2DTextLayout::SetLocaleNameCD2DTextLayout::SetLocaleName Establece el nombre de la configuración regional para el texto dentro de un intervalo de texto especificadoSets the locale name for text within a specified text range

Operadores públicosPublic Operators

NombreName DescripciónDescription
CD2DTextLayout::operator IDWriteTextLayout*CD2DTextLayout::operator IDWriteTextLayout* Devuelve IDWriteTextLayout interfazReturns IDWriteTextLayout interface

Miembros de datos protegidosProtected Data Members

NombreName DescripciónDescription
CD2DTextLayout::m_pTextLayoutCD2DTextLayout::m_pTextLayout Un puntero a un IDWriteTextLayout.A pointer to an IDWriteTextLayout.

Jerarquía de herenciaInheritance Hierarchy

CObjectCObject

CD2DResourceCD2DResource

CD2DTextLayoutCD2DTextLayout

RequisitosRequirements

Encabezado: afxrendertarget.hHeader: afxrendertarget.h

CD2DTextLayout::-CD2DTextLayoutCD2DTextLayout::~CD2DTextLayout

Destructor.The destructor. Se llama cuando se destruye un objeto de diseño de texto D2D.Called when a D2D text layout object is being destroyed.

virtual ~CD2DTextLayout();

CD2DTextLayout::CD2DTextLayoutCD2DTextLayout::CD2DTextLayout

Construye un CD2DTextLayout objeto.Constructs a CD2DTextLayout object.

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

ParámetrosParameters

pParentTargetpParentTarget
Un puntero al destino de representación.A pointer to the render target.

strTextstrText
Un CString objeto que contiene la cadena para crear un nuevo CD2DTextLayout objeto desde.A CString object that contains the string to create a new CD2DTextLayout object from.

textFormattextFormat
Un CString objeto que contiene el formato que se aplicará a la cadena.A CString object that contains the format to apply to the string.

sizeMaxsizeMax
El tamaño del cuadro de diseño.The size of the layout box.

bAutoDestroybAutoDestroy
Indica que el propietario destruirá el objeto (pParentTarget).Indicates that the object will be destroyed by owner (pParentTarget).

CD2DTextLayout::CreateCD2DTextLayout::Create

Crea un CD2DTextLayout.Creates a CD2DTextLayout.

virtual HRESULT Create(CRenderTarget* */);

Valor devueltoReturn Value

Si el método se realiza correctamente, devuelve S_OK.If the method succeeds, it returns S_OK. De lo contrario, devuelve un código de error HRESULT.Otherwise, it returns an HRESULT error code.

CD2DTextLayout::DestroyCD2DTextLayout::Destroy

Destruye un objeto CD2DTextLayout.Destroys a CD2DTextLayout object.

virtual void Destroy();

CD2DTextLayout::GetCD2DTextLayout::Get

Devuelve IDWriteTextLayout interfazReturns IDWriteTextLayout interface

IDWriteTextLayout* Get();

Valor devueltoReturn Value

Puntero a una interfaz IDWriteTextLayout o NULL si el objeto aún no se ha inicializado.Pointer to an IDWriteTextLayout interface or NULL if object is not initialized yet.

CD2DTextLayout::GetFontFamilyNameCD2DTextLayout::GetFontFamilyName

Copia el nombre de la familia de fuentes del texto en la posición especificada.Copies the font family name of the text at the specified position.

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

ParámetrosParameters

currentPositioncurrentPosition
La posición del texto a examinar.The position of the text to examine.

TextrangetextRange
El intervalo de texto que tiene el mismo formato que el texto en la posición especificada por currentPosition.The range of text that has the same formatting as the text at the position specified by currentPosition. Esto significa que la ejecución tiene el formato exacto como la posición especificada, incluido, entre otros, el nombre de la familia de fuentes.This means the run has the exact formatting as the position specified, including but not limited to the font family name.

Valor devueltoReturn Value

CString objeto que contiene el nombre de familia de fuentes actual.CString object that contains the current font family name.

CD2DTextLayout::GetLocaleNameCD2DTextLayout::GetLocaleName

Obtiene el nombre de configuración regional del texto en la posición especificada.Gets the locale name of the text at the specified position.

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

ParámetrosParameters

currentPositioncurrentPosition
La posición del texto que se debe inspeccionar.The position of the text to inspect.

TextrangetextRange
El intervalo de texto que tiene el mismo formato que el texto en la posición especificada por currentPosition.The range of text that has the same formatting as the text at the position specified by currentPosition. Esto significa que la ejecución tiene el formato exacto como la posición especificada, incluyendo pero no limitado al nombre de la configuración regional.This means the run has the exact formatting as the position specified, including but not limited to the locale name.

Valor devueltoReturn Value

CString objeto que contiene el nombre de configuración regional actual.CString object that contains the current locale name.

CD2DTextLayout::IsValidCD2DTextLayout::IsValid

Comprueba la validez de los recursosChecks resource validity

virtual BOOL IsValid() const;

Valor devueltoReturn Value

TRUESi el recurso es válido; de lo contrario FALSO.TRUE if resource is valid; otherwise FALSE.

CD2DTextLayout::m_pTextLayoutCD2DTextLayout::m_pTextLayout

Un puntero a un IDWriteTextLayout.A pointer to an IDWriteTextLayout.

IDWriteTextLayout* m_pTextLayout;

CD2DTextLayout::operator IDWriteTextLayout*CD2DTextLayout::operator IDWriteTextLayout*

Devuelve IDWriteTextLayout interfazReturns IDWriteTextLayout interface

operator IDWriteTextLayout*();

Valor devueltoReturn Value

Puntero a una interfaz IDWriteTextLayout o NULL si el objeto aún no se ha inicializado.Pointer to an IDWriteTextLayout interface or NULL if object is not initialized yet.

CD2DTextLayout::ReCreateCD2DTextLayout::ReCreate

Vuelve a crear un CD2DTextLayout.Re-creates a CD2DTextLayout.

virtual HRESULT ReCreate(CRenderTarget* */);

Valor devueltoReturn Value

Si el método se realiza correctamente, devuelve S_OK.If the method succeeds, it returns S_OK. De lo contrario, devuelve un código de error HRESULT.Otherwise, it returns an HRESULT error code.

CD2DTextLayout::SetFontFamilyNameCD2DTextLayout::SetFontFamilyName

Establece el nombre de familia de fuentes terminada en null para el texto dentro de un intervalo de texto especificadoSets null-terminated font family name for text within a specified text range

BOOL SetFontFamilyName(
    LPCWSTR pwzFontFamilyName,
    DWRITE_TEXT_RANGE textRange);

ParámetrosParameters

pwzFontFamilyNamepwzFontFamilyName
El nombre de familia de fuentes que se aplica a toda la cadena de texto dentro del intervalo especificado por textRangeThe font family name that applies to the entire text string within the range specified by textRange

TextrangetextRange
Rango de texto al que se aplica este cambioText range to which this change applies

Valor devueltoReturn Value

Si el método se realiza correctamente, devuelve TRUE.If the method succeeds, it returns TRUE. De lo contrario, devuelve FALSEOtherwise, it returns FALSE

CD2DTextLayout::SetLocaleNameCD2DTextLayout::SetLocaleName

Establece el nombre de la configuración regional para el texto dentro de un intervalo de texto especificadoSets the locale name for text within a specified text range

BOOL SetLocaleName(
    LPCWSTR pwzLocaleName,
    DWRITE_TEXT_RANGE textRange);

ParámetrosParameters

pwzLocaleNamepwzLocaleName
Una cadena de nombre de configuración regional terminada en nullA null-terminated locale name string

TextrangetextRange
Rango de texto al que se aplica este cambioText range to which this change applies

Valor devueltoReturn Value

Si el método se realiza correctamente, devuelve TRUE.If the method succeeds, it returns TRUE. De lo contrario, devuelve FALSEOtherwise, it returns FALSE

Consulte tambiénSee also

ClasesClasses