Les objets sont les blocs de construction fondamentaux de Visual Basic. Pratiquement tout ce que vous faites dans Visual Basic implique la modification d'objets. Chaque élément FlexPro (bases de données, graphiques, tableaux, documents, ensembles de données, etc.) peut être représenté par un objet Visual Basic.

Que sont les objets et les collections ?

Un objet représente un élément FlexPro, tel qu'une base de données, un graphique ou une courbe individuelle dans un graphique. Une collection est un objet contenant plusieurs autres objets qui sont généralement de même nature. Toutes les courbes d'un graphique, par exemple, sont contenues dans un seul objet de collection. Grâce aux propriétés et aux méthodes, vous pouvez modifier un objet individuel ou toute une collection d'objets.

Qu'est-ce qu'une propriété ?

Une propriété est un attribut d'un objet ou un aspect de son comportement. Par exemple, les propriétés d'un graphique comprennent son nom, l'apparence de la grille de division et l'activation ou non des curseurs. Pour modifier les caractéristiques d'un objet, vous devez changer les valeurs de ses propriétés.

Pour spécifier la valeur d'une propriété, il faut d'abord référencer l'objet, puis saisir un point, le nom de la propriété, un signe égal et la nouvelle valeur de la propriété. Dans l'exemple suivant, un nouveau commentaire est attribué au dossier racine de la base de données MyDatabase.

Databases("MyDatabase.fpd").RootFolder.Comments = "Ma base de données"

Dans cet exemple, Bases de données fait référence à la collection de bases de données ouvertes. Le nom MyDatabase.fpd identifie une seule base de données dans la collection. La propriété Comments s'applique spécifiquement au dossier racine de cette base de données.

Certaines propriétés ne peuvent pas être définies. La rubrique d'aide d'une propriété précise si cette propriété peut être définie (accès en lecture/écriture) ou si elle ne peut être que lue (accès en lecture seule).

Vous pouvez obtenir des informations sur un objet en appelant la valeur d'une de ses propriétés afin qu'elle soit retournée. Dans l'exemple suivant, le nom de la base de données active est renvoyé.

databaseName = ActiveDatabase.Name

Dans cet exemple, ActiveDatabase fait référence à la base de données de la fenêtre active de FlexPro. Le nom de cette base de données est attribué à la variable databaseName.

Remarque :   La rubrique d'aide d'une propriété précise si vous pouvez définir cette propriété (accès en écriture-lecture), la lire uniquement (accès en lecture seule) ou y écrire uniquement (accès en écriture seule). Le navigateur d'objets dans l'éditeur Visual Basic affiche également l'état de lecture/écriture au bas de la fenêtre du navigateur lorsque la propriété est sélectionnée.

Qu'est-ce qu'une méthode ?

Une méthode est une action qui peut être exécutée par un objet. Par exemple, comme un document FlexPro peut être imprimé, l'objet Document comporte également une méthode PrintOut. Les méthodes ont souvent des arguments qui définissent plus clairement la manière dont l'action doit être exécutée. Dans l'exemple suivant, les trois premières pages du document actif sont imprimées.

ActiveDatabase.ActiveObject.PrintOut FirstPage:=1, LastPage:=3

Dans la plupart des cas, les méthodes sont des actions et les propriétés des caractéristiques. L'utilisation d'une méthode signifie que quelque chose arrive à un objet, tandis que l'utilisation d'une propriété renvoie des informations sur l'objet ou provoque la modification d'un attribut de l'objet.

Renvoyer un objet

