Functie selecteren

Van toepassing op: Canvas-apps Modelgestuurde apps

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

Beschrijving

De functie Select simuleert een select-actie 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 om een select-actie 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 Gallery is standaard ingesteld op Select( Parent ). 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 plaats de eigenschap OnSelect van het doelbesturingselement in de wachtrij voor latere verwerking, die plaats kan vinden nadat de evaluatie van de huidige formule is voltooid. Select heeft niet tot gevolg dat de eigenschap OnSelect van het doelbesturingselement direct wordt geëvalueerd. Ook wacht Select niet totdat OnSelect is geëvalueerd.

U kunt Select niet gebruiken tussen schermen.

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

U kunt Select alleen gebruiken in gedragsformules.

Een besturingselement kan Select niet op zichzelf toepassen, niet direct en ook niet 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 )

• Besturingselement: vereist. Het besturingselement dat moet worden geselecteerd namens de gebruiker.

Select( Besturingselement, Rij of kolom, Onderliggend besturingselement )

• Besturingselement: 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:

   Notify( "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( Button1 )

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:

   Notify( "Gallery 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", 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.