Freigeben über


ITextPara::GetTab-Methode (tom.h)

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

Weitere Informationen

AddTab

ClearAllTabs

Konzept

DeleteTab

GetListTab

GetTabCount

ITextPara

Referenz

SetListTab

Textobjektmodell