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

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

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

Опис

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

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

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

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

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

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

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

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

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

Синтаксис

Вибрати( Контроль )

• Контроль – Обов’язковий. Елемент керування, який потрібно вибрати від імені користувача.

Вибрати( Control, Рядок або стовпець, Дочірній елемент Control )

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

Приклади

• Кнопку

  Select(button1)

• Галерея

  Select(Gallery1, 1)

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

• Галерея

  Select(Gallery1, 1, ChildControl1)

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

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

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

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

   Notify( "Привіт, світ" )

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

   Вибрати( Кнопка1 )

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

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

   

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

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

   

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

   Notify( "Галерея вибрана" )

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

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

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

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

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

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

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

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

   

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

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

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

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