GetCharWidthFloatA-Funktion (wingdi.h)

Die GetCharWidthFloat-Funktion ruft die Bruchbreiten aufeinanderfolgender Zeichen in einem angegebenen Bereich aus der aktuellen Schriftart ab.

Syntax

BOOL GetCharWidthFloatA(
  [in]  HDC    hdc,
  [in]  UINT   iFirst,
  [in]  UINT   iLast,
  [out] PFLOAT lpBuffer
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] iFirst

Der Codepunkt des ersten Zeichens in der Gruppe der aufeinander folgenden Zeichen.

[in] iLast

Der Codepunkt des letzten Zeichens in der Gruppe der aufeinander folgenden Zeichen.

[out] lpBuffer

Ein Zeiger auf einen Puffer, der die Zeichenbreiten in logischen Einheiten 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 zurückgegebenen Breiten liegen im 32-Bit-IEEE-Gleitkommaformat vor. (Die Breite wird entlang der Basislinie der Zeichen gemessen.)

Wenn der Parameter iFirstChar den Buchstaben a und der iLastChar-Parameter den Buchstaben z angibt, ruft GetCharWidthFloat die Breite aller Kleinbuchstaben ab.

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

Hinweis

Der wingdi.h-Header definiert GetCharWidthFloat 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 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
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