Välj funktion

Gäller appar: Arbetsyteappar Modellbaserade program

Simulerar en Select-åtgärd på en kontroll som orsakar att formeln OnSelect utvärderas.

Beskrivning

Funktionen Select simulerar en Välj-åtgärd på en kontroll som om användaren hade klickat på eller tryckt på kontrollen. Därigenom kan formeln OnSelect på målkontrollen utvärderas.

Använd Select för att sprida en Select-åtgärd till en överordnad kontroll. Den här typen av spridning används som standard i till exempel gallerier. Som standard ställs OnSelect-egenskapen för en kontroll i Gallery-kontrollen in till Select (överordnad). På så sätt kan du ange värdet för OnSelect-egenskapen för galleriet till att styra sig själv och formeln utvärderas oavsett var i galleriet en användare klickar eller trycker.

Om du vill att en eller flera kontroller i galleriet ska utföra olika åtgärder från galleriet själva, anger du OnSelect-egenskapen för dessa kontroller till något annat än standardvärdet. Du kan lämna standardvärdena för OnSelect-egenskaperna för de flesta kontroller i galleriet om du vill att de ska utföra samma åtgärd som galleriet.

Select köar målet OnSelect för senare bearbetning, vilket kan inträffa när den aktuella formeln är färdigutvärderad. Select gör inte att målet OnSelect utvärderas omedelbart, inte heller väntar Select på att OnSelect ska sluta utvärderas.

Du kan inte använda Select över olika skärmar.

Du bara kan använda Select med kontroller som har en OnSelect-egenskap.

Du kan endast använda Select i beteendeformler.

En kontroll kan inte göras till Select av sig själv direkt eller indirekt via andra kontroller.

Funktionen Select kan också användas med ett galleri. Du kan till exempel använda funktionen för att ange vilken rad eller kolumn som ska markeras i ett galleri och vilken kontroll som ska markeras på den raden eller kolumnen i galleriet. Gallerivalet ändras och OnSelect-formeln i gallerikontrollen utvärderas när du markerar en rad eller kolumn. Om en kontroll har angetts på raden eller kolumnen utvärderas OnSelect-formeln för den underordnade kontrollen.

Syntax

Select( Control )

• Control – krävs. Kontrollen att välja för användarens räkning.

Select( Control, Row or column, Child Control )

• Control – krävs. Kontrollen att välja för användarens räkning.
• Row or column – krävs inte. Numret för raden eller kolumnen (börjar med 1) i en gallerikontroll som väljs för användarens räkning.
• Child Control – krävs inte. Den underordnade kontrollen till den kontroll som identifieras i ”control”-parametern som väljs.

Exempel

• Knapp

  Select(button1)

• Galleri

  Select(Gallery1, 1)

  Simulerar en användare som markerar rad 1 eller kolumn 1 i Gallery1.

• Galleri

  Select(Gallery1, 1, ChildControl1)

  Simulerar en användare som markerar ChildConttrol1 i rad 1 eller kolumn 1 i Gallery1.

Grundläggande användning

1. Lägg till en Button-kontroll och byt namn på den till Button1 om den har ett annat namn.

2. Ange egenskapen OnSelect för Button1 som denna formel:

   Notify( "Hello World" )

3. Lägg till en andra Button-kontroll på skärmen och ställ in OnSelect-egenskapen enligt följande formel:

   Select( Button1 )

4. Välj den andra knappen medan du håller ner Alt-knappen.

   Ett meddelande visas längst upp i ditt program. OnSelect-egenskapen för Button1 genereras av det här meddelandet.

   

Gallery-kontrollen

1. Lägg till en lodrät Gallery-kontroll som innehåller andra kontroller.

   

2. Ange egenskapen OnSelect för galleriet enligt den här formeln:

   Notify( "Gallery Selected" )

3. Håll ned Alt-tangenten och klicka eller tryck på bakgrunden i galleriet eller någon kontroll i galleriet.

   Visar alla åtgärder i Galleri valt-meddelandet längst upp i programmet.

   Använd galleriets OnSelect-egenskap för att ange standardåtgärd att vidta när användaren klickar eller trycker på ett objekt i galleriet.

4. Ange egenskapen OnSelect för avbildningskontrollen enligt den här formeln:

   Notify( "Image Selected", Success )

5. Håll ned Alt-tangenten och klicka eller tryck på de olika elementen i galleriet.

   När du klickar eller pekar på alla kontroller i galleriet utom avbildningen, visas Galleri valt som tidigare. När du klickar eller pekar på avbildningen, visas Avbildning vald.

   Använd enskilda kontroller i galleriet för att vidta åtgärder som skiljer sig från galleriets standardåtgärd.

   

6. Lägg till en Button-kontroll på skärmen och ställ in OnSelect-egenskapen enligt följande formel:

   Select( Gallery1,2,Image1 )

7. När du håller ned Alt-tangenten, välj knappen.

   Ett Avbildning vald-meddelande visas längst upp i ditt program. Knappklicket som simuleras när bilden väljs på rad 2 i galleriet.