GetCharWidthI-Funktion (wingdi.h)

Artikel
27.08.2023

Die GetCharWidthI-Funktion ruft die Breite der aufeinanderfolgenden Glyphenindizes in logischen Koordinaten in einem angegebenen Bereich aus der aktuellen Schriftart ab.

Syntax

C++

BOOL GetCharWidthI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPINT  piWidths
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] giFirst

Der erste Glyphenindex in der Gruppe der aufeinanderfolgenden Glyphenindizes.

[in] cgi

Die Anzahl der Glyphenindizes.

[in] pgi

Ein Zeiger auf ein Array von Glyphenindizes. Wenn dieser Parameter nicht NULL ist, wird er anstelle des giFirst-Parameters verwendet.

[out] piWidths

Ein Zeiger auf einen Puffer, der die Breiten in logischen Koordinaten empfängt.

Rückgabewert

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

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

Hinweise

Die GetCharWidthI-Funktion verarbeitet aufeinanderfolgende Glyphenindizes, wenn der pgi-ParameterNULL ist, wobei der giFirst-Parameter den ersten zu verarbeitenden Glyphenindex angibt, und der cgi-Parameter , der angibt, wie viele Glyphenindizes verarbeitet werden sollen. Andernfalls verarbeitet die GetCharWidthI-Funktion das Array der Glyphenindizes, auf das der pgi-Parameter verweist, mit dem cgi-Parameter , der angibt, wie viele Glyphenindizes verarbeitet werden sollen.

Wenn ein Zeichen in der aktuellen Schriftart nicht vorhanden ist, wird ihm die Breite des Standardzeichens zugewiesen.

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