TTGetNewFontName-Funktion (t2embapi.h)

Artikel
03/02/2024

Ruft den Familiennamen für die Schriftart ab, die über TTLoadEmbeddedFont geladen wurde.

Syntax

LONG TTGetNewFontName(
  [in]  HANDLE *phFontReference,
  [out] LPWSTR wzWinFamilyName,
  [in]  LONG   cchMaxWinName,
  [out] LPSTR  szMacFamilyName,
  [in]  LONG   cchMaxMacName
);

Parameter

[in] phFontReference

Handle, das die eingebettete Schriftart identifiziert, die installiert wurde. Das Handle verweist auf eine interne Struktur, nicht auf ein Hfont.

[out] wzWinFamilyName

Puffer, der den neuen 16-Bit-stelligen Microsoft Windows-Familiennamen enthält.

[in] cchMaxWinName

Länge der Zeichenfolge, die dem Windows-Namen zugeordnet ist (szWinFamilyName). Muss mindestens LF_FACESIZE lang sein.

[out] szMacFamilyName

Puffer, der den neuen 8-Bit-Familiennamen von MacIntosh enthält.

[in] cchMaxMacName

Länge der Zeichenfolge, die dem Macintosh-Namen zugeordnet ist (szMacFamilyName). Muss mindestens LF_FACESIZE lang sein.

Rückgabewert

Bei erfolgreicher Ausführung wird E_NONE zurückgegeben.

Der Name der Schriftartenfamilie ist eine Zeichenfolge in szWinFamilyName oder szMacFamilyName.

Andernfalls wird ein Fehlercode zurückgegeben, der unter Embedding-Function Error Messages beschrieben wird.

Hinweise

Hinweis Diese Funktion gibt den Namen der Schriftfamilie im entsprechenden Zeichenfolgenpuffer zurück, entweder für Windows oder macIntosh. Der Puffer für das andere Betriebssystem wird nicht verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	t2embapi.h
Bibliothek	T2embed.lib
DLL	T2embed.dll

Weitere Informationen

TTGetEmbeddedFontInfo

TTGetEmbeddingType

TTLoadEmbeddedFont

Freigeben über