ComboBox
Description
Le composant est utilisé pour afficher/sélectionner l'enregistrement.
Class: TdbComboBox
Propriétés
Propriété |
Type |
Description |
sqlValue |
String |
Renvoie l'ID de l'enregistrement sélectionné dans le composant, à utiliser dans les requêtes SQL. En cas de valeur vide, il renvoie une chaîne NULL. |
dbItemID |
Integer |
L'identifiant de l'enregistrement sélectionné dans le composant. L'identifiant correspond au champ id dans la base de données. Si aucune entrée n'est sélectionnée, renvoie -1 |
dbSortField |
String |
Le champ de base de données par lequel les enregistrements du composant seront triés. |
dbSortAsc |
Boolean |
Si True, les enregistrements seront triés par ordre croissant, sinon par ordre décroissant. |
dbFilter |
String |
Permet de définir un filtre supplémentaire qui sera utilisé pour remplir le composant avec les données de la base de données. Par exemple : tablename.fieldname = 1 |
dbForeignKey |
String |
Spécifie à quelle clé externe de la table de base de données appartient ce 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. |
dbSQL |
String |
Contient la requête SQL qui a été utilisée lors de l'appel de la méthode SQLExecute. |
CanFocus |
Boolean |
Vérifie si le composant peut obtenir le focus, 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.ComboBox1.CanFocus then Form1.ComboBox1.SetFocus; |
TColor |
Spécifie la couleur d'arrière-plan du contrôle. Plus d'info. |
|
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. |
|
DroppedDown |
Boolean |
Indique si la liste déroulante est actuellement affiché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 a le focu. |
TFont |
Permet de définir le nom, la taille, la couleur et le style de la police. Plus d'info. |
|
GetCount |
Integer |
Permet d'obtenir le nombre d'enregistrements dans un composant. |
HideTextIfNotExists |
Boolean |
A du sens si la propriété Searchable = True. Définissez HideTextIfNotExists = False, afin que le texte saisi ne disparaisse pas s'il n'est pas trouvé parmi les enregistrements. |
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 |
ItemIndex |
Integer |
Spécifie l'index de l'élément sélectionné. Le premier élément de la liste a l'index 0, le deuxième élément a l'index 1, et ainsi de suite. Si aucun élément n'est sélectionné, la valeur de ItemIndex est -1. |
Donne accès à la liste des éléments (chaînes) dans la partie liste de la zone de liste déroulante. Plus d'info. |
||
Items[i] |
String |
Accès ligne par ligne à la liste des enregistrements. Exemple: ShowMessage (Form1.ComboBox1.Items [1]); // affichera un message avec la deuxième ligne (numérotation à partir de zéro) |
ItemsChecked[i] |
Boolean |
A du sens si la propriété MultiSelect = True, permet de lire ou de cocher la case à côté de l'enregistrement. |
MultiSelect |
Boolean |
Permet la sélection multiple d'enregistrements dans le composant. S'applique lors de l'utilisation du bouton avec l'action "Rechercher" ou un script. |
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 Astuce. |
SearchableType |
TSearchType' |
A du sens si la propriété Searchable = True. Type de recherche. Valeurs: stExact - recherche une correspondance complète, stContain - recherche une sous-chaîne dans une chaîne. |
SelectedCount |
Integer |
A du sens si la propriété MultiSelect = True. Renvoie le nombre d'enregistrements sélectionnés dans le composant. |
SelLength |
Integer |
Spécifie la longueur, en caractères, du texte sélectionné dans la partie d'édition de la zone de liste déroulante. |
SelStart |
Integer |
Spécifie la position du premier caractère sélectionné dans la partie d'édition de la zone de liste déroulante. |
Sorted |
Boolean |
Détermine si les enregistrements du composant seront triés. Par défaut, le tri est effectué sur le champ de base de données spécifié dans la propriété dbField, vous pouvez modifier le champ à utiliser pour le tri à l'aide de la propriété dbSortField. Vous pouvez définir le type de tri dans la propriété dbSortAsc. |
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. |
Text |
String |
Contient une chaîne de texte associée au composant. |
TextHint |
String |
Spécifie le texte affiché sous forme de filigrane de texte dans la zone d'édition du contrôle de zone de liste déroulante. |
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 dbAddRecord (id: integer; text: string) |
Ajoute un enregistrement au composant et lui attribue l'ID spécifié. L'enregistrement ne sera pas ajouté à la base de données. |
procedure dbEditRecord (id: integer; text: string) |
Modifie l'enregistrement dans le composant avec l'ID spécifié. L'enregistrement de la base de données ne sera pas modifié. |
procedure dbDeleteRecord (id: integer) |
Supprime l'enregistrement du composant avec l'ID spécifié. L'enregistrement ne sera pas supprimé de la base de données. |
function dbGetFieldValue (FieldName: string): variant |
La fonction permet d'obtenir la valeur du champ spécifié à partir de la base de données pour l'enregistrement sélectionné dans le composant. Si aucun enregistrement n'est sélectionné dans le composant, la fonction renvoie 'Non attribué'. |
function dbIndexToID (index: integer): integer |
La fonction permet d'obtenir l'identifiant d'un enregistrement en spécifiant son numéro de séquence dans la liste. |
procedure dbSQLExecute (sql: string) |
La procédure permet de remplir un composant avec des données de la base de données à l'aide d'une requête SQL. La requête SQL spécifiée sera enregistrée dans la propriété dbSQL. |
procedure dbUpdate |
Force la mise à jour des données du composant. Habituellement, le composant met à jour les données automatiquement si les données ont été modifiées. |
procedure Clear |
Efface le contenu du composant. |
procedure DoOnChange |
Exécute de force l'événement OnChange s'il a été défini pour un composant. |
procedure SetAllCheckBoxes (const Checked: boolean) |
A du sens si la propriété MultiSelect = True. Modifie l'état de la case à cocher pour chaque enregistrement. |
procedure SetFocus |
Donne le focus au composant. |
Evènements
Evènement |
Description |
OnChange |
Se produit lorsque l'utilisateur modifie le texte affiché dans la zone d'édition. |
OnClick |
Se produit lorsque l'utilisateur clique sur le composant. |
OnCloseUp |
Se produit lorsque la liste déroulante se ferme en raison d'une action de l'utilisateur. |
OnDoubleClick |
Se produit lorsque l'utilisateur double-clique le bouton gauche de la souris lorsque le pointeur se trouve sur le composant. |
OnDropDown |
Se produit lorsque la liste déroulante se ferme en raison d'une action de l'utilisateur. |
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. |
OnMouseEnter |
Se produit lorsque l'utilisateur déplace la souris sur un composant. |
OnMouseLeave |
Se produit lorsque l'utilisateur déplace la souris en dehors d'un composant. |
Se produit lorsque l'utilisateur essaie de faire glisser et déposer un fichier de l'explorateur vers un formulaire. Plus d'info. |