Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

TextBox - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Définit la classe de zone de texte. Lorsque l'objet est sérialisé en XML, son nom qualifié est v: textbox.

Espace de noms :  DocumentFormat.OpenXml.Vml
Assembly :  DocumentFormat.OpenXml (dans DocumentFormat.OpenXml.dll)

[ChildElementInfoAttribute(typeof(TextBoxContent))]
public class TextBox : OpenXmlCompositeElement

[ISO/IEC 29500-1 1st Edition]

textbox (Text Box)

Cet élément est utilisé pour définir le texte qui apparaît à l'intérieur de la forme. Ce texte peut contenir une mise en forme riche et est restitué de façon à tenir à l'intérieur de la textboxrect définie par l'élément de tracé (§14.1.2.14).

[Exemple :

<v:shape style="width=200;height=200" coordsize="400,400" 
  fillcolor="yellow" strokecolor="maroon" 
  path="m  148,86 238,86 166,140 192,226 119,175 46,226 
  72,140 0,86 90,86 x e">
  <v:textbox inset="32pt,35pt,,">VML</v:textbox>
</v:shape>

Fin de l’exemple]

Éléments parents

arc (§14.1.2.1) ; arrière-plan (partie 1, §17.2.1) ; courbe (§14.1.2.3) ; groupe (§14.1.2.7) ; image (§14.1.2.10) ; ligne (§14.1.2.12) ; objet (partie 1, §17.3.3.19) ; ovale (§14.1.2.13) ; PICT (§9.2.2.2) ; PICT (§9.5.1) ; Polyline (§14.1.2.15) ; Rect (§14.1.2.16) ; RoundRect (§14.1.2.17) ; forme (§14.1.2.19) ; shapedefaults (§14.2.2.28) ; ShapeType (§14.1.2.20)

Élements enfants

Sous-clause

txbxContent (conteneur de contenu enrichi texte boîte)

§9.8.1.1

Attributs

Description

ID (identificateur Unique)

Spécifie un identificateur unique qui peut être utilisé pour faire référence à un objet VML.

Aucune valeur par défaut est.

[Exemple :

<v:shape … id="myShape" … >
</v:shape>

Fin de l’exemple]

Les valeurs possibles pour cet attribut sont définies par le type de données chaîne W3C XML Schema.

incrustation (incrustation de la zone de texte)

Spécifie les valeurs de marge interne pour le texte de la zone de texte. Par défaut est « 0,1 dans 0,05 dans, 0,1 dans, 0,05 dans ». Les valeurs manquantes sont la valeur par défaut. Il est utilisé si insetmode est personnalisé.

La valeur de marge de texte interne est spécifiée sous la forme d'une chaîne qui contient quatre valeurs, séparés par des virgules ou des espaces. Les valeurs de mesurent incrustation à partir de la gauche, haut, droite et les bords inférieurs de la zone spécifiée par l'attribut textboxrect de l'élément de tracé (§14.1.2.14).

[Exemple: le texte est défini vers le coin inférieur droit d'un petit carré :

<v:textbox inset="20pt,30pt,10pt,10pt">
  VML</v:textbox>

Fin de l’exemple]

Les valeurs possibles pour cet attribut sont définies par le type de données chaîne W3C XML Schema.

insetmode (Mode incrustation de texte)

Espace de noms : urn : schemas-microsoft-com:office:office

Indique si l'application calcule la marge de texte interne au lieu d'utiliser l'attribut de l'encart. Valeur par défaut est personnalisé.

[Exemple :

<v:textbox … o:insetmode="auto" … >
</v:textbox>

Fin de l’exemple]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_InsetMode (§14.2.3.17).

clic unique (texte zone de clic sélection bascule)

Espace de noms : urn : schemas-microsoft-com:office:office

Spécifie si le texte est sélectionnable par un simple clic. Valeur par défaut est false.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_TrueFalse (§15.1.2.5).

style (propriétés de styles de forme)

Spécifie les propriétés de style 2 de la forme. Le 2 (Cascading Style Sheets, Level 2) spécification, une recommandation du World Wide Web Consortium, est disponible ici : http://www.w3.org/TR/REC-2.

