Difference between revisions of "FR/Documentation/BASIC Guide/Properties"
(New page: {{FR/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=Documentation/BASIC Guide/Working With Dialogs |NextPage=Documentation/BASIC Guide/Events |dial=block ...) |
|||
Line 10: | Line 10: | ||
== Nom et titre == | == Nom et titre == | ||
− | Chaque élément de contrôle possède son propre nom et peut être interrogé à l'aide de la propriété de modèle | + | Chaque élément de contrôle possède son propre nom et peut être interrogé à l'aide de la propriété de modèle suivante : |
;<tt>Model.Name (String)</tt>:nom de l'élément de contrôle. | ;<tt>Model.Name (String)</tt>:nom de l'élément de contrôle. | ||
− | Vous pouvez spécifier le titre apparaissant dans la barre de titre d'une boîte de dialogue à l'aide de la propriété de modèle | + | Vous pouvez spécifier le titre apparaissant dans la barre de titre d'une boîte de dialogue à l'aide de la propriété de modèle suivante : |
;<tt>Model.Title (String)</tt>:titre de la boîte de dialogue (s'applique uniquement aux boîtes de dialogue). | ;<tt>Model.Title (String)</tt>:titre de la boîte de dialogue (s'applique uniquement aux boîtes de dialogue). | ||
Line 20: | Line 20: | ||
== Position et taille == | == Position et taille == | ||
− | Vous pouvez interroger la taille et la position d'un élément de contrôle à l'aide des propriétés suivantes de l'objet | + | Vous pouvez interroger la taille et la position d'un élément de contrôle à l'aide des propriétés suivantes de l'objet Model : |
;<tt>Model.Height (long)</tt>:hauteur de l'élément de contrôle (en unités ma). | ;<tt>Model.Height (long)</tt>:hauteur de l'élément de contrôle (en unités ma). | ||
Line 35: | Line 35: | ||
== Focus et séquence de tabulation == | == Focus et séquence de tabulation == | ||
− | Vous pouvez naviguer dans les éléments de contrôle des différentes boîtes de dialogue en appuyant sur la touche de tabulation. Les propriétés suivantes sont disponibles dans ce contexte dans le modèle des éléments de | + | Vous pouvez naviguer dans les éléments de contrôle des différentes boîtes de dialogue en appuyant sur la touche de tabulation. Les propriétés suivantes sont disponibles dans ce contexte dans le modèle des éléments de contrôle : |
;<tt>Model.Enabled (Boolean)</tt>:active l'élément de contrôle. | ;<tt>Model.Enabled (Boolean)</tt>:active l'élément de contrôle. | ||
Line 41: | Line 41: | ||
;<tt>Model.TabIndex (Long)</tt>:position de l'élément de contrôle dans l'ordre d'activation. | ;<tt>Model.TabIndex (Long)</tt>:position de l'élément de contrôle dans l'ordre d'activation. | ||
− | Enfin, l'élément de contrôle fournit une méthode <tt>getFocus</tt> permettant à l'élément de contrôle sous-jacent de recevoir le | + | Enfin, l'élément de contrôle fournit une méthode <tt>getFocus</tt> permettant à l'élément de contrôle sous-jacent de recevoir le focus : |
;<tt>getFocus</tt>:l'élément de contrôle reçoit le focus (uniquement pour les boîtes de dialogue). | ;<tt>getFocus</tt>:l'élément de contrôle reçoit le focus (uniquement pour les boîtes de dialogue). | ||
Line 51: | Line 51: | ||
La valeur <tt>Step</tt> (si elle définie sur 0) constitue un cas à part. Si vous définissez cette valeur sur zéro dans une boîte de dialogue, tous les éléments de contrôle sont visibles, quelle que soit leur valeur <tt>Step</tt>. De même, si vous définissez cette valeur sur zéro pour un élément de contrôle, celui-ci s'affiche sur tous les onglets d'une boîte de dialogue. | La valeur <tt>Step</tt> (si elle définie sur 0) constitue un cas à part. Si vous définissez cette valeur sur zéro dans une boîte de dialogue, tous les éléments de contrôle sont visibles, quelle que soit leur valeur <tt>Step</tt>. De même, si vous définissez cette valeur sur zéro pour un élément de contrôle, celui-ci s'affiche sur tous les onglets d'une boîte de dialogue. | ||
− | [[Image: | + | [[Image:FR-Documentation basicguide dlg 03-trans.gif|none|thumb|500px|Création du premier onglet de la boîte de dialogue]] |
Dans l'exemple ci-dessus, vous pouvez également assigner la valeur <tt>Step</tt> (définie sur 0) à la ligne de séparation, ainsi que les boutons <tt>Cancel</tt>, <tt>Prev</tt>, <tt>Next</tt> et <tt>Done</tt> pour afficher ces éléments sur tous les onglets. Vous pouvez également assigner ces éléments à un seul onglet (le premier, par exemple). | Dans l'exemple ci-dessus, vous pouvez également assigner la valeur <tt>Step</tt> (définie sur 0) à la ligne de séparation, ainsi que les boutons <tt>Cancel</tt>, <tt>Prev</tt>, <tt>Next</tt> et <tt>Done</tt> pour afficher ces éléments sur tous les onglets. Vous pouvez également assigner ces éléments à un seul onglet (le premier, par exemple). | ||
Line 85: | Line 85: | ||
</source> | </source> | ||
− | Une variable globale <tt>Dlg</tt> faisant référence à une boîte de dialogue ouverte doit être ajoutée pour que cet exemple fonctionne. La boîte de dialogue change ensuite d'apparence de la façon | + | Une variable globale <tt>Dlg</tt> faisant référence à une boîte de dialogue ouverte doit être ajoutée pour que cet exemple fonctionne. La boîte de dialogue change ensuite d'apparence de la façon suivante : |
− | [[Image: | + | [[Image:FR-Documentation basicguide dlg 05-trans.gif|none|thumb|400px|Premier onglet]] |
− | [[Image: | + | [[Image:FR-Documentation basicguide dlg 06-trans.gif|none|thumb|400px|Deuxième onglet]] |
{{PDL1}} | {{PDL1}} | ||
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Properties}} | {{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Properties}} |
Revision as of 20:48, 19 December 2008
Nom et titre
Chaque élément de contrôle possède son propre nom et peut être interrogé à l'aide de la propriété de modèle suivante :
- Model.Name (String)
- nom de l'élément de contrôle.
Vous pouvez spécifier le titre apparaissant dans la barre de titre d'une boîte de dialogue à l'aide de la propriété de modèle suivante :
- Model.Title (String)
- titre de la boîte de dialogue (s'applique uniquement aux boîtes de dialogue).
Position et taille
Vous pouvez interroger la taille et la position d'un élément de contrôle à l'aide des propriétés suivantes de l'objet Model :
- Model.Height (long)
- hauteur de l'élément de contrôle (en unités ma).
- Model.Width (long)
- largeur de l'élément de contrôle (en unités ma).
- Model.PositionX (long)
- position X de l'élément de contrôle, mesurée à partir de l'arête intérieure gauche de la boîte de dialogue (en unités ma).
- Model.PositionY (long)
- position Y de l'élément de contrôle, mesurée à partir de l'arête intérieure supérieure de la boîte de dialogue (en unités ma).
Pour que les boîtes de dialogue conservent la même apparence d'une plate-forme à l'autre, Apache OpenOffice utilise l'unité interne Map AppFont (ma) qui permet de spécifier la position et la taille des éléments au sein des boîtes de dialogue. Une unité ma correspond au huitième de la hauteur moyenne d'un caractère de la police système définie dans le système d'exploitation et au quart de sa largeur. En utilisant les unités ma, Apache OpenOffice garantit qu'une boîte de dialogue aura la même apparence quels que soient le système et les paramètres du système.
Si vous souhaitez modifier la taille ou la position des éléments de contrôle au moment de l'exécution, déterminez la taille totale de la boîte de dialogue et réglez les valeurs des éléments de contrôle sur les rapports des parties correspondants.
Focus et séquence de tabulation
Vous pouvez naviguer dans les éléments de contrôle des différentes boîtes de dialogue en appuyant sur la touche de tabulation. Les propriétés suivantes sont disponibles dans ce contexte dans le modèle des éléments de contrôle :
- Model.Enabled (Boolean)
- active l'élément de contrôle.
- Model.Tabstop (Boolean)
- permet d'atteindre l'élément de contrôle à l'aide de la touche de tabulation.
- Model.TabIndex (Long)
- position de l'élément de contrôle dans l'ordre d'activation.
Enfin, l'élément de contrôle fournit une méthode getFocus permettant à l'élément de contrôle sous-jacent de recevoir le focus :
- getFocus
- l'élément de contrôle reçoit le focus (uniquement pour les boîtes de dialogue).
Boîtes de dialogue à plusieurs onglets
Dans Apache OpenOffice, une boîte de dialogue peut posséder plusieurs onglets. La propriété Step d'une boîte de dialogue définit l'onglet actif, tandis que la propriété Step d'un élément de contrôle spécifie l'onglet dans laquelle il doit s'afficher.
La valeur Step (si elle définie sur 0) constitue un cas à part. Si vous définissez cette valeur sur zéro dans une boîte de dialogue, tous les éléments de contrôle sont visibles, quelle que soit leur valeur Step. De même, si vous définissez cette valeur sur zéro pour un élément de contrôle, celui-ci s'affiche sur tous les onglets d'une boîte de dialogue.
Dans l'exemple ci-dessus, vous pouvez également assigner la valeur Step (définie sur 0) à la ligne de séparation, ainsi que les boutons Cancel, Prev, Next et Done pour afficher ces éléments sur tous les onglets. Vous pouvez également assigner ces éléments à un seul onglet (le premier, par exemple).
Le code suivant augmente et réduit la valeur Step des gestionnaires d'événements des boutons Next et Prev et modifie le statut de ces boutons.
Sub cmdNext_Initiated Dim cmdNext As Object Dim cmdPrev As Object cmdPrev = Dlg.getControl("cmdPrev") cmdNext = Dlg.getControl("cmdNext") cmdPrev.Model.Enabled = Not cmdPrev.Model.Enabled cmdNext.Model.Enabled = False Dlg.Model.Step = Dlg.Model.Step + 1 End Sub Sub cmdPrev_Initiated Dim cmdNext As Object Dim cmdPrev As Object cmdPrev = Dlg.getControl("cmdPrev") cmdNext = Dlg.getControl("cmdNext") cmdPrev.Model.Enabled = False cmdNext.Model.Enabled = True Dlg.Model.Step = Dlg.Model.Step - 1 End Sub
Une variable globale Dlg faisant référence à une boîte de dialogue ouverte doit être ajoutée pour que cet exemple fonctionne. La boîte de dialogue change ensuite d'apparence de la façon suivante :
Content on this page is licensed under the Public Documentation License (PDL). |