Выберите функцию

Применимо к: приложениям на основе холста приложениям на основе модели

Имитирует выбор действия для элемента управления, активируя вычисление формулы OnSelect.

Описание

Функция Select имитирует выбор действия для элемента управления, как если бы этот элемент управления выбрал пользователь. В результате для целевого элемента управления вычисляется формула OnSelect.

Используйте функцию Select, чтобы распространить действие выбора на родительский элемент управления. Такой тип распространения является поведением по умолчанию, например, в коллекциях. По умолчанию для свойства OnSelect любого элемента управления в элементе управления Gallery (Коллекция) задано значение Select( Parent ). Так вы можете задать значение свойства OnSelect элемента управления Gallery (Коллекция). При этом формула будет вычисляться независимо от того, где именно в этом элементе управления пользователь может щелкнуть или коснуться.

Если вы хотите, чтобы один или несколько элементов в коллекции выполняли разные действия, задайте свойству OnSelect для этих элементов управления значения, отличные от значений по умолчанию. Чтобы элементы управления в коллекции выполняли те же действия, что и сама коллекция, оставьте для свойства OnSelect значения по умолчанию.

Функция Select помещает в очередь целевую формулу OnSelect для последующей обработки, что может произойти после завершения вычисления текущей формулы. Функция Select не активирует немедленное вычисление целевой формулы OnSelect. Также функция Select не ожидает завершения вычисления формулы OnSelect.

Вы не можете использовать функцию Select на разных экранах.

Вы можете использовать функцию Select только с элементами управления со свойством OnSelect.

Функцию Select можно использовать только в формулах поведения.

Элемент управления не может выполнить функцию Select по отношению к себе прямо или косвенно через другие элементы управления.

Функция Select также может использоваться при работе с коллекцией. Например, с ее помощью можно задать строку или столбец коллекции, из которых будет осуществляться выбор, а также управлять выбором элементов из указанных строки или столбца коллекции. При выборе строки или столбца изменяются выбранные элементы коллекции и вычисляется формула OnSelect в элементе управления коллекции. Если в строке или столбце представлен элемент управления, вычисляется формула OnSelect для дочернего элемента управления.

Синтаксис

Select( Control )

• Control — обязательный аргумент. Элемент управления, выбираемый от имени пользователя.

Select( Control, Row or column, Child Control )

• Control — обязательный аргумент. Элемент управления, выбираемый от имени пользователя.
• Row or column — необязательный атрибут. Номер строки или столбца (начиная с 1) в элементе управления коллекции, которые выбираются от имени пользователя.
• Child Control — необязательный атрибут. Дочерний элемент управления для элемента управления, определенного в параметре "control", для которого будет осуществляться выбор.

Примеры

• Кнопка

  Select(button1)

• Галерея

  Select(Gallery1, 1)

  Имитирует выбор пользователем строки 1 или столбца 1 в элементе Gallery1.

• Галерея

  Select(Gallery1, 1, ChildControl1)

  Имитирует выбор пользователем дочернего элемента ChildConttrol1 в строке 1 или столбце 1 в элементе Gallery1.

Базовое использование

1. Добавьте элемент управления Button и переименуйте его в Button1, если у него другое имя.

2. Задайте для свойства OnSelect кнопки Button1 эту формулу:

   Notify( "Hello World" )

3. На том же экране добавьте второй элемент управления Button и в качестве значения свойства OnSelect задайте следующую формулу:

   Select( Button1 )

4. Удерживая нажатой клавишу ALT, выберите вторую кнопку.

   В верхней части приложения появится уведомление, генерируемое свойством OnSelect кнопки Button1.

   

Элемент управления Gallery (Коллекция)

1. Добавьте вертикальный элемент управления Gallery (Коллекция), который содержит другие элементы управления.

   

2. Задайте для свойства OnSelect коллекции эту формулу:

   Notify( "Gallery Selected" )

3. Удерживая нажатой клавишу ALT, щелкните или коснитесь фона коллекции или любого элемента управления в коллекции.

   Все действия отобразят уведомление Gallery Selected (Выбрана коллекция) в верхней части приложения.

   С помощью свойства OnSelect коллекции можно указать действие по умолчанию, выполняемое, когда пользователь щелкает элемент в коллекции или касается его.

4. Назначьте свойству OnSelect элемента управления Image (Изображение) следующую формулу:

   Notify( "Image Selected", Success )

5. Удерживая нажатой клавишу Alt, щелкайте разные элементы коллекции или касайтесь их.

   При выборе любого элемента управления в коллекции, кроме изображения, как и раньше отображается уведомление Gallery Selected. При выборе изображения отображается уведомление Image Selected (Выбрано изображение).

   Используйте отдельные элементы управления в коллекции для выполнения действий, отличных от действий коллекции по умолчанию.

   

6. На том же экране добавьте элемент управления Button и в качестве значения свойства OnSelect задайте следующую формулу:

   Select( Gallery1,2,Image1 )

7. Удерживая нажатой клавишу ALT, выберите эту кнопку.

   В верхней части приложения появится уведомление Image Selected (Выбрано изображение). Нажатие этой кнопки позволяет имитировать выбор изображения в строке 2 коллекции.