ITextPara::AddTab-Methode (tom.h)

Artikel
08/26/2023

Fügt eine Registerkarte bei der Verschiebung tbPos mit dem Typ tbAlign und dem Leader-Stil tbLeader hinzu.

Syntax

HRESULT AddTab(
  [in] float tbPos,
  [in] long  tbAlign,
  [in] long  tbLeader
);

Parameter

[in] tbPos

Typ: float

Neue Tabstoppverschiebung in Gleitkommapunkten.

[in] tbAlign

Typ: long

Ausrichtungsoptionen für die Registerkartenposition. Dies kann einer der folgenden Sein:

Wert	Bedeutung
tomAlignLeft	Text wird von der Registerkartenposition aus rechtfertigt. Dies ist die Standardoption.
tomAlignCenter	Text wird auf der Registerkartenposition zentriert.
tomAlignRight	Text wird von der Registerkartenposition aus richtig begründet.
tomAlignDecimal	Das Dezimaltrennzeichen wird an der Registerkartenposition festgelegt. Dies ist nützlich, um eine Spalte mit Dezimalzahlen auszurichten.
tomAlignBar	Ein vertikaler Balken wird an der Registerkartenposition positioniert. Text ist nicht betroffen. Ausrichtungsleisten auf nahe gelegenen Linien an derselben Position bilden eine kontinuierliche vertikale Linie.

[in] tbLeader

Typ: long

Formatvorlage "Führungszeichen". Ein Führungszeichen ist das Zeichen, das verwendet wird, um den Von einem Registerkartenzeichen belegten Abstand auszufüllen. Dies kann einer der folgenden Sein:

Wert	Bedeutung
tomSpaces	Leerzeichen werden verwendet. Dies ist die Standardoption.
tomDots	Es werden Punkte verwendet.
tomDashes	Es wird eine gestrichelte Linie verwendet.
tomLines	Es wird eine durchgezogene Linie verwendet.

Rückgabewert

Typ: HRESULT

Wenn ITextPara::AddTab erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode fehlschlägt, gibt sie einen der folgenden COM-Fehlercodes zurück. Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.

Rückgabecode	Beschreibung
Wert	Bedeutung
E_ACCESSDENIED	Der Schreibzugriff wird verweigert.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.
CO_E_RELEASED	Das Absatzformatobjekt wird an einen gelöschten Bereich angefügt.

Hinweise

Es wird davon ausgegangen, dass es nie eine Registerkarte an Position 0 gibt. Wenn mehrere Absätze beschrieben werden, wird die allgemeine Teilmenge der Registerkarten mit 0x8000 im oberen Wort des Registerkartentyps zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tom.h
DLL	Msftedit.dll