Partager via


Objet TextBox (Outlook Forms Script)

Affiche des informations provenant d'un utilisateur ou d'un ensemble organisé de données.

Remarques

Le contrôle TextBox est le contrôle le plus couramment utilisé pour afficher des informations entrées par un utilisateur. En outre, il peut afficher un ensemble de données, tel qu’une table, une requête, une feuille de calcul ou le résultat d’un calcul. Si un objet TextBox est lié à une source de données, la modification du contenu de textbox modifie également la valeur de la source de données liée.

La mise en forme appliquée à tous les éléments du texte figurant dans un contrôle TextBox affecte l’ensemble du texte du contrôle. Par exemple, si vous changez la police ou la taille des points d’un caractère figurant dans le contrôle, cette modification affecte tous les caractères du contrôle.

La propriété par défaut d'un objet TextBox est la propriété Value.

Conseils sur l’utilisation de zones de texte

TextBox est un contrôle flexible régi par les propriétés suivantes : Text, MultiLine, WordWrap et AutoSize.

La propriété Text contient le texte qui est affiché dans la zone de texte.

La propriété MultiLine indique si le contrôle TextBox peut afficher du texte sur une ou plusieurs lignes. Le caractère de saut de ligne identifie la fin d’une ligne et le début d’une autre. Si MultiLine a la valeur False (valeur par défaut), le texte est tronqué au lieu de continuer à la ligne suivante.

La propriété WordWrap permet au contrôle TextBox de renvoyer à la ligne suivante le texte qui est trop long pour tenir dans la largeur de la zone de texte. La valeur par défaut est True.

Si vous n’utilisez pas WordWrap, l’objet TextBox démarre une nouvelle ligne de texte lorsqu’il rencontre un caractère de saut de ligne dans le texte. Si WordWrap est désactivé, vous pouvez avoir des lignes de texte qui ne tiennent pas complètement dans la zone de texte. TextBox affiche les parties de texte qui tiennent dans sa largeur et tronque les parties de texte qui ne tiennent pas. La propriété WordWrap n’est applicable que si la propriété MultiLine a la valeur True.

La propriété AutoSize indique si le contrôle TextBox s’adapte à l’affichage de l’ensemble du texte. Lorsque vous utilisez AutoSize avec un contrôle TextBox, la largeur de la zone de texte se rétrécit ou s’agrandit en fonction de la quantité de texte affichée dans la zone de texte et de la taille de police utilisée pour afficher le texte. La valeur par défaut est False.

La propriété AutoSize fonctionne bien dans les cas suivants :

  • Affichage d’une légende comportant une ou plusieurs lignes.

  • Affichage du contenu d’une zone de texte sur une ligne.

  • Affichage du contenu d’une zone de texte comportant plusieurs lignes, qui est en lecture seule pour l’utilisateur.

Évitez d’utiliser la propriété AutoSize avec un contrôle TextBox vide qui utilise également les propriétés MultiLine et WordWrap. Lorsque l’utilisateur entre du texte dans une zone de texte comportant ces propriétés, la zone de texte prend automatiquement la forme d’une zone étroite, d’un caractère de large, sur toute la longueur du texte.

Méthodes

Nom Description
Copy Copie le contenu d’un objet dans le Presse-papiers.
Cut Supprime d'un objet les informations sélectionnées et les transfère dans le Presse-papiers.
Paste Transfère le contenu du Presse-papiers dans un objet.

Propriétés

