Méthode ITextPara ::AddTab (tom.h)

Article
03/02/2024

Ajoute un onglet au niveau du tbPos de déplacement, avec le type tbAlign, et le style de leader, tbLeader.

Syntaxe

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

Paramètres

[in] tbPos

Type : float

Nouveau déplacement d’onglet, en points à virgule flottante.

[in] tbAlign

Type : long

Options d’alignement pour la position de l’onglet. Il peut s’agir de l’un des éléments suivants.

Valeur	Signification
tomAlignLeft	Le texte est laissé justifié à partir de la position de la tabulation. Il s’agit de la valeur par défaut.
tomAlignCenter	Le texte est centré sur la position de l’onglet.
tomAlignRight	Le texte est justifié à droite à partir de la position de la tabulation.
tomAlignDecimal	La virgule décimale est définie à la position de tabulation. Cela est utile pour aligner une colonne de nombres décimaux.
tomAlignBar	Une barre verticale est positionnée à la position de tabulation. Le texte n’est pas affecté. Les barres d’alignement sur les lignes proches à la même position forment une ligne verticale continue.

[in] tbLeader

Type : long

Style de caractère de leader. Un caractère de leader est le caractère utilisé pour remplir l’espace pris par un caractère de tabulation. Il peut s’agir de l’un des éléments suivants.

Valeur	Signification
tomSpaces	Les espaces sont utilisés. Il s’agit de la valeur par défaut.
tomDots	Des points sont utilisés.
tomDashes	Une ligne en pointillés est utilisée.
tomLines	Une ligne pleine est utilisée.

Valeur retournée

Type : HRESULT

Si ITextPara ::AddTab réussit, il retourne S_OK. Si la méthode échoue, elle retourne l’un des codes d’erreur COM suivants. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour	Description
Valeur	Signification
E_ACCESSDENIED	L’accès en écriture est refusé.
E_OUTOFMEMORY	Mémoire insuffisante.
CO_E_RELEASED	L’objet de format de paragraphe est attaché à une plage qui a été supprimée.

Remarques

On suppose qu’il n’y a jamais d’onglet à la position zéro. Si plusieurs paragraphes sont décrits, le sous-ensemble commun d’onglets est retourné avec 0x8000 dans le mot supérieur du type d’onglet.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	tom.h
DLL	Msftedit.dll