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.