Изберете функция
Отнася се за: Приложения за платно Приложения, управлявани от модел
Симулира избрано действие на контрола, като кара формулата OnSelect да бъде оценена.
Описание
функцията Select функция симулира избрано действие върху контрола, сякаш потребителят е щракнал или натиснал контрола. В резултат на това OnSelect формулата за целевия контрол се оценява.
Използвайте Select за разпространение на избрано действие към родителски контрол. Този тип разпространение е поведение по подразбиране в например галерии. По подразбиране, свойството OnSelect на всеки контрол в галерия контролата е настроена на Select( Parent ). По този начин можете да зададете стойността на OnSelect свойството на самия контрол на галерията и тази формула ще бъде оценена независимо от това къде в галерията потребителят може да щракне или докосне.
Ако искате един или повече контроли в галерията да изпълняват различни действия от самата галерия, задайте настройката OnSelect свойство за тези контроли на нещо различно от стойността по подразбиране. Можете да оставите стойностите по подразбиране за OnSelect свойства на повечето контроли в галерията, ако искате те да извършат същото действие като самата галерия.
Select поставя на опашка целевото OnSelect за по-късна обработка, което може да се случи, след като текущата формула приключи с оценяването. Изборът не кара целевия OnSelect да се оценява незабавно, нито изчаква OnSelect да завърши оценяването.
Не можете да използвате Select през екраните.
Можете да използвате Select само с контроли, които имат свойство OnSelect.
Можете да използвате Select само във формули на поведение.
Контролът не може да Select себе си пряко или косвено чрез други контроли.
Функцията Select може да се използва и с галерия. Например, може да се използва за определяне на реда или колоната за избор в галерия и контрола за избор в този ред или колона на галерията. Когато изберете ред или колона, изборът на галерията се променя и OnSelect формулата за контрола на галерията се оценява. Ако е осигурен контрол в реда или колоната, то OnSelect формулата за контрол над детето ще бъде оценена.
Синтаксис
Избор ( управление )
- Контрол – Задължителен. Контролът за избор от името на потребителя.
Избор( Контрола, Ред или колона, Дъщерна контрола )
- Контрол – Задължителен. Контролът за избор от името на потребителя.
- Ред или колона – Не е задължително. Броят на реда или колоната (започваща с 1) в контрола на галерията, за да изберете от името на потребителя.
- Контрол от деца - Не се изисква. Детето за контрол на контрола, идентифициран в параметъра „control“, за да изберете.
Примери
Копче
Select(button1)
Галерия
Select(Gallery1, 1)
Симулира потребител, който избира ред 1 или колона 1 в Gallery1.
Галерия
Select(Gallery1, 1, ChildControl1)
Симулира потребител, който избира ChildConttrol1 в ред 1 или колона 1 на Gallery1.
Основна употреба
Добавете Button контрола и я преименувайте на Button1, ако има различно име.
Задайте свойството OnSelect на Button1 на тази формула:
Notify( "Hello World" )
На същия екран добавете втора контрола Бутон и задайте свойството й OnSelect на тази формула:
Избор ( бутон1 )
Изберете втория бутон, докато държите клавиша Alt.
Известие се появява в горната част на приложението ви. Свойството OnSelect на Button1, генерирало това известие.
Контрола Галерия
Добавете вертикала галерия контрол, който съдържа други контроли.
Задайте свойството OnSelect на галерията на тази формула:
Notify( "Избрана галерия" )
Докато държите клавиша Alt, щракнете или докоснете фона на галерията или каквото и да е управление в галерията.
Всички действия ще покажат Избрана галерия известие в горната част на приложението.
Използвайте свойството на галерията OnSelect, за да посочи действието по подразбиране, което трябва да предприеме, когато потребителят щракне или докосне елемент в галерията.
Задайте свойството OnSelect на контролата на изображение на тази формулата:
Notify( "Избрано изображение", успех )
Докато държите клавиша Alt, щракнете или докоснете различните елементи на галерията.
Когато щракнете или докоснете всеки елемент в галерията с изключение на изображението, Избрана галерия се появява както преди. Когато щракнете или докоснете изображението, се появява Избрано изображение.
Използвайте отделни контроли в галерията, за да предприемете действия, които се различават от действието по подразбиране на галерията.
На същия екран добавете контрола Бутон и задайте свойството й OnSelect на тази формула:
Изберете ( Галерия 1,2,Изображение 1 )
Докато държите клавиша Alt, изберете бутона.
Известие Избрано изображение се появява в горната част на приложението ви. Натискането на бутона симулира избора на изображението в ред 2 на галерията.