Classe Zone de liste modifiable

Les propriétés de la classe Zone de liste modifiable sont les suivantes :

Propriété

Explication

attributs

Cette propriété renvoie le contenu de la zone de liste modifiable. Pour vous aider à démarrer plus rapidement, elle est prédéfinie avec la liste des éléments que vous pouvez modifier. Si votre zone de liste modifiable est destinée à contenir une liste fixe d'éléments, mettez à jour la liste ici. Si la liste est dynamique et change en répondant aux différents événements cartographiques, elle doit être définie dans l'une des autres fonctions et doit être retirée de la fonction __init__.

editable

Cette propriété renvoie l'état de la zone de liste modifiable, dans laquelle elle est définie par défaut sur True. Lorsqu'elle est définie sur True, l'utilisateur peut saisir une nouvelle valeur qui n'est pas présente dans la liste des options. Lorsqu'elle est définie sur False, l'utilisateur peut uniquement choisir parmi les options fournies dans la zone de liste modifiable.

enabled

Cette propriété renvoie la disponibilité de la zone de liste modifiable, dans laquelle elle est définie par défaut sur True. Lorsqu'elle est définie sur False, la zone de liste modifiable est indisponible. Cette propriété permet d'écrire la logique destinée à tester l'état de l'application bureautique afin de désactiver ou d'activer la zone de liste modifiable. Vous pouvez, par exemple, avoir une zone de liste modifiable nécessitant qu'une couche de données soit chargée dans ArcMap pour être accessible.

dropdownWidth

Cette propriété définit la largeur de la zone déroulante de la zone de liste modifiable. La largeur de zone déroulante spécifiée permet de définir la longueur de cette zone déroulante. La valeur de largeur de la zone déroulante est représentée par un caractère, répété le nombre de fois voulu pour la longueur de la zone déroulante, car l'utilisateur la verra après avoir cliqué sur la flèche Bas dans la zone de liste modifiable.

width

Cette propriété définit la longueur de la zone de liste modifiable en utilisant n'importe quel caractère et en le répétant pour représenter le nombre de caractères visibles dans la zone de liste modifiable. Par exemple, pour que la zone de liste modifiable affiche cinq caractères, la propriété width doit avoir la valeur WWWWW.

valeur

Cette propriété obtient ou définit la valeur de la zone de liste modifiable. Une fois la valeur définie, utilisez la méthode Refresh() pour vous assurer qu'elle est visible dans la portion d'édition du contrôle.

Les fonctions de la classe Zone de liste modifiable sont les suivantes :

Fonction

Explication

__init__(self)

Se produit lorsque la zone de liste modifiable est initialisée par l'application bureautique. Cette fonction intégrée de Python est le constructeur dans lequel certaines variables initiales peuvent être initialisées. Par défaut, les propriétés items, editable et enabled de la zone de liste modifiable sont définies.

onSelChange(self, selection)

Se produit à chaque fois qu'une nouvelle sélection est réalisée dans la zone de liste modifiable. selection indique la valeur sélectionnée par l'utilisateur.

onEditChange(self, text)

Applicable uniquement lorsque la propriété editable est définie sur True et se produit à chaque fois qu'un nouveau caractère est saisi dans la zone de liste modifiable. text indique le texte en cours de saisie par l'utilisateur.

onFocus(self, focused)

Applicable uniquement lorsque la propriété editable est définie sur True. Se produit à chaque fois que la zone de liste modifiable obtient ou perd le focus. focused indique l'état de focus de la zone de liste modifiable. Il s'agit d'une valeur booléenne qui renvoie True lorsque la zone de liste modifiable possède le focus ou False dans le cas contraire.

onEnter(self)

Applicable uniquement lorsque la propriété editable est définie sur True. Se produit à chaque fois que l'utilisateur appuie sur la touche Entrée lors d'une saisie dans la zone de mise à jour de la zone de liste modifiable. Ceci vous permet d'attendre que l'utilisateur ait terminé d'entrer une valeur avant d'essayer de traiter votre logique commerciale en fonction de la valeur ajoutée.

Refresh(self)

Actualise la zone de liste modifiable après la définition d'une valeur. L'actualisation de la zone de liste modifiable permet de s'assurer que la valeur est visible dans la portion d'édition du contrôle.

Thèmes connexes

5/10/2014