GetCharWidth32A-Funktion (wingdi.h)

Artikel
11/20/2024

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

Syntax

BOOL GetCharWidth32A(
  [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

GetCharWidth32- 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.

Beispiele

Ein Beispiel finden Sie unter "Anzeigen der Tastatureingabe" in Verwenden von Tastatureingaben.

Anmerkung

Der wingdi.h-Header definiert GetCharWidth32 als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. 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