Pour afficher cet éditeur de propriété, choisissez la propriété displayMask
dans l'inspecteur quand un composant Column
(d'un StorageDataSet
) est sélectionné dans l'arborescence des composants.
La propriété displayMask
stocke la chaîne de spécification utilisée pour formater les données affichées dans la colonne. Pour une colonne Date
les données peuvent, par exemple, être affichées en utilisant les formats "MM/dd/yy" ou "dd/MM/yy". Pour une colonne numérique c'est à l'aide du format que vous spécifiez l'affichage du séparateur de milliers, du séparateur décimal ou du symbole monétaire. Dans les colonnes de type String
, les masques d'affichage peuvent ajouter des espaces ou des caractères ne faisant pas partie réellement des données dans un souci de mise en forme. Ainsi, un numéro de téléphone stocké sous la forme 8314311000 peut s'afficher comme (831) 431-1000 en utilisant le masque d'affichage "(999) 999-9999" (sans les guillemets).
Le masque d'affichage est également utilisé pour analyser les saisies de l'utilisateur en convertissant la saisie, sous forme de chaîne, dans le type de données correct pour la colonne. Quand les saisies utilisateur ne peuvent pas être analysées en utilisant le masque d'affichage spécifié, l'utilisateur ne peut pas quitter la zone de saisie tant que les données ne sont pas correctement saisies. Vous pouvez afficher les messages de validation en ajoutant un composant JdbStatusLabel
à l'application et en le connectant au même StorageDataSet
que les données du contrôle orienté données (comme un contrôle JdbTable
). Pour effectuer une validation plus fine des caractères saisis (par exemple, une validation caractère par caractère), utilisez la propriété editMask
. Le masque de saisie utilise la même syntaxe que displayMask
, mais il sert uniquement à l'analyse des saisies de l'utilisateur et pas au formatage de l'affichage.
L'affectation explicite de la valeur null ou d'une chaîne vide à la propriété displayMask
oblige JBuilder à choisir une spécification de masque d'affichage. Si le type de données de la colonne a des aspect internationaux (de localisation), le fichier de localisation de la colonne est utilisé pour les paramètres d'affichage par défaut, par exemple pour le format de date ou le symbole monétaire. Sinon le formateur n'est pas pris en compte et un masque d'affichage élémentaire est utilisé.
Comme les masques d'affichage par défaut tiennent compte de la localisation et sont générés à la demande, ils s'adaptent automatiquement à la localisation. Les masque définis par l'utilisateur ne sont pas modifiés si la localisation de la colonne change.
Les masques de saisie et d'affichage ne se substituent jamais l'un à l'autre quand l'un est spécifié et pas l'autre. Néanmoins, si le masque de saisie n'est pas défini, le masque d'affichage effectue la validation des saisies de l'utilisateur.
La propriété displayMask
constitue un moyen simple de générer une instance d'un objet formateur
qui gère la manière d'afficher les données. Si le displayMask
ne suffit pas à vos besoins en formatage, vous pouvez créer une classe personnalisée qui implémente l'interface ItemFormatStr
et l'affecter directement à la propriété formatter
du composant Column
. Dans ce cas, vous ne devez pas initialiser la propriété displayMask
, car cela remplace votre formateur personnalisé.
Pour des exemples d'utilisation de modèles dans les masques d'affichage, voir Ajout de modèles d'affichage ou de modification pour le formatage des données dans le Guide du développeur d'applications de base de données
.
Voir aussi : editMask
, exportDisplayMask
, Modèles à base de chaînes (masques)
Entrez un modèle (masque) valide ou sélectionnez-le dans la liste des exemples de masque. Voir Masques exemples pour des détails sur des ressources spécifiant d'autres exemples de masque.
Propose une description du type d'information utilisant le modèle que vous définissez. Cette zone n'est pas obligatoire, mais si vous ajoutez le modèle à la liste Masques exemples, cette description simplifiera son utilisation ultérieure.
Choisissez ce bouton pour ajouter à la liste Masques exemples le masque et la description définis dans les zones Masque et Description.
Entrez des données exemple dans cette zone pour vérifier leur compatibilité avec le modèle sélectionné dans la zone Masque. Cliquez dans cette zone, entrez des données exemple puis appuyez sur Entrée. JBuilder tente de décomposer les données en utilisant le modèle sélectionné comme il le fait pour une colonne disposant d'un displayMask
mais pas d'un editMask
. Si une boîte de dialogue d'erreur apparaît, le modèle et les données saisies sont incompatibles. Un message d'erreur fréquent est "Caractères incorrects ou manquants dans le champ". Ce message apparaît, par exemple, dans un format de date nécessitant l'abréviation du nom de mois sur trois lettres si vous entrez un nombre ou une abréviation inconnue.
Si le modèle et les données sont compatibles, les données exemple sont formatées en fonction du modèle. Comme c'est le même format que celui utilisé pour la saisie, il n'y a aucune différence dans la zone une fois la saisie terminée. Dans une application, il est possible d'utiliser simultanément un editMask
et un displayMask
pour contrôler la saisie et la modification de données.
Cette zone propose des exemples de masque disponibles pour le type de données sélectionné.
Pour d'autres exemples de masque, voir Modèles à base de chaînes (masques) ou Ajout de modèles d'affichage ou de modification pour le formatage des données. Ces deux sections présentent des masques pour les modèles de données numériques, les modèles de données date et heure, les modèles de données texte, et les modèles de données booléennes.