Metodo ITextPara::AddTab (tom.h)

Articolo
08/26/2023

Aggiunge una scheda alla tbPos di spostamento, con tipo tbAlign e stile leader, tbLeader.

Sintassi

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

Parametri

[in] tbPos

Tipo: float

Nuovo spostamento di schede, in punti a virgola mobile.

[in] tbAlign

Tipo: long

Opzioni di allineamento per la posizione della scheda. Può essere uno dei seguenti.

Valore	Significato
tomAlignLeft	Il testo viene lasciato giustificato dalla posizione della scheda. Questo è il valore predefinito.
tomAlignCenter	Il testo viene centrato sulla posizione della scheda.
tomAlignRight	Il testo è giustificato dalla posizione della scheda.
tomAlignDecimal	Il punto decimale è impostato nella posizione della scheda. Ciò è utile per allineare una colonna di numeri decimali.
tomAlignBar	Una barra verticale è posizionata nella posizione della scheda. Il testo non è interessato. Le barre di allineamento sulle linee vicine nella stessa posizione formano una linea verticale continua.

[in] tbLeader

Tipo: long

Stile carattere leader. Un carattere leader è il carattere utilizzato per riempire lo spazio occupato da un carattere di tabulazioni. Può essere uno dei seguenti.

Valore	Significato
tomSpaces	Vengono usati spazi. Questo è il valore predefinito.
tomDots	I punti vengono usati.
tomDashes	Viene usata una linea tratteggiata.
tomLines	Viene usata una linea solida.

Valore restituito

Tipo: HRESULT

Se ITextPara::AddTab riesce, restituisce S_OK. Se il metodo ha esito negativo, restituisce uno dei codici di errore COM seguenti. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito	Descrizione
Valore	Significato
E_ACCESSDENIED	Accesso in scrittura negato.
E_OUTOFMEMORY	Memoria insufficiente.
CO_E_RELEASED	L'oggetto formato paragrafo è collegato a un intervallo eliminato.

Commenti

Si presuppone che non vi sia mai una scheda in corrispondenza della posizione zero. Se vengono descritti più paragrafi, il subset comune di schede verrà restituito con 0x8000 nella parola superiore del tipo di scheda.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tom.h
DLL	Msftedit.dll