CD2DTextLayout-Klasse

Ein Wrapper für IDWriteTextLayout.

Syntax

class CD2DTextLayout : public CD2DResource;

Member

Öffentliche Konstruktoren

Name	Beschreibung
CD2DTextLayout::CD2DTextLayout	Erstellt ein CD2DTextLayout -Objekt.
CD2DTextLayout::~CD2DTextLayout	Der Destruktor. Wird aufgerufen, wenn ein D2D-Textlayoutobjekt zerstört wird.

Öffentliche Methoden

Name	Beschreibung
CD2DTextLayout::Create	Erstellt ein CD2DTextLayout. (Außerkraftsetzungen CD2DResource::Create.)
CD2DTextLayout::D estroy	Zerstört ein CD2DTextLayout -Objekt. (Außerkraftsetzungen CD2DResource::D estroy.)
CD2DTextLayout::Get	Gibt die IDWriteTextLayout-Schnittstelle zurück.
CD2DTextLayout::GetFontFamilyName	Kopiert den Schriftartfamiliennamen des Texts an der angegebenen Position.
CD2DTextLayout::GetLocaleName	Ruft den Gebietsschemanamen des Texts an der angegebenen Position ab.
CD2DTextLayout::IsValid	Überprüft die Ressourcengültigkeit (Außerkraftsetzungen CD2DResource::IsValid.)
CD2DTextLayout::ReCreate	Erstellt ein CD2DTextLayout erneut. (Außerkraftsetzungen CD2DResource::ReCreate.)
CD2DTextLayout::SetFontFamilyName	Legt den Namen der Schriftartenfamilie null für Text innerhalb eines angegebenen Textbereichs fest.
CD2DTextLayout::SetLocaleName	Legt den Gebietsschemanamen für Text innerhalb eines angegebenen Textbereichs fest.

Öffentliche Operatoren

Name	Beschreibung
CD2DTextLayout::operator IDWriteTextLayout*	Gibt die IDWriteTextLayout-Schnittstelle zurück.

Geschützte Datenmember

Name	Beschreibung
CD2DTextLayout::m_pTextLayout	Ein Zeiger auf ein IDWriteTextLayout.

Vererbungshierarchie

CObject

CD2DResource

CD2DTextLayout

Anforderungen

Header: afxrendertarget.h

CD2DTextLayout::~CD2DTextLayout

Der Destruktor. Wird aufgerufen, wenn ein D2D-Textlayoutobjekt zerstört wird.

virtual ~CD2DTextLayout();

CD2DTextLayout::CD2DTextLayout

Erstellt ein CD2DTextLayout -Objekt.

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

Parameter

pParentTarget
Ein Zeiger auf das Renderziel.

strText
Ein CString-Objekt, das die Zeichenfolge zum Erstellen eines neuen CD2DTextLayout-Objekts enthält.

textFormat
Ein CString-Objekt, das das Format enthält, das auf die Zeichenfolge angewendet werden soll.

sizeMax
Die Größe des Layoutfelds.

bAutoDestroy
Gibt an, dass das Objekt vom Besitzer (pParentTarget) zerstört wird.

CD2DTextLayout::Create

Erstellt ein CD2DTextLayout.

virtual HRESULT Create(CRenderTarget* */);

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

CD2DTextLayout::D estroy

Zerstört ein CD2DTextLayout -Objekt.

virtual void Destroy();

CD2DTextLayout::Get

Gibt die IDWriteTextLayout-Schnittstelle zurück.

IDWriteTextLayout* Get();

Rückgabewert

Zeiger auf eine IDWriteTextLayout-Schnittstelle oder NULL, wenn das Objekt noch nicht initialisiert ist.

CD2DTextLayout::GetFontFamilyName

Kopiert den Schriftartfamiliennamen des Texts an der angegebenen Position.

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

Parameter

currentPosition
Die Position des zu untersuchenden Texts.

Textrange
Der Textbereich mit der gleichen Formatierung wie der Text an der durch currentPosition angegebenen Position. Dies bedeutet, dass die Ausführung die genaue Formatierung wie die angegebene Position aufweist, einschließlich, aber nicht beschränkt auf den Namen der Schriftartfamilien.

Rückgabewert

CString-Objekt, das den aktuellen Schriftartfamiliennamen enthält.

CD2DTextLayout::GetLocaleName

Ruft den Gebietsschemanamen des Texts an der angegebenen Position ab.

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

Parameter

currentPosition
Die Position des zu prüfenden Texts.

Textrange
Der Textbereich mit der gleichen Formatierung wie der Text an der durch currentPosition angegebenen Position. Dies bedeutet, dass die Ausführung die genaue Formatierung wie die angegebene Position aufweist, einschließlich, aber nicht beschränkt auf den Gebietsschemanamen.

Rückgabewert

CString-Objekt, das den aktuellen Gebietsschemanamen enthält.

CD2DTextLayout::IsValid

Überprüft die Gültigkeit der Ressource

virtual BOOL IsValid() const;

Rückgabewert

TRUE, wenn die Ressource gültig ist; andernfalls FALSE.

CD2DTextLayout::m_pTextLayout

Ein Zeiger auf ein IDWriteTextLayout.

IDWriteTextLayout* m_pTextLayout;

CD2DTextLayout::operator IDWriteTextLayout*

Gibt die IDWriteTextLayout-Schnittstelle zurück.

operator IDWriteTextLayout*();

Rückgabewert

Zeiger auf eine IDWriteTextLayout-Schnittstelle oder NULL, wenn das Objekt noch nicht initialisiert ist.

CD2DTextLayout::ReCreate

Erstellt ein CD2DTextLayout erneut.

virtual HRESULT ReCreate(CRenderTarget* */);

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

CD2DTextLayout::SetFontFamilyName

Legt den Namen der Schriftartenfamilie null für Text innerhalb eines angegebenen Textbereichs fest.

BOOL SetFontFamilyName(
    LPCWSTR pwzFontFamilyName,
    DWRITE_TEXT_RANGE textRange);

Parameter

pwzFontFamilyName
Der Name der Schriftartfamilien, der für die gesamte Textzeichenfolge innerhalb des durch textRange angegebenen Bereichs gilt

Textrange
Textbereich, für den diese Änderung gilt

Rückgabewert

Wenn die Methode erfolgreich ist, wird TRUE zurückgegeben. Andernfalls wird FALSE zurückgegeben.

CD2DTextLayout::SetLocaleName

Legt den Gebietsschemanamen für Text innerhalb eines angegebenen Textbereichs fest.

BOOL SetLocaleName(
    LPCWSTR pwzLocaleName,
    DWRITE_TEXT_RANGE textRange);

Parameter

pwzLocaleName
Eine Zeichenfolge mit einem Null-gekündigten Gebietsschemanamen

Textrange
Textbereich, für den diese Änderung gilt

Rückgabewert

Wenn die Methode erfolgreich ist, wird TRUE zurückgegeben. Andernfalls wird FALSE zurückgegeben.

Siehe auch

Klassen