Wybierz funkcję

Dotyczy: aplikacje kanwy aplikacje oparte na modelu

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

Opis

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

Funkcja Select umożliwia propagowanie akcji 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 Gallery jest ustawiana na Select( Parent ). 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.

Funkcja Select umieszcza właściwość OnSelect w kolejce do późniejszego przetwarzania, co może mieć miejsce po zakończeniu obliczania wartości bieżącej formuły. Funkcja Select nie powoduje natychmiastowego obliczania wartości właściwości OnSelect. Funkcja Select nie oczekuje też na zakończenie obliczania wartości właściwości OnSelect.

Funkcji Select nie można używać na ekranach.

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

Funkcji Select można używać tylko w formułach dotyczących zachowań.

Kontrolka nie może używać funkcji Select względem samej siebie bezpośrednio lub 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 )

• Kontrolka – wartość wymagana. Kontrolka do wybrania w imieniu użytkownika.

Select( kontrolka, wiersz lub kolumna, kontrolka podrzędna )

• Kontrolka – wartość wymagana. Kontrolka do wybrania w imieniu użytkownika.
• Wiersz lub kolumna — wartość niewymagana. Numer wiersza lub kolumny (począwszy od 1) w kontrolce galerii do wybrania w imieniu użytkownika.
• Kontrolka podrzędna — wartość niewymagana. Kontrolka podrzędna kontrolki określona w parametrze „control” do wybrania.

Przykłady

• Przycisk

  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łę:

   Notify( "Hello World" )

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

   Select( Button1 )

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łę:

   Notify( "Wybrana galeria" )

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( "Wybrany obraz", Powodzenie )

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( Gallery1,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.