La plupart des objets sont renvoyés en retournant un objet individuel à partir d'une collection. La collection Bases de données, par exemple, contient les bases de données FlexPro ouvertes. Utilisez la propriété Databases de l'objet Application (l'objet le plus haut dans la hiérarchie des objets FlexPro) pour renvoyer la collection Databases.

Une fois que vous avez accédé à la collection, vous pouvez renvoyer un objet individuel en spécifiant une valeur d'index entre parenthèses (comme avec les tableaux). La valeur de l'index est généralement un nombre ou un nom.

Dans l'exemple suivant, la propriété Databases est utilisée pour accéder à la collection Databases. Le numéro d'index est utilisé pour renvoyer la première base de données de la collection Bases de données. La méthode Close est ensuite appliquée à l'objet Database pour fermer la première base de données de la collection Databases.

Bases de données(1).Fermer

Dans l'exemple suivant, un nom (spécifié comme une chaîne) est utilisé pour identifier un objet Database dans la collection Databases.

Databases("Report.fpd").Close

Les objets de collection possèdent souvent des méthodes et des propriétés qui peuvent être utilisées pour modifier la collection complète d'objets. L'objet Databases possède une méthode Save qui enregistre tous les documents de la collection. Dans l'exemple suivant, les documents ouverts sont enregistrés à l'aide de la méthode Enregistrer.

Bases de données.Save

L'objet Base de données comporte également une méthode d'enregistrement permettant de sauvegarder une base de données individuelle. Dans l'exemple suivant, la base de données Report.fpd est enregistrée.

Databases("Report.fpd").Save

Si un objet situé plus bas dans le modèle d'objet FlexPro doit être renvoyé, vous devez "descendre" jusqu'à cet objet en utilisant des propriétés et des méthodes qui renvoient des objets.

Pour voir comment cela fonctionne, ouvrez l'éditeur Visual Basic et dans le menu View, cliquez sur Object Browser. Dans la liste des classes à gauche, cliquez sur Application. Dans la liste des membres à droite, cliquez sur ActiveDatabase. Le texte au bas du navigateur d'objets montre que ActiveDatabase est une propriété en lecture seule qui renvoie un objet Database. Au bas du navigateur d'objets, cliquez sur Database. L'objet Database est alors automatiquement sélectionné dans la liste Classes et la liste Members affiche les membres de l'objet Database. Faites défiler la liste des membres jusqu'à ce que vous trouviez Close. Cliquez sur la méthode de fermeture. Le texte au bas de la fenêtre du navigateur d'objets indique la syntaxe de la méthode. Pour plus d'informations sur cette méthode, appuyez sur la touche F1 ou cliquez sur le bouton Aide et accédez à la rubrique d'aide couvrant la méthode de fermeture.

En tirant parti de ces informations, vous pouvez écrire l'instruction suivante pour fermer la base de données active.

ActiveDatabase.Close SaveChanges:=fpSaveChanges

Dans l'exemple suivant, le titre de la fenêtre active est modifié.

ActiveDatabase.ActiveWindow.Caption = "My Window" (Ma fenêtre)

La propriété ActiveWindow renvoie un objet Window qui affiche la fenêtre active. Utilisez la propriété Caption pour spécifier le titre de la fenêtre.

Dans l'exemple suivant, une nouvelle base de données est créée et la boîte de dialogue Enregistrer sous apparaît pour permettre de donner un nom à la base de données.

Bases de données.Add.Save

La propriété Databases renvoie une collection Databases. La méthode Add crée une nouvelle base de données et renvoie un objet Database. La méthode Save est ensuite appliquée à l'objet Database.

Comme vous pouvez le constater, les méthodes et les propriétés sont utilisées pour accéder à un objet. Cela signifie que vous retournez un objet en appliquant une méthode à un objet de niveau supérieur dans la hiérarchie des objets ou en accédant à une propriété. Une fois que vous avez retourné l'objet requis, vous pouvez utiliser les méthodes de cet objet et contrôler ses propriétés. Pour une vue d'ensemble de la hiérarchie des objets, consultez le modèle d'objet FlexPro.

Comment obtenir de l'aide sur les objets, les méthodes et les propriétés ?

Jusqu'à ce que vous soyez familiarisé avec le modèle d'objet FlexPro, vous pouvez utiliser quelques ressources qui vous aideront à descendre dans la hiérarchie.

•Membres de la liste automatiquement. La saisie d'un point (.) après un objet dans l'éditeur Visual Basic affiche une liste des propriétés et méthodes disponibles. Si, par exemple, vous saisissez Application, une liste déroulante des méthodes et des propriétés de l'objet Application apparaît.

•Aide. Vous pouvez également utiliser l'aide pour savoir quelles propriétés et méthodes peuvent être utilisées pour un objet. Chaque rubrique d'objet de l'aide contient des sections sur les propriétés et les méthodes, qui répertorient les propriétés et les méthodes de l'objet. Dans le navigateur d'objets ou dans un module, appuyez sur F1 pour accéder à la rubrique d'aide correspondante.

•Modèle d'objet FlexPro. Cette rubrique explique comment les objets FlexPro sont disposés dans la hiérarchie. Cliquez sur un objet dans l'image pour afficher la rubrique d'aide correspondante.

•Navigateur d'objets. Le navigateur d'objets de l'éditeur Visual Basic affiche les membres (propriétés et méthodes) des objets FlexPro.