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
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.