Sélectionner une fonction

S’applique à : Applications canevas Applications pilotées par modèle

Simule une action de sélection sur un contrôle, ce qui entraîne l’évaluation de la formule OnSelect.

Description

La fonction Select simule une action de sélection sur un contrôle comme si l’utilisateur avait cliqué ou appuyé sur ce contrôle. La formule OnSelect sur le contrôle cible est alors évaluée.

Utilisez Select pour propager une action de sélection à un contrôle parent. Ce type de propagation est le comportement par défaut dans les galeries, par exemple. Par défaut, la propriété OnSelect d’un contrôle dans un contrôle Gallery est définie sur Select(Parent). Vous pouvez ainsi définir la valeur de la propriété OnSelect du contrôle Gallery même, et cette formule est évaluée peu importe où l’utilisateur clique ou appuie dans la galerie.

Si vous souhaitez qu’un ou plusieurs contrôles de la galerie effectuent différentes actions directement depuis cette dernière, définissez la propriété OnSelect pour ces contrôles sur une valeur autre que la valeur par défaut. Vous pouvez conserver les valeurs par défaut des propriétés OnSelect de la plupart des contrôles de la galerie si vous souhaitez qu’ils effectuent la même action que la galerie.

Select met la cible OnSelect dans une file d’attente pour un traitement ultérieur, qui peut avoir lieu après que la formule actuelle ait été évaluée. Select n’entraîne pas d’évaluation immédiate de la cible OnSelect. Select n’attend pas non plus la fin de l’évaluation de la propriété OnSelect.

Vous ne pouvez pas utiliser Select entre les écrans.

Vous ne pouvez utiliser Select qu’avec des contrôles dotés d’une propriété OnSelect.

Vous ne pouvez utiliser Select que dans des formules de comportement.

Un contrôle ne peut pas se sélectionner lui-même, directement ou indirectement, par le biais d’autres contrôles.

La fonction Select peut être également utilisée avec une galerie. Par exemple, elle peut être utilisée pour spécifier la ligne ou la colonne à sélectionner dans une galerie, et le contrôle à sélectionner dans cette ligne ou colonne de la galerie. Quand vous sélectionnez une ligne ou une colonne, la sélection de la galerie change et la formule OnSelect sur le contrôle Gallery est évaluée. Si un contrôle de la ligne ou de la colonne est fourni, la formule OnSelect pour le contrôle enfant est évaluée.

Syntaxe

Select( Contrôle )

• Control : obligatoire. Contrôle pour sélectionner au nom de l’utilisateur.

Select( contrôle, ligne ou colonne, contrôle enfant )

• Control : obligatoire. Contrôle pour sélectionner au nom de l’utilisateur.
• Ligne ou colonne : non obligatoire. Numéro de ligne ou de colonne (en commençant à 1) dans un contrôle Gallery à sélectionner pour le compte de l’utilisateur.
• Contrôle enfant : non obligatoire. Contrôle enfant du contrôle identifié dans le paramètre « Control » à sélectionner.

Exemples

• Bouton

  Select(button1)

• Galerie

  Select(Gallery1, 1)

  Simule un utilisateur sélectionnant la ligne 1 ou la colonne 1 dans Gallery1.

• Galerie

  Select(Gallery1, 1, ChildControl1)

  Simule un utilisateur sélectionnant ChildConttrol1 dans la ligne 1 ou la colonne 1 de Gallery1.

Utilisation de base

1. Ajoutez un contrôle Button et renommez-le Button1 s’il porte un autre nom.

2. Définissez la propriété OnSelect de Button1 sur la formule suivante :

   Notify( "Hello World" )

3. Sur le même écran, ajoutez un deuxième contrôle Button et définissez sa propriété OnSelect sur la formule suivante :

   Select( Button1 )

4. Tout en maintenant la touche Alt enfoncée, sélectionnez le second bouton.

   Une notification s’affiche en haut de votre application. La propriété OnSelect de Button1 a généré cette notification.

   

Contrôle Gallery

1. Ajouter un contrôle Gallery verticale qui contient d’autres contrôles.

   

2. Définissez la propriété OnSelect de la galerie sur la formule suivante :

   Notify( "Gallery Selected" )

3. Tout en maintenant la touche Alt enfoncée, cliquez ou appuyez sur l’arrière-plan de la galerie, ou sur n’importe quel contrôle dans cette dernière.

   Toutes les actions affichent la notification Galerie sélectionnée en haut de l’application.

   Utilisez la propriété OnSelect de la galerie pour spécifier l’action par défaut à effectuer lorsque l’utilisateur clique ou appuie sur un élément de la galerie.

4. Définissez la propriété OnSelect du contrôle Image sur la formule suivante :

   Notify( "Image Selected", Success )

5. Tout en maintenant la touche Alt enfoncée, cliquez ou appuyez sur les différents éléments de la galerie.

   Lorsque vous cliquez ou appuyez sur un contrôle de la galerie, exception faite de l’image, Galerie sélectionnée s’affiche, comme c’est le cas plus haut. Lorsque vous cliquez ou appuyez sur l’image, Image sélectionnée s’affiche.

   Utilisez des contrôles individuels dans la galerie pour effectuer des actions qui diffèrent de l’action par défaut de la galerie.

   

6. Sur le même écran, ajoutez un contrôle Button et définissez sa propriété OnSelect sur la formule suivante :

   Select( Gallery1,2,Image1 )

7. Cliquez sur le bouton tout en maintenant la touche Alt enfoncée.

   Une notification Image sélectionnée apparaît en haut de votre application. Le clic sur le bouton a simulé la sélection de l’image dans la ligne 2 de la galerie.