TabbedTextOutA-Funktion (winuser.h)

Artikel
11/20/2024

Die TabbedTextOut--Funktion schreibt eine Zeichenfolge an einer angegebenen Position und erweitert Tabstopps auf die werte, die in einem Array von Tabstopppositionen angegeben sind. Text wird in der aktuell ausgewählten Schriftart, Hintergrundfarbe und Textfarbe geschrieben.

Syntax

LONG TabbedTextOutA(
  [in] HDC       hdc,
  [in] int       x,
  [in] int       y,
  [in] LPCSTR    lpString,
  [in] int       chCount,
  [in] int       nTabPositions,
  [in] const INT *lpnTabStopPositions,
  [in] int       nTabOrigin
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] x

Die x-Koordinate des Ausgangspunkts der Zeichenfolge in logischen Einheiten.

[in] y

Die y-Koordinate des Startpunkts der Zeichenfolge in logischen Einheiten.

[in] lpString

Ein Zeiger auf die zu zeichnende Zeichenfolge. Die Zeichenfolge muss nicht null beendet werden, da nCount die Länge der Zeichenfolge angibt.

[in] chCount

Die Länge der Zeichenfolge, auf die durch lpString-verweist.

[in] nTabPositions

Die Anzahl der Werte im Array von Tabstopppositionen.

[in] lpnTabStopPositions

Ein Zeiger auf ein Array mit den Tabstopppositionen in logischen Einheiten. Die Tabstopps müssen in zunehmender Reihenfolge sortiert werden. Der kleinste x-Wert sollte das erste Element im Array sein.

[in] nTabOrigin

Die x-Koordinate der Startposition, von der Registerkarten in logischen Einheiten erweitert werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Dimensionen der Zeichenfolge in logischen Einheiten. Die Höhe befindet sich im Wort mit hoher Reihenfolge, und die Breite befindet sich im Wort mit niedriger Reihenfolge.

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

Bemerkungen

Wenn der nTabPositions Parameter null ist und der parameter lpnTabStopPositions parameter NULList, werden Tabstopps um acht mal die durchschnittliche Zeichenbreite erweitert.

Wenn nTabPositions- 1 ist, werden die Tabstopps durch den Abstand getrennt, der durch den ersten Wert in der lpnTabStopPositions Array angegeben wird.

Wenn die lpnTabStopPositions Array mehr als einen Wert enthält, wird für jeden Wert im Array ein Tabstopp festgelegt, bis zur durch nTabPositionsangegebenen Zahl.

Mit dem nTabOrigin-Parameter kann eine Anwendung die funktion TabbedTextOut mehrmals für eine einzelne Zeile aufrufen. Wenn die Anwendung TabbedTextOut mehrmals aufruft, wobei die nTabOrigin jedes Mal auf denselben Wert festgelegt ist, erweitert die Funktion alle Registerkarten relativ zur position, die durch nTabOriginangegeben wird.

Standardmäßig wird die aktuelle Position nicht von der TabbedTextOut--Funktion verwendet oder aktualisiert. Wenn eine Anwendung die aktuelle Position aktualisieren muss, wenn sie TabbedTextOut-aufruft, kann die Anwendung die SetTextAlign--Funktion aufrufen, wobei der wFlags-Parameter auf TA_UPDATECP festgelegt ist. Wenn dieses Kennzeichen festgelegt ist, ignoriert das System die X- und Y- Parameter für nachfolgende Aufrufe der TabbedTextOut--Funktion stattdessen mithilfe der aktuellen Position.

Hinweis für Windows Vista und höher ignoriert TabbedTextOut beim Zeichnet von Text die Textausrichtung.

Anmerkung

Der winuser.h-Header definiert TabbedTextOut 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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll
API-Satz	ext-ms-win-ntuser-misc-l1-5-1 (eingeführt in Windows 10, Version 10.0.14393)