Nom Description
AutoSize Renvoie ou définit une valeur booléenne qui spécifie si un objet se redimensionne automatiquement pour afficher son contenu entier. Lecture-écriture.
AutoTab Renvoie ou définit une valeur booléenne qui spécifie si un onglet automatique se produit lorsqu’un utilisateur entre le nombre maximal autorisé de caractères dans un objet TextBox. Lecture-écriture.
AutoWordSelect Renvoie ou définit une valeur booléenne qui spécifie si l’unité de base utilisée pour étendre une sélection est un mot ou un caractère unique. Lecture-écriture.
BackColor Renvoie ou définit une valeur de type Long qui spécifie la couleur d’arrière-plan de l’objet. En lecture/écriture
BackStyle Renvoie ou définit une valeur de type Integer qui spécifie le style d’arrière-plan d’un objet. Lecture-écriture.
BorderColor Renvoie ou définit une valeur de type Long qui spécifie la couleur de bordure d’un objet. En lecture/écriture
BorderStyle Renvoie ou définit une valeur de type Integer qui spécifie le type de bordure du contrôle. En lecture/écriture
CanPaste Renvoie une valeur booléenne qui spécifie si le Presse-papiers contient des données que l’objet prend en charge. En lecture seule.
CurLine Renvoie ou définit une valeur de type Long qui représente la ligne actuelle d’un contrôle. Lecture-écriture.
CurTargetX Renvoie une valeur de type Long qui représente la position horizontale préférée du point d’insertion dans une zone de texte multiligne. En lecture seule.
CurX Renvoie ou définit une valeur de type Long qui représente la position horizontale actuelle du point d’insertion dans une zone de texte multiligne. Lecture-écriture.
DragBehavior Renvoie ou définit une valeur de type Integer qui spécifie si le système autorise l'utilisation de la fonction glisser-déplacer avec ce contrôle. Lecture-écriture.
Enabled Renvoie ou définit une valeur booléenne qui spécifie si un contrôle peut recevoir le focus et répondre aux événements générés par l’utilisateur. Lecture-écriture.
EnterFieldBehavior Renvoie ou définit une valeur de type Integer qui spécifie le comportement de sélection lors de l’entrée d’une zone de texte. Lecture-écriture.
EnterKeyBehavior Renvoie ou définit une valeur booléenne qui définit l’effet d’appuyer sur Entrée dans une zone de texte. Lecture-écriture.
ForeColor Renvoie ou définit une valeur de type Long qui spécifie la couleur d'avant-plan d'un objet. En lecture/écriture
HideSelection Renvoie ou définit une valeur de type Boolean qui spécifie su le texte sélectionné reste en surbrillance lorsqu'un contrôle n'est pas activé. Lecture-écriture.
IMEMode Renvoie ou définit une valeur de type Integer qui spécifie le mode d'exécution par défaut de l'Éditeur de méthode d'entrée (IME) d'un contrôle. Lecture-écriture.
IntegralHeight Renvoie ou définit une valeur booléenne qui spécifie si un objet TextBox affiche des lignes de texte complètes ou partielles. Lecture-écriture.
LineCount Renvoie une valeur de type Long qui spécifie le nombre de lignes de texte dans une zone de texte. En lecture seule.
Locked Renvoie ou définit une valeur de type Boolean qui spécifie si un contrôle peut être modifié. Lecture-écriture.
MaxLength Renvoie ou définit une valeur de type Long qui spécifie le nombre maximal de caractères qu’un utilisateur peut entrer dans une zone de texte. En lecture/écriture
MouseIcon Renvoie une valeur de type String qui représente le nom complet du chemin d’accès d’une icône personnalisée qui doit être affectée au contrôle. En lecture seule.
MousePointer Renvoie ou définit une valeur de type Integer qui spécifie le type de pointeur affiché lorsque l’utilisateur positionne la souris sur un objet particulier. Lecture-écriture.
MultiLine Renvoie ou définit une valeur booléenne qui spécifie si un contrôle peut accepter et afficher plusieurs lignes de texte. En lecture/écriture
PasswordChar Renvoie ou définit une valeur de type String qui spécifie un caractère d’espace réservé à afficher au lieu des caractères réellement entrés dans une zone de texte. Lecture-écriture.
ScrollBars Renvoie ou définit une valeur de type Integer qui spécifie si un contrôle a des barres de défilement verticales, des barres de défilement horizontales ou les deux. En lecture/écriture
SelectionMargin Renvoie ou définit une valeur de type Boolean qui spécifie si l'utilisateur peut sélectionner une ligne de texte en cliquant dans la marge gauche du texte. En lecture/écriture
SelLength Renvoie ou définit une valeur de type Long qui représente le nombre de caractères sélectionnés dans une zone de texte. Lecture-écriture.
SelStart Renvoie ou définit une valeur de type Long qui représente le point de départ du texte sélectionné, ou le point d’insertion si aucun texte n’est sélectionné. En lecture/écriture
SelText Renvoie ou définit une valeur de type String qui représente le texte sélectionné d’un contrôle. Lecture-écriture.
SpecialEffect Renvoie ou définit une valeur de type Integer qui spécifie l’apparence visuelle d’un objet. En lecture/écriture
TabKeyBehavior Renvoie ou définit une valeur booléenne qui spécifie si les onglets sont autorisés dans la région d’édition. Lecture-écriture.
Texte Renvoie ou définit une valeur de type String qui spécifie du texte dans le contrôle . En lecture/écriture
TextAlign Renvoie ou définit une valeur de type Integer qui spécifie le mode d'alignement du texte dans un contrôle. En lecture/écriture
TextLength Renvoie une valeur de type Long qui représente la longueur, en nombre de caractères, du texte dans la zone d’édition d’une zone de texte. En lecture seule.
Valeur Renvoie ou définit un variant qui spécifie du texte dans la région d’édition. Lecture-écriture.
WordWrap Renvoie ou définit une valeur de type Boolean qui spécifie si le contenu d'un contrôle est automatiquement renvoyé à ligne en fin de ligne, ou si le contrôle s'étend pour s'ajuster à la taille du texte. Lecture-écriture.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.