Freigeben über


GetCharWidthI-Funktion (wingdi.h)

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

Syntax

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

Weitere Informationen

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

GetCharABCWidths

GetCharABCWidthsFloat

GetCharWidth32

GetCharWidthFloat