IDWriteTextLayout::GetFontFamilyName-Methode (dwrite.h)

Kopiert den Namen der Schriftfamilie des Texts an der angegebenen Position.

Syntax

HRESULT GetFontFamilyName(
                  UINT32            currentPosition,
  [out]           WCHAR             *fontFamilyName,
                  UINT32            nameSize,
  [out, optional] DWRITE_TEXT_RANGE *textRange
);

Parameter

currentPosition

Typ: UINT32

Die Position des zu untersuchenden Texts.

[out] fontFamilyName

Typ: WCHAR*

Wenn diese Methode zurückgibt, enthält ein Array von Zeichen, das den aktuellen Schriftfamiliennamen empfängt. Sie müssen Speicher für diesen Parameter zuordnen.

nameSize

Typ: UINT32

Die Größe des Zeichenarrays in der Zeichenanzahl einschließlich des beendeten NULL-Zeichens.

[out, optional] textRange

Typ: DWRITE_TEXT_RANGE*

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

Rückgabewert

Typ: HRESULT

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dwrite.h
Bibliothek Dwrite.lib
DLL Dwrite.dll

Weitere Informationen

Idwritetextlayout