TabbedTextOutA-Funktion (winuser.h)

Artikel
03/04/2024

Die TabbedTextOut-Funktion schreibt eine Zeichenfolge an einer angegebenen Position und erweitert Registerkarten 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 Startpunkts 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 mit Null beendet werden, da nCount die Länge der Zeichenfolge angibt.

[in] chCount

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

[in] nTabPositions

Die Anzahl der Werte im Array der Tabstopppositionen.

[in] lpnTabStopPositions

Ein Zeiger auf ein Array, das die Tabstopppositionen in logischen Einheiten enthält. 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 aus 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 ist das Wort in hoher Reihenfolge, und die Breite ist das Wort mit niedriger Ordnung.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Wenn der nTabPositions-Parameter null und der lpnTabStopPositions-ParameterNULL ist, werden Registerkarten auf das Achtfache der durchschnittlichen Zeichenbreite erweitert.

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

Wenn das lpnTabStopPositions-Array mehr als einen Wert enthält, wird für jeden Wert im Array ein Tabstopp bis zu der von nTabPositions angegebenen Zahl festgelegt.

Der Parameter nTabOrigin ermöglicht es einer Anwendung, die TabbedTextOut-Funktion mehrmals für eine einzelne Zeile aufzurufen. Wenn die Anwendung TabbedTextOut mehrmals aufruft, wobei nTabOrigin jedes Mal auf denselben Wert festgelegt ist, erweitert die Funktion alle Registerkarten relativ zur von nTabOrigin angegebenen Position.

Standardmäßig wird die aktuelle Position von der TabbedTextOut-Funktion nicht verwendet oder aktualisiert. Wenn eine Anwendung beim Aufrufen von TabbedTextOut die aktuelle Position aktualisieren muss, kann die Anwendung die SetTextAlign-Funktion aufrufen, wobei der wFlags-Parameter auf TA_UPDATECP festgelegt ist. Wenn dieses Flag festgelegt ist, ignoriert das System die X - und Y-Parameter bei nachfolgenden Aufrufen der TabbedTextOut-Funktion und verwendet stattdessen die aktuelle Position.

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

Hinweis

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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-misc-l1-5-1 (eingeführt in Windows 10, Version 10.0.14393)