Seleccioneu una funció
S'aplica a: Aplicacions de llenç Aplicacions basades en models
Simula una acció de selecció en un control i fa que s'avaluï la fórmula OnSelect.
Descripció
La funció Select simula una acció de selecció d'un control com si l'usuari hagués fet clic al control o l'hagués tocat. Com a resultat, s'avalua la fórmula OnSelect del control de destinació.
Utilitzeu Select per propagar una acció de selecció a un control principal. Aquest tipus de propagació és el comportament per defecte a les galeries, per exemple. Per defecte, la propietat OnSelect de qualsevol control d'un control Galeria es defineix com a Select(Parent). D'aquesta manera, podeu definir el valor de la propietat OnSelect del control de galeria; la fórmula s'avaluarà independentment del lloc de la galeria on un usuari pugui fer clic o tocar.
Si voleu que un o diversos controls de la galeria duguin a terme accions diferents de la galeria, definiu la propietat OnSelect per als controls en un altra valor que no sigui el valor per defecte. Podeu deixar els valors per defecte per a les propietats OnSelect de la majoria de controls de la galeria si voleu que realitzin la mateixa acció que la galeria.
Selecciona cues la destinació OnSelect per al processament posterior, que pot passar després d'haver acabat d'avaluar la fórmula actual. Select no fa que l'OnSelect de destinació s'avaluï immediatament, ni espera que s'acabi d'avaluar.
No podeu utilitzar Select entre pantalles.
Només podeu utilitzar Select amb els controls que tenen una propietat OnSelect.
Només podeu utilitzar Select en fórmules de comportament.
Un control no pot aplicar Select directament ni indirectament a través d'altres controls.
La funció Select també es pot utilitzar amb una galeria. Per exemple, es pot utilitzar per especificar la fila o la columna que se seleccionarà en una galeria i el control que se seleccionarà a la fila o columna de la galeria. Quan seleccioneu una fila o columna, canvia la selecció de la galeria i s'avalua la fórmula OnSelect del control de la galeria. Si es proporciona un control a la fila o columna, s'avalua la fórmula OnSelect per al control secundari.
Sintaxi
Select( Control )
- Control : obligatori. El control que se seleccionarà en nom de l'usuari.
Selecciona( Control, Fila o columna, Control secundari)
- Control : obligatori. El control que se seleccionarà en nom de l'usuari.
- Fila o columna : no és necessari. El nombre de fila o columna (començant per 1) en un control de galeria que se seleccionarà en nom de l'usuari.
- Control infantil : no és necessari. El control secundari del control identificat al paràmetre 'control' que se seleccionarà.
Exemples
Botó
Select(button1)
Galeria
Select(Gallery1, 1)
Simula un usuari que selecciona la fila 1 o la columna 1 de Gallery1.
Galeria
Select(Gallery1, 1, ChildControl1)
Simula un usuari que selecciona ChildConttrol1 a la fila 1 o la columna 1.
Ús bàsic
Afegiu un control Botó i canvieu-ne el nom per Button1 si té un nom diferent.
Definiu la propietat OnSelect de Button1 a aquesta fórmula:
Notifica( "Hola món" )
A la mateixa pantalla, afegiu un segon control Botó i definiu-ne la propietat OnSelect a aquesta fórmula:
Selecciona( Botó1 )
Mentre manteniu premuda la tecla Alt, seleccioneu el segon botó.
Apareix una notificació a la part superior de l'aplicació. La propietat OnSelect de Button1 ha generat aquesta notificació.
Control de galeria
Afegiu un control Galeria vertical que contingui altres controls.
Definiu la propietat OnSelect de la galeria a aquesta fórmula:
Notifica( "Galeria seleccionada" )
Mentre manteniu premuda la tecla Alt, feu clic o toqueu el fons de la galeria o qualsevol control de la galeria.
Totes les accions mostraran la notificació Galeria seleccionada a la part superior de l'aplicació.
Utilitzeu la propietat OnSelect de la galeria per especificar l'acció per defecte que s'ha de fer quan l'usuari fa clic o toca un element de la galeria.
Definiu la propietat OnSelect del control d'imatge a aquesta fórmula:
Notifica( "Imatge seleccionada", Èxit )
Mentre manteniu premuda la tecla Alt, feu clic o toqueu els diversos elements de la galeria.
Quan feu clic o toqueu qualsevol control de la galeria que no sigui la imatge, Galeria seleccionada apareix com abans. Quan feu clic o toqueu la imatge, apareix Imatge seleccionada.
Utilitzeu controls individuals a la galeria per dur a terme accions que difereixen de l'acció per defecte de la galeria.
A la mateixa pantalla, afegiu un control Botó i definiu-ne la propietat OnSelect a aquesta fórmula:
Selecciona( Galeria1,2,Imatge1 )
Mentre manteniu premuda la tecla Alt, seleccioneu el botó.
Apareix una notificació Imatge seleccionada a la part superior de l'aplicació. La simulació de clic del botó corresponent a la selecció de la imatge de la fila 2 de la galeria.