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.
 Exemple: SQLExecute ('INSERT INTO tablename (fieldname) VALUES ('+Form1.ComboBox1.sqlValue+')');

 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;

 Color

 TColor

 Spécifie la couleur d'arrière-plan du contrôle. Plus d'info.

 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.

 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.

 Font

 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.

 Items

 TStringList

 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.

 OnDropFiles

 Se produit lorsque l'utilisateur essaie de faire glisser et déposer un fichier de l'explorateur vers un formulaire. Plus d'info.