Välj funktion
Gäller för: Arbetsyteappar Modellbaserade appar
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.
Välj målet OnSelect för senare bearbetning, vilket kan inträffa efter att den aktuella formeln har utvärderats. Välj gör inte att OnSelect-målenheten utvärderas omedelbart, och Välj väntar inte heller på att OnSelect ska 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
Välj( Kontroll )
- Kontroll – Obligatoriskt. Kontrollen att välja för användarens räkning.
Välj ( Kontroll, Rad eller kolumn, Underordnad kontroll )
- Kontroll – Obligatoriskt. Kontrollen att välja för användarens räkning.
- Rad eller kolumn – Obligatoriskt inte. Numret för raden eller kolumnen (börjar med 1) i en gallerikontroll som väljs för användarens räkning.
- Barnkontroll - 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
Lägg till en Button-kontroll och byt namn på den till Button1 om den har ett annat namn.
Ange egenskapen OnSelect för Button1 som denna formel:
Notify( "Hej världen" )
Lägg till en andra Button-kontroll på skärmen och ställ in OnSelect-egenskapen enligt följande formel:
Välj( Knapp1 )
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
Lägg till en lodrät Gallery-kontroll som innehåller andra kontroller.
Ange egenskapen OnSelect för galleriet enligt den här formeln:
Notify( "Galleri valt" )
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.
Ange egenskapen OnSelect för avbildningskontrollen enligt den här formeln:
Notify( "Bild vald", Framgång )
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.
Lägg till en Button-kontroll på skärmen och ställ in OnSelect-egenskapen enligt följande formel:
Välj( Galleri1,2,Bild1 )
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.