Funkcja Select

Dotyczy: Aplikacje kanwy

Symuluje akcję wybierania kontrolki, co powoduje obliczenie wartości formuły OnSelect.

Opis

Funkcja Select symuluje akcję wyboru kontrolki tak, jakby użytkownik kliknął lub naciągnął kontrolkę. W wyniku następuje obliczenie wartości formuły OnSelect w obrębie kontrolki docelowej.

Użyj Select polecenia , aby propagować akcję wybierania do kontrolki nadrzędnej. Ten typ propagacji to domyślne zachowanie na przykład w galeriach. Domyślnie właściwość OnSelect dowolnej kontrolki w kontrolce Galeria jest ustawiona na Selectwartość ( Element nadrzędny ). W ten sposób można ustawić wartość właściwości OnSelect samej kontrolki galerii, a wartość tej formuły będzie obliczana bez względu na to, czy użytkownik kliknie lub wybierze daną pozycję w galerii.

Jeśli chcesz, aby co najmniej jedna kontrolka w galerii wykonywała akcje inne niż sama galeria, ustaw właściwość OnSelect dla tych kontrolek na wartość inną niż domyślna. Możesz pozostawić wartości domyślne dla właściwości OnSelect większości kontrolek w galerii, jeśli chcesz, aby wykonywały tę samą akcję, co galeria.

Select kolejkuje docelowy element OnSelect do późniejszego przetwarzania, co może nastąpić po zakończeniu oceny bieżącej formuły. Select nie powoduje natychmiastowej oceny docelowej wartości OnSelect ani Select nie oczekuje na zakończenie oceny przez element OnSelect .

Nie można używać Select na ekranach.

Można używać Select tylko z kontrolkami, które mają właściwość OnSelect .

Można używać Select tylko w formułach zachowania.

Kontrolka nie Select może być bezpośrednio ani pośrednio za pośrednictwem innych kontrolek.

Funkcja Select może być również używana z galerią. Można jej na przykład użyć, aby określić wiersz lub kolumnę do wybrania w galerii i kontrolkę do wybrania w tym wierszu lub tej kolumnie galerii. Po wybraniu wiersza lub kolumny wybór galerii zmieni się, a w kontrolce galerii zostanie obliczona formuła OnSelect. Jeśli zostanie podana kontrolka w wierszu lub kolumnie, zostanie obliczona formuła OnSelect dla kontrolki podrzędnej.

Składnia

Select( Kontrolka )

• Kontrola – Wymagane. Kontrolka do wybrania w imieniu użytkownika.

Select( Kontrolka, Wiersz lub kolumna, Kontrolka podrzędna )

• Kontrola – Wymagane. Kontrolka do wybrania w imieniu użytkownika.
• Wiersz lub kolumna – Niewymagane. Numer wiersza lub kolumny (począwszy od 1) w kontrolce galerii do wybrania w imieniu użytkownika.
• Element podrzędny Control - Nie jest wymagany. Kontrolka podrzędna kontrolki określona w parametrze „control” do wybrania.

Przykłady

• Guzik

  Select(button1)

• Galeria

  Select(Gallery1, 1)

  Symuluje użytkownika wybierającego wiersz 1 lub kolumnę 1 w galerii Gallery1.

• Galeria

  Select(Gallery1, 1, ChildControl1)

  Symuluje użytkownika wybierającego element ChildConttrol1 w wierszu 1 lub kolumnie 1 w galerii Gallery1.

Podstawowy sposób użycia

1. Dodaj kontrolkę Button i zmień jej nazwę na Button1, jeśli ma inną nazwę.

2. Ustaw właściwość OnSelect przycisku Button1 na tę formułę:

   Powiadom ( "Witaj świecie" )

3. Na tym samym ekranie dodaj drugą kontrolkę Button i ustaw jej właściwość OnSelect na następującą formułę:

   Select( Przycisk1 )

4. Przytrzymując klawisz Alt, wybierz drugi przycisk.

   W górnej części aplikacji zostanie wyświetlone powiadomienie. Właściwość OnSelect przycisku Button1 wygenerowała to powiadomienie.

   

Kontrolka Gallery

1. Dodaj pionową kontrolkę Gallery zawierającą inne kontrolki.

   

2. Dla właściwości OnSelect galerii ustaw następującą formułę:

   Powiadom( "Galeria wybrana" )

3. Trzymając wciśnięty klawisz Alt, kliknij lub wybierz tło galerii lub dowolną kontrolkę w galerii.

   W górnej części aplikacji wszystkie akcje będą wyświetlać powiadomienie Wybrana galeria.

   Za pomocą właściwości OnSelect galerii określ domyślną akcję do podjęcia, gdy użytkownik kliknie lub wybierze element w galerii.

4. Ustaw właściwość OnSelect kontrolki obrazu na następującą formułę:

   Notify( "Obraz wybrany", NotificationType.Success )

5. Trzymając wciśnięty klawisz Alt, kliknij lub wybierz różne elementy galerii.

   Po kliknięciu lub wybraniu w galerii dowolnej kontrolki, z wyjątkiem obrazu, tak jak poprzednio zostanie wyświetlone powiadomienie Wybrana galeria. Po kliknięciu lub wybraniu obrazu zostanie wyświetlone powiadomienie Wybrany obraz.

   Użyj indywidualnych kontrolek w galerii, aby podejmować akcje inne niż domyślna akcja galerii.

   

6. Na tym samym ekranie dodaj kontrolkę Button i ustaw jej właściwość OnSelect na następującą formułę:

   Select( Galeria1,2,Image1 )

7. Trzymając wciśnięty klawisz Alt, kliknij przycisk.

   W górnej części aplikacji zostanie wyświetlone powiadomienie Wybrany obraz. Kliknięcie przycisku symuluje wybranie obrazu w wierszu 2 galerii.