Cet attribut utilise une point-virgule liste délimitée de paires "nom : valeur", la syntaxe définie par le point 4.1.8 de la spécification 2 pour les déclarations groupées (sans accolades qui l'entourent). Les tableaux suivants décrivent les propriétés autorisées et le traitement du langage VML de chacun.

[Exemple :

<v:shape … style=’position:absolute;width:100pt;height:50pt’ … >
</v:shape>

Fin de l’exemple]

Propriété

Description

Inverser (Flip)

Spécifie que l'orientation d'une forme est retournée. Aucune valeur par défaut est. Les valeurs autorisées sont :

  • x - symétrie le long de l'axe y, en inversant les coordonnées x.

  • y - symétrie le long de l'axe x, en inversant les coordonnées y.

  • xy - symétrie le long de l'y et l'axe des x.

  • yx - retourner à la fois le long x et l'axe y.

Hauteur

Spécifie la hauteur du bloc contenant de la forme.  Valeur par défaut est 0. Elle est spécifiée en unités ou, pour les éléments dans un groupe, dans le système de coordonnées de l'élément parent. Les valeurs autorisées sont :

  • auto - position par défaut d'un élément dans l'enchaînement de la page.

  • < unités > - un nombre avec un indicateur d'unité absolue (cm, mm, in, pt, pc ou px) ou d'un rapport indicateur d'unités (em ou ex). Si aucune unité n'est indiquée, les pixels (px) est supposé.

  • < pourcentage >-valeur exprimée sous la forme d'un pourcentage de la hauteur de l'objet parent.

Left

Spécifie la position de gauche du bloc contenant de la forme par rapport à la gauche de l'élément de celle-ci dans le flux de la page. Valeur par défaut est 0. Elle est spécifiée en unités ou, pour les éléments dans un groupe, dans le système de coordonnées de l'élément parent. Cette propriété ne doit pas être utilisée pour ancré de formes inline. Les valeurs autorisées sont :

  • auto - position par défaut d'un élément dans l'enchaînement de la page.

  • < Units > - un nombre avec un indicateur d'unité absolue (cm, mm, in, pt, pc ou px) ou un indicateur relatif d'unités (em ou ex). Si aucune unité n'est indiquée, les pixels (px) est supposé.

  • < pourcentage >-valeur exprimée sous la forme d'un pourcentage de la largeur de l'objet parent.

en bas de la marge

Spécifie la position de la partie inférieure du bloc contenant de la forme par rapport à l'ancrage de la forme. Valeur par défaut est 0. Elle est spécifiée en unités ou, pour les éléments dans un groupe, dans le système de coordonnées de l'élément parent. Les valeurs autorisées sont :

  • auto - position par défaut d'un élément dans l'enchaînement de la page.

  • < unités > - un nombre avec un indicateur d'unité absolue (cm, mm, in, pt, pc ou px) ou d'un rapport indicateur d'unités (em ou ex). Si aucune unité n'est indiquée, les pixels (px) est supposé.

  • < pourcentage >-valeur exprimée sous la forme d'un pourcentage de la hauteur de l'objet parent.

marge de gauche

Spécifie la position de gauche du bloc contenant de la forme par rapport à l'ancrage de la forme. Valeur par défaut est 0. Elle est spécifiée en unités ou, pour les éléments dans un groupe, dans le système de coordonnées de l'élément parent. Les valeurs autorisées sont :

  • auto - position par défaut d'un élément dans l'enchaînement de la page.

  • < unités > - un nombre avec un indicateur d'unité absolue (cm, mm, in, pt, pc ou px) ou d'un rapport indicateur d'unités (em ou ex). Si aucune unité n'est indiquée, les pixels (px) est supposé.

  • < pourcentage >-valeur exprimée sous la forme d'un pourcentage de la largeur de l'objet parent.

marge de droite

Spécifie la position de la droite du bloc contenant de la forme par rapport à l'ancrage de la forme. Valeur par défaut est 0. Elle est spécifiée en unités ou, pour les éléments dans un groupe, dans le système de coordonnées de l'élément parent. Les valeurs autorisées sont :

  • auto - position par défaut d'un élément dans l'enchaînement de la page.

  • < Units > - un nombre avec un indicateur d'unité absolue (cm, mm, in, pt, pc ou px) ou un indicateur relatif d'unités (em ou ex). Si aucune unité n'est indiquée, les pixels (px) est supposé.

  • < pourcentage >-valeur exprimée sous la forme d'un pourcentage de la largeur de l'objet parent.

en haut de la marge

Spécifie la position du bord supérieur du bloc contenant de la forme par rapport à l'ancrage de la forme. Valeur par défaut est 0. Elle est spécifiée en unités ou, pour les éléments dans un groupe, dans le système de coordonnées de l'élément parent. Les valeurs autorisées sont :

  • auto - position par défaut d'un élément dans l'enchaînement de la page.

  • < unités > - un nombre avec un indicateur d'unité absolue (cm, mm, in, pt, pc ou px) ou d'un rapport indicateur d'unités (em ou ex). Si aucune unité n'est indiquée, les pixels (px) est supposé.

  • < pourcentage >-valeur exprimée sous la forme d'un pourcentage de la hauteur de l'objet parent.

MSO-position-horizontal

Spécifie les données de positionnement horizontales pour les objets dans des documents WordprocessingML. Valeur par défaut est absolue. Les valeurs autorisées sont :

  • ABSOLUTE

  • Left

  • Centrer

  • DROITE

  • Inside

  • Outside

MSO-position-horizontal-relative

Spécifie les données de position horizontale relative pour les objets dans des documents WordprocessingML. Cette option modifie la propriété mso-position-horizontal . Valeur par défaut est texte. Les valeurs autorisées sont :

  • marge

  • page

  • texte

  • CAR

MSO-position-vertical

Spécifie les données de positionnement verticales des objets dans des documents WordprocessingML. Valeur par défaut est absolue. Les valeurs autorisées sont :

  • ABSOLUTE

  • Haut

  • Centrer

  • Bas

  • Inside

  • Outside

MSO-position-vertical-relative

Spécifie les données de position verticale relative pour les objets dans des documents WordprocessingML. Cette option modifie la propriété mso-position-vertical . Valeur par défaut est texte. Les valeurs autorisées sont :

  • marge

  • page

  • texte

  • line

MSO-retour à la ligne-distance-bas

Spécifie la distance à partir du bas de la forme et le texte qui gravite autour d'elle. Valeur par défaut est 0 pts. Cette propriété est différente de la propriété de marge , ce qui modifie l'origine de la forme pour inclure les zones de marges. Cette propriété ne modifie pas l'origine.

retour à la ligne-distance-mso-gauche

Spécifie la distance entre le côté gauche de la forme et le texte qui gravite autour d'elle. Valeur par défaut est 0 pts. Cette propriété est différente de la propriété de marge , ce qui modifie l'origine de la forme pour inclure les zones de marges. Cette propriété ne modifie pas l'origine.

MSO-retour à la ligne-distance-droite

Spécifie la distance entre le côté droit de la forme et le texte qui gravite autour d'elle. Valeur par défaut est 0 pts. Cette propriété est différente de la propriété de marge , ce qui modifie l'origine de la forme pour inclure les zones de marges. Cette propriété ne modifie pas l'origine.

MSO-retour à la ligne-distance-haut

Spécifie la distance entre le haut de la forme et le texte qui gravite autour d'elle. Valeur par défaut est 0 pts. Cette propriété est différente de la propriété de marge , ce qui modifie l'origine de la forme pour inclure les zones de marges. Cette propriété ne modifie pas l'origine.

MSO-retour à la ligne modifiée

Spécifie si les coordonnées de retour à la ligne ont été personnalisées par l'utilisateur. Si les coordonnées d'habillage sont générées par un éditeur, cette propriété est true; dans le cas contraire, ils ont été personnalisés par un utilisateur. Valeur par défaut est false.

style de mso-retour

Spécifie le mode d'habillage du texte dans des formes dans des documents WordprocessingML. Valeur par défaut est carré. Les valeurs autorisées sont :

  • carré - ajuste le texte à l'intérieur de la forme d'un carré.

  • Aucun - texte ne passe pas.

position

Spécifie le type de positionnement utilisé pour placer un élément. Valeur par défaut est statique. Lorsque l'élément est contenu à l'intérieur d'un groupe, cette propriété doit être absolu. Les valeurs autorisées sont :

  • statique - l'élément est positionné après le flux normal de la page. Les propriétés haut et gauche sont ignorées. Si l'objet est ancré inline, cette valeur est utilisée.

  • absolu - l'élément est positionné par rapport au parent, à l'aide des propriétés haut et gauche .

  • relative - l'élément est positionné après le flux normal de la page, mais les propriétés haut et gauche sont utilisées. La superposition des éléments superposés est régie par la propriété z-index .

Rotation

Spécifie l'angle de rotation qui permet une forme, en degrés. Valeur par défaut est 0. Les angles positifs sont dans le sens horaire.

Haut

Spécifie la position du bord supérieur du bloc contenant de la forme par rapport à l'élément au-dessus de lui dans le flux de la page. Valeur par défaut est 0. Elle est spécifiée en unités ou, pour les éléments dans un groupe, dans le système de coordonnées de l'élément parent. Cette propriété ne doit pas être utilisée pour ancré de formes inline. Les valeurs autorisées sont :

  • auto - position par défaut d'un élément dans l'enchaînement de la page.

  • < unités > - un nombre avec un indicateur d'unité absolue (cm, mm, in, pt, pc ou px) ou d'un rapport indicateur d'unités (em ou ex). Si aucune unité n'est indiquée, les pixels (px) est supposé.

  • < pourcentage >-valeur exprimée sous la forme d'un pourcentage de la hauteur de l'objet parent.

Visibilité.

Spécifie si une forme est affichée. Uniquement hériter et masqués sont utilisés ; toutes les autres valeurs sont mappés à hériter. Valeur par défaut est hériter. Les valeurs autorisées sont :

  • masqué - la forme n'est pas visible, mais fait toujours partie du flux des objets dans le navigateur. Événements de souris ne sont pas traités.

  • hériter - l'état de visibilité est héritée du parent de la forme.

width

Spécifie la largeur du bloc contenant de la forme.  Valeur par défaut est 0. Elle est spécifiée en unités ou, pour les éléments dans un groupe, dans le système de coordonnées de l'élément parent. Les valeurs autorisées sont :

  • auto - position par défaut d'un élément dans l'enchaînement de la page.

  • < unités > - un nombre avec un indicateur d'unité absolue (cm, mm, in, pt, pc ou px) ou d'un rapport indicateur d'unités (em ou ex). Si aucune unité n'est indiquée, les pixels (px) est supposé.

  • < pourcentage >-valeur exprimée sous la forme d'un pourcentage de la largeur de l'objet parent.

z-index

Spécifie l'ordre d'affichage des formes se chevauchant. Valeur par défaut est 0. Cette propriété ne doit pas être utilisée pour ancré de formes inline. Les valeurs autorisées sont :

  • auto - utilise l'ordre d'apparition des formes dans la page, de bas en haut.

  • < commande >-un nombre qui représente la priorité de superposition. Les formes les plus élevées sont placées en plus de celles avec les numéros les plus bas. Les nombres négatifs sont autorisés.

Les propriétés suivantes sont uniquement utilisées par l'élément de zone de texte (§14.1.2.22) :

Propriété

Description

Direction (Sens)

Spécifie la direction du texte dans la zone de texte. Valeur par défaut est g. Cette propriété est remplacée par la propriété direction mso-alt si qui est spécifié. Les valeurs autorisées sont :

  • g - texte est affiché de gauche à droite.

  • rtl - texte est affiché de droite à gauche.

flux de mise en page

Détermine le flux de la disposition du texte dans une zone de texte. Valeur par défaut est horizontal. Les valeurs autorisées sont :

  • horizontal - texte est affiché horizontalement.

  • vertical - texte est affiché verticalement.

  • vertical-IDÉOGRAPHIQUE -IDÉOGRAPHIQUE texte est affiché verticalement.

  • horizontal-IDÉOGRAPHIQUE -texte IDÉOGRAPHIQUE est affiché horizontalement.

MSO-direction-alt

Spécifie une autre direction pour le texte dans les zones de texte. Substitue la propriété direction . La seule valeur autorisée est contexte.

MSO forme ajuster au texte

Spécifie si la forme s'étend pour inclure du texte dans la zone de texte. Valeur par défaut est false.

MSO texte adapté à forme

Spécifie si le texte s'étire en fonction de la zone de texte. Valeur par défaut est false.

MSO-disposition-flux-alt

Spécifie le flux de disposition différente pour le texte dans les zones de texte. Cette propriété est utilisée plutôt que le flux de mise en page lorsque le flux de disposition est de bas en haut pour les langues non IDÉOGRAPHIQUE.  Sa seule valeur est bas vers le haut.

suivant-mso-textbox

Spécifie l'ID de la zone de texte suivante dans une série. Utilisé pour suivre un ensemble de zones de texte liées. Aucune valeur par défaut est.

faire pivoter le Mso

Spécifie une valeur de rotation spécifique pour le texte dans un contrôle textbox. Valeur par défaut est 0. Les valeurs autorisées sont :

  • 0

  • 90

  • 180

  • -90

MSO-texte-échelle

Spécifie le facteur d'ajustement du texte à des formes. Valeur par défaut est 0. Cette propriété est uniquement utilisée si mso texte adapté à forme a la valeur true.

ancre de texte v

Spécifie l'ancrage vertical du texte dans une zone de texte. Valeur par défaut est top. L'alignement d'une ancre de texte ne devient évident si mso texte adapté à forme a la valeur false. Cette propriété est différente de la propriété vertical-align , qui est utilisée par les langues idéographiques. Les valeurs autorisées sont :

  • Haut

  • Milieu

  • Bas

  • en haut au centre

  • Centre

  • en bas au centre

  • haut-planification

  • bas-planification

  • haut-centre-planification

  • bas-centre-planification

Les propriétés suivantes sont uniquement utilisées par l'élément textpath (§14.1.2.23) :

Propriété

Description

Police

Spécifie une valeur composée de paramètres des polices. Aucune valeur par défaut est. Les valeurs sont les mêmes que ceux de la propriété font. L'ordre des définitions dans la chaîne est : font-style, font-variant, font-weight, taille de police, hauteur de ligne, famille de polices.

Famille de police

Spécifie la famille de la police. Aucune valeur par défaut est. Les valeurs sont les mêmes que ceux de la propriété de famille de polices.

Taille de police

Spécifie la taille de la police. Aucune valeur par défaut est. La taille de police est définie en points. Les valeurs sont les mêmes que ceux de la propriété font-size.

style de police

Spécifie la quantité d'inclinaison d'une police. Valeur par défaut est normal. Les valeurs sont les mêmes que ceux de la propriété de style de la police. Les valeurs autorisées sont :

  • Normal

  • italique

  • oblique - traitée comme italique.

font-variant

Spécifie le style de variante d'une police. Valeur par défaut est normal. Les valeurs sont les mêmes que ceux de la propriété font-variant. Les valeurs autorisées sont :

  • Normal

  • actions à faible capitalisation

Épaisseur de police

Spécifie l'épaisseur des lettres de la police. Valeur par défaut est normal. Les valeurs sont les mêmes que ceux de la propriété de l'épaisseur de la police. Les valeurs autorisées sont :

Valeur

Description

Normal

Plus fine

100

200

300

400

Traitée comme non gras.

gras

plus gras

500

600

700

800

900

Traités en gras.

MSO-text-shadow

Indique si une ombre est appliquée au texte sur un tracé de texte. Valeur par défaut est false.

décoration de texte

Spécifie le style de décoration de texte. Valeur par défaut est none. Les valeurs sont les mêmes que ceux de la propriété de décoration de texte. Les valeurs autorisées sont :

  • aucun

  • Souligné

  • ligne au-dessus

  • par ligne

  • clignotement

v-rotation-lettres

Spécifie si les lettres du texte sont dans le sens anti-horaire pivote de 90 degrés. Valeur par défaut est false.

v---hauteur identique

Spécifie si toutes les lettres ont la même hauteur, quel que soit l'incident initial. Si true, les lettres minuscules sont étirés à la hauteur des lettres en majuscules. Valeur par défaut est false.

v-text-align

Spécifie l'alignement du texte. Valeur par défaut est gauche. Les valeurs autorisées sont :

  • Left

  • DROITE

  • Centrer

  • Justify

  • lettres justifiées - répartit l'espace supplémentaire entre les lettres.

  • étirement justifié - étire les lettres à remplir l'espace.

v-texte-kern

Indique si le crénage est activé. Valeur par défaut est false.

v-texte-inverse

Spécifie si l'ordre de mise en page des lignes est inversé. Valeur par défaut est false. Il est utilisé pour la disposition de texte verticale.

mode v-texte-espacement

Spécifie le mode d'espacement entre les lettres. Valeur par défaut est que serrer. Cette propriété détermine si l'espace est supprimé entre chaque lettre (renforcement) ou ajouté entre chaque lettre (suivi de). Le montant de la modification de l'espacement de lettre est défini par la propriété v--espacement du texte . Les valeurs autorisées sont :

  • SERRAGE

  • Suivi

v-texte-espacement

Spécifie la quantité de l'espacement du texte en 100ths interligne simple. Valeur par défaut est 100.

La ligne (§14.1.2.12), polyline (§14.1.2.15) et éléments de courbe (§14.1.2.3) ignorent les propriétés suivantes :

  • Haut

  • Left

  • width

  • Hauteur

Les propriétés suivantes ne sont pas héritées par un élément qui fait référence à un élément shapetype (§14.1.2.20) via l'attribut d'id :

  • Inverser (Flip)

  • Hauteur

  • Left

  • marge de gauche

  • en haut de la marge

  • position

  • Rotation

  • Haut

  • Visibilité.

  • width

  • z-index

Les valeurs possibles pour cet attribut sont définies par le type de données chaîne W3C XML Schema.

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_Textbox) se trouve dans §A.6.1. fin de la Remarque]

© ISO/IEC29500: 2008.

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.
Afficher: