IDWriteFontFile::Analyze-Methode (dwrite.h)

Artikel
08/23/2023

Analysiert eine Datei und gibt zurück, ob sie eine Schriftart darstellt und ob der Schriftarttyp vom Schriftartsystem unterstützt wird.

Syntax

HRESULT Analyze(
  [out]           BOOL                  *isSupportedFontType,
  [out]           DWRITE_FONT_FILE_TYPE *fontFileType,
  [out, optional] DWRITE_FONT_FACE_TYPE *fontFaceType,
  [out]           UINT32                *numberOfFaces
);

Parameter

[out] isSupportedFontType

Typ: BOOL*

TRUE , wenn der Schriftarttyp vom Schriftartsystem unterstützt wird; andernfalls FALSE.

[out] fontFileType

Typ: DWRITE_FONT_FILE_TYPE*

Wenn diese Methode zurückgibt, enthält einen Wert, der den Typ der Schriftartdatei angibt. Beachten Sie, dass auch wenn isSupportedFontTypeFALSE ist, der fontFileType-Wert von DWRITE_FONT_FILE_TYPE_UNKNOWN abweichen kann.

[out, optional] fontFaceType

Typ: DWRITE_FONT_FACE_TYPE*

Wenn diese Methode zurückgibt, enthält einen Wert, der den Typ der Schriftart angibt. Wenn fontFileType nicht gleich DWRITE_FONT_FILE_TYPE_UNKNOWN ist, kann dies aus der Schriftartdatei erstellt werden.

[out] numberOfFaces

Typ: UINT32*

Wenn diese Methode zurückgibt, enthält die Anzahl der Schriftarten, die in der Schriftartdatei enthalten sind.

Rückgabewert

Typ: HRESULT

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

Hinweise

Wichtig Bestimmte Schriftartdateitypen werden erkannt, aber nicht vom Schriftartensystem unterstützt. Beispielsweise erkennt das Schriftartensystem eine Datei als Schriftartdatei vom Typ 1, kann aber kein Schriftartenobjekt daraus erstellen. In solchen Situationen legt Analyze den Ausgabeparameter isSupportedFontType auf FALSE fest.

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

IDWriteFontFile