Description


CheckBox représente une case à cocher qui peut être activée (cochée) ou désactivée (décochée). L'utilisateur peut cocher la case pour sélectionner l'option ou la décocher pour désélectionner l'option. Si nécessaire, le composant peut avoir trois états, tels que Activé, Désactivé et Grisé, pour ce faire, définissez la propriété du composant AllowGrayed sur True.



Class: TdbCheckBox



Propriétés

 Propriété

 Type

 Description

 sqlValue

 String

 Renvoie la valeur du composant, à utiliser dans les requêtes SQL. En cas de valeur vide, il renvoie une chaîne NULL
 Exemple: SQLExecute ('INSERT INTO tablename (fieldname) VALUES ('+Form1.CheckBox1.sqlValue+')');

 Alignment

 TAlignment

 Contrôle la position de la légende de la case à cocher. Valeurs disponibles : taRightJustify, taLeftJustify

 AllowGrayed

 Boolean

 Détermine si une case à cocher peut être dans un état grisé. Si AllowGrayed est défini sur True, la case à cocher a trois états possibles : sélectionné, désactivé et    grisé. Si AllowGrayed est défini sur False, la case à cocher n'a que deux états possibles : sélectionné et désactivé. Consultez la propriété State pour lire la valeur de  cbGrayed (grisé).

 CanFocus

 Boolean

  Vérifie si le composant peut obtenir le focus d'entrée, ce qui est généralement nécessaire avant d'utiliser la méthode SetFocus. Si un composant a la propriété       Visible = False ou Enabled = False, ou si le composant est situé sur un composant parent avec ces propriétés, l'utilisation de la méthode SetFocus provoquera une  erreur.

 Exemple: if Form1.CheckBox1.CanFocus then Form1.CheckBox1.SetFocus;

 Caption

 String

 Spécifie une chaîne de texte qui identifie le contrôle auprès de l'utilisateur.

 Checked

 Boolean

 Spécifie si le contrôle de bouton est coché. Si la propriété AllowGrayed est définie sur True, utilisez la propriété State pour lire la valeur de cbGrayed.

 Cursor

 TCursor

 Spécifie l'image utilisée pour représenter le pointeur de la souris lorsqu'il passe dans la région couverte par le contrôle. Plus d'info.

 dbTable

 String

 Détermine à quelle table de l base de données appartient un composant.

 dbField

 String

 Détermine à quel champ de la table de la base de données appartient ce composant.

 dbIncremSearch

 String

 Permet de spécifier le nom du bouton sur le formulaire courant avec l'action "Rechercher" ou "Requête SQL", qui sera automatiquement enfoncée lorsque              l'utilisateur change la valeur du composant. La propriété est nécessaire pour implémenter la recherche instantanée.

 Enabled

 Boolean

 Contrôle si le composant répond aux événements de la souris, du clavier et du minuteur.

 Focused

 Boolean

 Détermine si le contrôle reçoit le focus d'entrée.

 Font

 TFont

 Permet de définir le nom, la taille, la couleur et le style de la police. Plus d'info.

 Hint

 String

 Hint (astuce) contient la chaîne de texte qui apparaît lorsque l'utilisateur déplace la souris sur le composant., Voir aussi ShowHint

 Name

 String

 Le nom du composant..

 ShowHint

 Boolean

 Indique s'il faut afficher l'indicateur d'aide lorsque le pointeur de la souris se déplace sur le composant, voir aussi Hint.

 State

 TCheckBoxState

 Indique si la case à cocher est activée, désactivée ou grisée. Valeurs disponibles : cbChecked, cbUnchecked, cbGrayed

 TabOrder

 Integer

 Indique la position du composant dans l'ordre de tabulation de son parent. TabOrder est l'ordre dans lequel les composants enfants sont visités lorsque               l'utilisateur appuie sur la touche Tab. 

 TabStop

 Boolean

 Détermine si l'utilisateur peut accéder à un contrôle. Utilisez TabStop pour autoriser ou interdire l'accès au contrôle à l'aide de la touche Tab.

 Tag

 Integer

 Permet d'attribuer un numéro à un composant pour vos propres besoins.

 TagString

 String

 Permet d'attribuer une chaîne à un composant pour vos propres besoins.

 WordWrap

 Boolean

 Spécifie si le texte du bouton s'ajuste pour s'adapter à la largeur du contrôle.

 Visible

 Boolean

 Spécifie si le composant apparaît à l'écran.

 Left

 Integer

 Spécifie le coordonnée horizontal du bord gauche d'un composant par rapport à son parent.

 Top

 Integer

 Spécifie le coordonnée vertical de la partie supérieure gauche d'un composant par rapport à son parent.

 Width

 Integer

 Spécifie la taille horizontale du composant en pixels.

 Height

 Integer

 Spécifie la taille verticale du composant en pixels.





Méthodes

 Méthode

 Description

 procedure SetFocus

 Donne le focus d'entrée au composant.




Evènements

 Evènement

 Description

 OnClick

 Se produit lorsque l'utilisateur clique sur le composant.

 OnEnter

 Se produit lorsqu'un composant reçoit le focus.

 OnExit

 Se produit lorsque le focus se déplace d'un composant à un autre.

 OnKeyDown

 Se produit lorsqu'un utilisateur appuie sur une touche alors que le formulaire a le focus.

 OnKeyPress

 Se produit lorsqu'une touche est enfoncée. Notez que cette procédure ne gère que les caractères imprimables.

 OnKeyUp

 Se produit lorsque l'utilisateur relâche une touche qui a été enfoncée.

 OnMouseDown

 Se produit lorsque l'utilisateur appuie sur un bouton de la souris avec le pointeur sur un composant.

 OnMouseEnter

 Se produit lorsque l'utilisateur déplace la souris dans un composant.

 OnMouseLeave

 Se produit lorsque l'utilisateur déplace la souris en dehors d'un composant.

 OnMouseMove

 Se produit lorsque l'utilisateur déplace le pointeur de la souris alors que le pointeur se trouve sur un composant.

 OnMouseUp

 Se produit lorsque l'utilisateur relâche un bouton de la souris qui a été pressé avec le pointeur sur un composant.