ITextPara::GetTab-Methode (tom.h)

Artikel
08/26/2023

Ruft Registerkartenparameter (Verschiebung, Ausrichtung und Führungsformat) für eine angegebene Registerkarte ab.

Syntax

HRESULT GetTab(
  long  iTab,
  float *ptbPos,
  long  *ptbAlign,
  long  *ptbLeader
);

Parameter

iTab

Typ: long

Index der Registerkarte, für die Informationen abgerufen werden sollen. Dabei kann es sich entweder um einen numerischen Index oder um einen speziellen Wert handeln (siehe folgende Tabelle). Da Registerkartenindizes nullbasiert sind, erhält iTab = 0 die erste definierte Registerkarte, iTab = 1 die zweite Registerkarte definiert usw. In der folgenden Tabelle sind alle möglichen Werte von iTab zusammengefasst.

Itab	Wert	Bedeutung
tomTabBack	–3	Registerkarte "Abrufen" vor * ptbPos
tomTabWeiter	–2	Registerkarte nach * ptbPos abrufen
tomTabHere	–1	Registerkarte "Get" unter * ptbPos
	>= 0	Rufen Sie die Registerkarte mit dem Index von iTab ab (und ignorieren Sie ptbPos).

ptbPos

Typ: float*

Die Registerkartenverschiebung in Gleitkommapunkten. Der Wert von * ptbPos ist null, wenn die Registerkarte nicht vorhanden ist und der Wert von * ptbPos tomUndefined lautet, wenn mehrere Werte im zugeordneten Bereich vorhanden sind.

ptbAlign

Typ: long*

Die Registerkartenausrichtung. Weitere Informationen finden Sie unter ITextPara::AddTab.

ptbLeader

Typ: long*

Das Zeichenformat der Registerkartenführung. Weitere Informationen finden Sie unter ITextPara::AddTab.

Rückgabewert

Typ: HRESULT

Wenn ITextPara::GetTab 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_INVALIDARG	Ungültiges Argument.
CO_E_RELEASED	Das Absatzformatierungsobjekt wird an einen gelöschten Bereich angefügt.
S_FALSE	Es gibt keine Registerkarte, die iTab entspricht.

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