Select functie

Van toepassing op: Canvas-apps

Met deze functie simuleert u een select-actie op een besturingselement, waardoor de formule OnSelect wordt geëvalueerd.

Beschrijving

De Select functie simuleert een selectactie op een besturingselement alsof de gebruiker op het besturingselement heeft geklikt of getikt. Als gevolg hiervan wordt de formule OnSelect voor het doelbesturingselement geëvalueerd.

Gebruik Select deze optie om een selectieactie door te geven aan een bovenliggend besturingselement. Deze manier van doorgeven is de standaardinstelling in bijvoorbeeld galerieën. De eigenschap OnSelect van een besturingselement in een galeriebesturingselement is standaard ingesteld op Select(bovenliggend) besturingselement. Op die manier kunt u de waarde van de eigenschap OnSelect van het besturingselement in de galerie zelf instellen. Daarna wordt die formule geëvalueerd ongeacht waar in de galerie een gebruiker klikt of tikt.

Als een of meer besturingselementen in de galerie verschillende acties moeten uitvoeren vanuit de galerie zelf, stelt u de eigenschap OnSelect voor deze besturingselementen in op iets anders dan de standaardwaarde. Voor de meeste besturingselementen in de galerie kunt u de standaardwaarden voor de eigenschap OnSelect ongewijzigd laten, als ze dezelfde actie moeten uitvoeren als de galerie zelf.

Select hiermee wordt het doel OnSelect in de wachtrij geplaatst voor latere verwerking. Dit kan gebeuren nadat de huidige formule is geëvalueerd. Select zorgt er niet voor dat het doel OnSelect onmiddellijk wordt geëvalueerd en niet Select wacht tot OnSelect is geëvalueerd.

U kunt niet op meerdere schermen gebruiken Select .

U kunt alleen gebruiken Select met besturingselementen met een eigenschap OnSelect .

U kunt alleen gebruiken Select in gedragsformules.

Een besturingselement kan zichzelf niet Select direct of indirect via andere besturingselementen.

De functie Select kan ook worden gebruikt voor een galerie. De functie kan bijvoorbeeld worden gebruikt om de rij of kolom op te geven die moet worden geselecteerd in een galerie en het besturingselement dat moet worden geselecteerd in die rij of kolom van de galerie. Wanneer u een rij of kolom selecteert, wordt de galerieselectie gewijzigd en wordt de formule OnSelect in het galeriebesturingselement geëvalueerd. Als een besturingselement is opgegeven in de rij of kolom, wordt de formule OnSelect voor het onderliggende besturingselement geëvalueerd.

Syntaxis

Select( Besturingselement )

• Controle – Vereist. Het besturingselement dat moet worden geselecteerd namens de gebruiker.

Select( Besturingselement, Rij of kolom, Onderliggend besturingselement )

• Controle – Vereist. Het besturingselement dat moet worden geselecteerd namens de gebruiker.
• Rij of kolom – Niet vereist. Het aantal rijen of kolommen (te beginnen met 1) in een galeriebesturingselement dat moet worden geselecteerd namens de gebruiker.
• onderliggend Besturingselement - Niet vereist. Het te selecteren onderliggende besturingselement van het besturingselement dat in de parameter besturingselement wordt aangegeven.

Voorbeelden

• Knop

  Select(button1)

• Galerij

  Select(Gallery1, 1)

  Simuleert een gebruiker die rij 1 of kolom 1 in Gallery1 selecteert.

• Galerij

  Select(Gallery1, 1, ChildControl1)

  Simuleert een gebruiker die ChildControl1 in rij 1 of kolom 1 van Gallery1 selecteert.

Basaal gebruik

1. Voeg een besturingselement van het type Button toe en geef dit de naam Button1 als het een andere naam heeft.

2. Stel de eigenschap OnSelect van Button1 in op deze formule:

   Melden ("Hallo wereld")

3. Voeg op hetzelfde scherm een tweede besturingselement Button toe en stel de eigenschap OnSelect van dit element in op deze formule:

   Select( Knop1 )

4. Houd de Alt-toets ingedrukt en selecteer de tweede knop.

   U ziet bovenin de app een melding. Deze melding is gegenereerd door de eigenschap OnSelect van Button1.

   

Besturingselement Gallery

1. Voeg een verticaal besturingselement Gallery toe dat andere besturingselementen bevat.

   

2. Stel de eigenschap OnSelect van de galerie in op deze formule:

   Melden( "Galerij geselecteerd" )

3. Klik of tik met de Alt-toets ingedrukt op de achtergrond van de galerie of een besturingselement in de galerie.

   In alle gevallen ziet u de melding Gallery geselecteerd bovenaan de app.

   Gebruik de eigenschap OnSelect van de galerie om de standaardactie op te geven die moet worden uitgevoerd wanneer de gebruiker op een item in de galerie klikt of tikt.

4. Stel de eigenschap OnSelect van het besturingselement Image in op deze formule:

   Notify( "Image Selected", NotificationType.Success )

5. Houd de Alt-toets ingedrukt en klik of tik op de verschillende elementen van de galerie.

   Wanneer u op een besturingselement in de galerie klikt of tikt buiten de afbeelding, wordt Gallery geselecteerd gewoon weergegeven. Wanneer u echter op de afbeelding klikt of tikt, wordt Image Selected weergegeven.

   Gebruik afzonderlijke besturingselementen in de galerie om acties uit te voeren die anders zijn dan de standaardactie van de galerie.

   

6. Voeg op hetzelfde scherm een besturingselement Button toe en stel de eigenschap OnSelect van dit element in op deze formule:

   Select( Gallery1,2,Image1 )

7. Selecteer de knop terwijl u de Alt-toets ingedrukt houdt.

   Boven in de app wordt de melding Image Selected weergegeven. Met het klikken op de knop is gesimuleerd dat de afbeelding in rij 2 van de galerie werd geselecteerd.