Вибрати функцію

Застосовується до: програм Canvas Програм на основі моделі

Імітує дію вибору елемента керування, що призводить до виконання формули OnSelect.

Опис

Функція Select імітує дію вибору елемента керування, коли користувач натиснув елемент керування. У результаті формула OnSelect виконується для цільового елемента керування.

Використовуйте функцію Select, щоб розповсюдити дію вибору на батьківській елемент керування. Цей тип розповсюдження — поведінка за замовчуванням, наприклад, у галереях. За замовчуванням властивість OnSelect будь-якого елемента керування в елементі керування Галерея встановлено на Select( Батьківський елемент ). Таким чином можна задати значення властивості OnSelect елемента керування галереєю, і цю формула буде обчислено незалежно від того, де в галереї користувач може його натиснути або торкнутися.

Якщо потрібно, щоб один або кілька елементів керування в галереї виконували різні дії з самої галереї, встановіть для властивості OnSelect для цих елементів керування інше значення, ніж значення за замовчуванням. Можна залишити значення за замовчуванням для властивостей OnSelect більшості елементів керування в колекції, якщо вони мають виконувати такі ж дії, що й сама галерея.

Функція Select ставить у чергу цільовий елемент OnSelect для пізнішої обробки, яка може статися після обчислення поточної формули. Функція Select не викликає невідкладного обчислення цільової функції OnSelect, також функція OnSelect не очікує завершення обчислення властивості OnSelect.

Не можна використовувати функцію Select на різних екранах.

Можна використовувати Select лише з елементами керування, які мають властивість OnSelect.

Ви можете використовувати функцію SetFocus лише у формулах поведінки.

Елемент керування не може Вибирати себе безпосередньо або опосередковано через інші елементи керування.

Функція Select також може використовуватися з галереєю. Наприклад, її можна використати, щоб вказати рядок або стовпець, який потрібно вибрати в галереї, і елемент керування, який потрібно вибрати в цьому рядку або стовпці галереї. Якщо вибрати рядок або стовпець, вибір галереї змінюється та формула OnSelect для елемента керування галерею обчислюється. Якщо елемент керування надано в рядку або стовпці, буде обчислено формулу OnSelect для дочірнього елемента керування.

Синтаксис

Select( Елемент керування )

• Control — обов’язковий аргумент. Елемент керування, який потрібно вибрати від імені користувача.

Select( Елемент керування, Рядок або стовпець, дочірній елемент керування )

• Control — обов’язковий аргумент. Елемент керування, який потрібно вибрати від імені користувача.
• Рядок або стовпець — необов’язковий аргумент. Кількість рядків або стовпців (починаючи з 1) у елементі керування галереєю, яку потрібно вибрати від імені користувача.
• Дочірній елемент керування — необов’язковий аргумент. Дочірній елемент керування, визначений у параметрі "елемент керування", який потрібно вибрати.

Приклади

• Кнопка

  Select(button1)

• Галерея

  Select(Gallery1, 1)

  Імітує дію, коли користувач вибирає рядок 1 або стовпець 1 у Галереї1.

• Галерея

  Select(Gallery1, 1, ChildControl1)

  Імітує дію, коли користувач вибирає Дочірнійелемент1 у рядку 1 або стовпці 1 Галереї1.

Базове використання

1. Додайте елемент керування Кнопка, а потім перейменуйте його на Кнопка1, якщо вона має інше ім’я.

2. Встановить для властивості OnSelect елемента керування Кнопка1 таку формулу:

   Notify( "Hello World" )

3. На тому ж екрані додайте другий елемент керування Кнопка, і для його властивості OnSelect укажіть цю формулу:

   Select( Кнопка1 )

4. Утримуючи натиснутою клавішу Alt, виберіть другу кнопку.

   Сповіщення відобразиться у верхній частині програми. Властивість OnSelect елемента керування Кнопка1 створила це сповіщення.

   

Елемент керування "Галерея"

1. Додайте елемент керування вертикальною Галереєю, який містить інші елементи керування.

   

2. Установіть для властивості OnSelect галереї таку формулу:

   Notify( "Вибрана галерея" )

3. Утримуючи натиснутою клавішу Alt, натисніть або торкніться фону галереї або будь-якого елемента керування в галереї.

   Усі дії відображатимуть сповіщення Галерею вибрано у верхній частині програми.

   Використовуйте властивість OnSelect для визначення дії за замовчуванням, яку потрібно виконати, коли користувач натискає елемент у колекції.

4. Установить для властивості OnSelect елемента керування зображеннями таку формулу:

   Notify( "Зображення вибрано", Успішно )

5. Утримуючи натиснутою клавішу Alt, натисніть різні елементи галереї.

   Якщо натиснути будь-який елемент керування в колекції, за винятком зображення, як і раніше відобразиться сповіщення Вибрано галерею. Після натискання зображення відобразиться повідомлення Зображення вибрано.

   Використовуйте окремі елементи керування в колекції, щоб виконувати дії, які відрізняються від дії за замовчуванням у галереї.

   

6. На тому ж екрані додайте елемент керування Кнопка, і для його властивості OnSelect укажіть цю формулу:

   Select( Галерея1,2,Зображення1 )

7. Утримуючи натиснутою клавішу Alt, виберіть кнопку.

   Сповіщення Зображення вибрано відобразиться у верхній частині програми. Натискання кнопки імітує вибір зображення в рядку 2 цієї галереї.