GetCharWidthA-Funktion (wingdi.h)

Artikel
11/20/2024

Die GetCharWidth--Funktion ruft die Breite in logischen Koordinaten von aufeinander folgenden Zeichen in einem angegebenen Bereich von der aktuellen Schriftart ab.

Hinweis Diese Funktion wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows bereitgestellt. Anwendungen sollten die GetCharWidth32--Funktion aufrufen, die genauere Ergebnisse liefert.

Syntax

BOOL GetCharWidthA(
  [in]  HDC   hdc,
  [in]  UINT  iFirst,
  [in]  UINT  iLast,
  [out] LPINT lpBuffer
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] iFirst

Das erste Zeichen in der Gruppe aufeinander folgender Zeichen.

[in] iLast

Das letzte Zeichen in der Gruppe aufeinander folgender Zeichen, das dem angegebenen ersten Zeichen nicht vorangestellt werden darf.

[out] lpBuffer

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

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert null.

Bemerkungen

GetCharWidth- kann nicht für TrueType-Schriftarten verwendet werden. Um Zeichenbreiten für TrueType-Schriftarten abzurufen, verwenden Sie GetCharABCWidths.

Der Bereich ist inklusive; d. h. die zurückgegebenen Breiten enthalten die Breite der zeichen, die durch die iFirstChar- und iLastChar Parameter angegeben werden.

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

Anmerkung

The wingdi.h header defines GetCharWidth as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wingdi.h (enthalten Windows.h)
Library	Gdi32.lib
DLL-	Gdi32.dll