GetCharABCWidthsI-Funktion (wingdi.h)

Artikel
08/27/2023

Die GetCharABCWidthsI-Funktion ruft die Breiten aufeinanderfolgender Glyphenindizes in logischen Einheiten in einem angegebenen Bereich aus der aktuellen TrueType-Schriftart ab. Diese Funktion ist nur mit TrueType-Schriftarten erfolgreich.

Syntax

BOOL GetCharABCWidthsI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPABC  pabc
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] giFirst

Der erste Glyphenindex in der Gruppe der aufeinander folgenden Glyphenindizes aus der aktuellen Schriftart. Dieser Parameter wird nur verwendet, wenn der pgi-ParameterNULL ist.

[in] cgi

Die Anzahl der Glyphenindizes.

[in] pgi

Ein Zeiger auf ein Array, das Glyphenindizes enthält. Wenn dieser Parameter NULL ist, wird stattdessen der giFirst-Parameter verwendet. Der cgi-Parameter gibt die Anzahl der Glyphenindizes in diesem Array an.

[out] pabc

Ein Zeiger auf ein Array von ABC-Strukturen , das die Zeichenbreiten in logischen Einheiten empfängt. Dieses Array muss mindestens so viele ABC-Strukturen enthalten, wie vom cgi-Parameter angegebene Glyphenindizes vorhanden sind.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Der TrueType-Rasterizer bietet ABC-Zeichenabstand, nachdem eine bestimmte Punktgröße ausgewählt wurde. Ein Abstand ist der Abstand, der der aktuellen Position hinzugefügt wird, bevor die Glyphe platziert wird. Der B-Abstand ist die Breite des schwarzen Teils der Glyphe. C-Abstand ist der Abstand, der zur aktuellen Position hinzugefügt wird, um Leerzeichen rechts von der Glyphe bereitzustellen. Die erweiterte Gesamtbreite wird durch A+B+C angegeben.

Wenn die GetCharABCWidthsI-Funktion negative A- oder C-Breiten für ein Zeichen abruft, enthält dieses Zeichen Unter- oder Überhänge.

Um die ABC-Breite in Schriftartenentwurfseinheiten zu konvertieren, sollte eine Anwendung den Wert verwenden, der im otmEMSquare-Element einer OUTLINETEXTMETRIC-Struktur gespeichert ist. Dieser Wert kann durch Aufrufen der GetOutlineTextMetrics-Funktion abgerufen werden.

Die ABC-Breite des Standardzeichens wird für Zeichen außerhalb des Bereichs der aktuell ausgewählten Schriftart verwendet.

Um die Breite von Glyphenindizes in Nicht-TrueType-Schriftarten abzurufen, sollten Anwendungen die GetCharWidthI-Funktion verwenden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll