GetCharWidthA-Funktion (wingdi.h)

Artikel
03/06/2024

Die GetCharWidth-Funktion ruft die Breiten aufeinanderfolgender Zeichen in logischen Koordinaten in einem angegebenen Bereich aus 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 der aufeinanderfolgenden Zeichen.

[in] iLast

Das letzte Zeichen in der Gruppe der aufeinanderfolgenden 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 fehlerhaft ist, ist der Rückgabewert null.

Hinweise

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

Der Bereich ist inklusiv; Das heißt, die zurückgegebenen Breiten enthalten die Breiten der Zeichen, die durch die Parameter iFirstChar und iLastChar angegeben werden.

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

Hinweis

Der wingdi.h-Header definiert GetCharWidth als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll