TextBox.InputMask, propriété (Access)

  • Article

Utilisez la propriété InputMask pour faciliter l’entrée de données et contrôler les valeurs que les utilisateurs peuvent entrer dans un contrôle de zone de texte. String en lecture/écriture.

Syntaxe

expression. Masque d’entrée

Expression Variable qui représente un objet TextBox .

Remarques

Les masques d’entrée sont utiles pour les opérations de saisie de données telles qu’un masque d’entrée pour un champ Numéro de téléphone qui vous montre exactement comment entrer un nouveau nombre : (___) ___-____. Il est souvent plus facile d’utiliser l’Assistant Masque d’entrée pour définir la propriété pour vous.

La propriété InputMask (MasqueSaisie) peut comporter une à trois sections séparées par des points-virgules (;) :

Section Description
Premier Spécifie le masque de saisie lui-même (par exemple, !(9) 00-00-00-00). Pour obtenir la liste des caractères que vous pouvez utiliser pour définir le masque d’entrée, consultez le tableau suivant.
Deuxième Spécifie si Microsoft Access stocke les caractères d’affichage littéral dans la table lorsque vous entrez des données. Si vous utilisez 0 pour cette section, tous les caractères d’affichage littéral (par exemple, les parenthèses dans un masque de saisie de numéro de téléphone) sont stockés avec la valeur ; si vous entrez 1 ou laissez cette section vide, seuls les caractères tapés dans le contrôle sont stockés.
Troisième Spécifie le caractère qu’Access affiche pour l’espace dans lequel vous devez taper un caractère dans le masque d’entrée. Dans cette section, tous les caractères sont acceptés ; pour afficher une chaîne vide, utilisez un espace compris entre guillemets (" ").

En Visual Basic, vous utilisez une expression de chaîne pour définir cette propriété. Par exemple, le code suivant spécifie un masque d’entrée pour un contrôle de zone de texte utilisé pour entrer un numéro de téléphone.

Forms!Customers!Telephone.InputMask = "(###) ###-####"

Lorsque vous créez un masque de saisie, vous pouvez utiliser des caractères spéciaux pour indiquer que l'entrée de certaines données est obligatoire (telles que l'indicatif régional pour un numéro de téléphone) et que celle d'autres données est facultative (telles qu'une extension téléphonique). Ces caractères spécifient le type de données, telles qu'un nombre ou un caractère que vous devez entrer pour chaque caractère dans le masque de saisie.

Vous pouvez définir un masque de saisie en utilisant les caractères suivants :

Caractère Description
0 Chiffre (0 à 9, entrée obligatoire ; signes [+] et moins [?] non autorisés).
9 Chiffre ou espace (entrée non obligatoire ; signes plus et moins non autorisés).
# Chiffre ou espace (entrée facultative, positions vides converties en espaces en mode édition, mais les espaces sont effacés lors de la sauvegarde des données, signes plus et moins acceptés).
L Lettre (A à Z, entrée obligatoire).
? Lettre (A à Z, entrée facultative).
A Lettre ou chiffre (entrée obligatoire).
a Lettre ou chiffre (entrée facultative).
& Caractère quelconque ou espace (entrée obligatoire).
C Caractère quelconque ou espace (entrée facultative).
. , : ; - / Espace réservé décimal et séparateurs de milliers, de date et d’heure. (Le caractère réel utilisé dépend des paramètres de la boîte de dialogue Propriétés des paramètres régionaux dans le Panneau de configuration Windows).
< Convertit tous les caractères en minuscules.
> Convertit tous les caractères en majuscules.
! Permet un remplissage du masque de saisie à partir de la droite et non de gauche à droite, lorsque les caractères situés à gauche du masque de saisie sont facultatifs. Les caractères tapés dans le masque le remplissent toujours de la gauche vers la droite. Le point d'exclamation peut être placé n'importe où dans le masque de saisie.
\ Affiche le caractère qui suit sous sa forme ASCII littérale (par exemple, \A s'affiche sous la forme A).

Remarque

Si vous affectez à la propriété InputMask (MasqueSaisie) la valeur Mot de passe, vous créez un contrôle protégé par un mot de passe. Tous les caractères tapés dans la zone sont enregistrés mais remplacés à l’écran par un astérisque (*). Vous utilisez le masque de saisie Mot de passe pour empêcher l'affichage des caractères tapés.

Lorsque vous tapez des données dans un champ pour lequel vous avez défini un masque de saisie, les données sont toujours entrées en mode de surfrappe. Si vous utilisez la touche Retour arrière pour supprimer un caractère, le caractère est remplacé par un espace vide.

Si vous déplacez du texte d'un champ comportant un masque de saisie vers le Presse-papiers, les caractères d'affichage littéraux sont copiés, qu'ils soient enregistrés avec des données ou non.

Remarque

Seuls les caractères saisis directement dans un contrôle ou une zone de liste déroulante sont concernés par le masque de saisie. Access ignore les masques d’entrée lorsque vous importez des données, exécutez une requête d’action ou entrez des caractères dans un contrôle en définissant la propriété Text du contrôle en Visual Basic ou en utilisant l’action DéfinirValeur dans une macro.

Lorsque vous avez défini un masque d’entrée et défini la propriété Format pour le même champ, la propriété Format est prioritaire lorsque les données sont affichées. En d'autres termes, même si vous avez enregistré un masque de saisie, il est ignoré lors de la mise en forme et de l'affichage des données. Les données de la table sous-jacente elles-mêmes ne sont pas modifiées, la propriété Format n'a d'effet que sur l'affichage des données.

Le tableau suivant présente des masques d’entrée utiles et le type de valeurs que vous pouvez y entrer.

Masque de saisie Valeurs exemples
(0) 00-00-00-00 (1) 55-50-24-48
(9) 99-99-99-99 (206) 555-0248, ( ) 555-0248
(0) AA-AA-AA-AA (1) 55-55-TE-LE
#999 ?20, 2000
>L???? L?000L0 GREENGR339M3, MAI R 452B7
>L0L 0L0 T2F 8M4
00000-9999 98115-, 98115-3007
>L<?????????????? Maria, Brendan
SSN 000-00-0000 SSN 555-55-5555
>LL00000-0000 DB51392-0493

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.