396
Глава 19
Значение %%ThisValue%% указывает значение исполнения управляющего элемента, которое представляет собой содержимое текстового поля. Это задано по умолчанию.
Если параметр Синтаксис включает %%ThisValue%%, а значение исполнения текстового окна пусто, элемент управления Текстовое окно не создает никакого командного синтаксиса.
Поле ввода чисел
Управляющий элемент «Поле ввода чисел» представляет собой текстовое поле для ввода числового значения и имеет следующие свойства:
Идентификатор. Уникальный идентификатор для этого элемента управления. Идентификатор, который должен использоваться при ссылке на этот элемент управления в шаблоне синтаксиса.
Заголовок. Необязательный заголовок, отображаемый над этим элементом управления. В случае многострочных заголовков используйте \n для указания разрыва строки.
Всплывающая подсказка. Необязательная всплывающая подсказка, отображаемая, когда пользователь устанавливает курсор мыши над этим элементом управления.
Горячая клавиша. Необязательный символ в заголовке, который должен использоваться длябыстрогодоступакэтомуэлементууправления. Этотсимволотображаетсявзаголовкес подчеркиванием. Этот доступактивизируетсяпри нажатиинаклавишуAlt+[мнемоническая клавиша]. Функция Мнемоническая клавиша не поддерживается на платформе Mac.
Числовой тип. Указывает все ограничения на вводимые данные. Значение «Действительное» указывает, что разрешен только ввод числовых значений и других ограничений нет. Значение «Целое» указывает, что значение должно быть целым числом.
Значение по умолчанию. Значение по умолчанию, если имеется. Минимальное значение. Минимальное допустимое значение, если имеется. Максимальное значение. Максимальное допустимое значение, если имеется.
Требуется для выполнения. Указывает, требуется ли задание какого-либо значения в этом элементе управления для продолжения процедуры. Если указано значение Истина, то кнопки OK и Вставка будут деактивированы до тех пор, пока для этого элемента управления не будет задано какое-либо значение. Если указано значение Ложь, то отсутствие значение этого элемента управления не оказывает воздействия на состояние кнопки OK и Вставка. Значение по умолчанию: Ложь.
Синтаксис. Указывает синтаксис команды , который генерируется этим элементом управления во время исполнения и может быть вставлен в шаблон синтаксиса.
Можно указать любой действительный синтаксис команды, в качестве разрыва строки можно использовать \n.
Значение %%ThisValue%% указывает значение исполнения управляющего элемента, которое представляет собой числовое значение. Это задано по умолчанию.
Если параметр Синтаксис включает %%ThisValue%%, а значение исполнения текстового окна пусто, поле ввода чисел не создает никакого командного синтаксиса.
397
Создание настраиваемых диалоговых окон и управление ими
Статическое текстовое поле
С помощью управляющего элемента «Статическое текстовое поле» можно добавить текстовый блок в диалоговое окно. Этот управляющий элемент имеет следующие свойства:
Идентификатор. Уникальный идентификатор для этого элемента управления.
Заголовок. Содержимое текстового блока. Если содержимое разбито на несколько строк, обозначайте разрыв строки с помощью \n.
Группа элементов
Управляющий элемент «Группа элементов» представляет собой контейнер для других управляющих элементов, что позволяет группировать и контролировать синтаксис, генерируемый несколькими управляющими элементами. К примеру, имеется набор флажков, которые указывают настройки для подкоманды, но синтаксис для подкоманды необходимо генерировать, если установлен по крайней мере один флажок. Для этого в качестве контейнера управляющих элементов флажков используется управляющий
элемент «Группа элементов». Управляющий элемент «Группа элементов» может содержать следующие типы управляющих элементов: флажок, поле со списком, поле ввода текста, поле ввода чисел, статическое текстовое поле, группу переключателей и обозреватель файлов. Управляющий элемент «Группа элементов» имеет следующие свойства:
Идентификатор. Уникальный идентификатор для этого элемента управления. Идентификатор, который должен использоваться при ссылке на этот элемент управления в шаблоне синтаксиса.
Заголовок. Необязательный заголовок для группы. При использовании заголовков на нескольких строках в качестве символа разрыва строки укажите \n.
Требуется для выполнения. ЗначениеИстина показывает, что кнопки OK и Вставка будут отключены, пока по меньшей мере один управляющий элемент в группе не будет иметь значение. Значение по умолчанию: Ложь.
Например, группа состоит из набора флажков. Если для свойства «Требуется для выполнения» установлено значение Истина и все флажки сняты, то кнопки OK и Вставка будут отключены.
Синтаксис. Указывает синтаксис команды , который генерируется этим элементом управления во время исполнения и может быть вставлен в шаблон синтаксиса.
Можно указать любой действительный синтаксис команды, в качестве разрыва строки можно использовать \n.
Можно указать идентификаторы для всех управляющих элементов, входящих в группу элементов. При исполнении вместо идентификаторов подставляется синтаксис, генерируемый управляющими элементами.
Значение %%ThisValue%% генерирует разделенный пробелами список синтаксиса, который сгенерирован каждым управляющим элементом в группе элементов в порядке их следования в группе (сверху вниз). Это задано по умолчанию. Если параметр Синтаксис включает %%ThisValue%%, и ни один управляющий элемент в
398
Глава 19
группе элементов не генерирует синтаксис, то группа элементов как единое целое не генерирует командный синтаксис.
Группа переключателей
Элемент управления Группа переключателей — это хранилище для набора переключателей, каждый из которых содержит набор вложенных элементов управления. Элемент управления Группа переключателей имеет следующие свойства:
Идентификатор. Уникальный идентификатор для этого элемента управления. Идентификатор, который должен использоваться при ссылке на этот элемент управления в шаблоне синтаксиса.
Заголовок. Необязательный заголовок для группы. В случае его отсутствия граница группы не отображается. При использовании заголовков на нескольких строках в качестве символа разрыва строки укажите \n.
Всплывающая подсказка. Необязательная всплывающая подсказка, отображаемая, когда пользователь устанавливает курсор мыши над этим элементом управления.
Переключатели. Нажмите кнопку с троеточием (...), чтобы открыть диалоговое окно Свойства группы переключателей, с помощью которого можно указать свойства переключателей, а также добавить переключатели в группу или удалить их. Возможность вкладывать элементы управления в данный переключатель является свойством переключателя, и оно установлено в диалоговом окне Свойства группы переключателей. Примечание: Кроме того, можно открыть диалоговое окно Свойства
группы переключателей, дважды щелкнув по элементу управления Группа переключателей на макете.
Синтаксис. Указывает синтаксис команды , который генерируется этим элементом управления во время исполнения и может быть вставлен в шаблон синтаксиса.
Можно указать любой действительный синтаксис команды, в качестве разрыва строки можно использовать \n.
Значение %%ThisValue%% указывает значение исполнения для группы переключателей, которое является значением свойства «Синтаксис» для выбранного переключателя. Это задано по умолчанию. Если параметр Синтаксис включает %%ThisValue%%, и ни один выбранный переключатель не генерирует синтаксис, то группа переключателей не генерирует командный синтаксис.
Определение переключателей
С помощью диалогового окна «Свойства группы переключателей» можно указать группы переключателей.
Идентификатор. Уникальный идентификатор для переключателя.
Имя. Имя, которое отображается рядом с переключателем. Поле «Имя» обязательно для заполнения.
Всплывающая подсказка. Необязательная всплывающая подсказка, отображаемая, когда пользователь устанавливает курсор мыши над этим элементом управления.
399
Создание настраиваемых диалоговых окон и управление ими
Горячая клавиша. Необязательный символ в имени, который используется в качестве горячей клавиши. Указанный символ должен присутствовать в имени.
Вложенная группа. Указывает, могут ли другие элементы управления вкладываться в данный переключатель. Значение по умолчанию — Ложь. Когда значение свойства вложенной группы установлено как «истинно», в соответствующем переключателе отображается вложенное и идентифицированное прямоугольное поле. Следующие элементы управления могут вкладываться в данный переключатель: флажок, поле со списком, поле ввода текста, поле ввода чисел, поле со списком, список и обозреватель файлов.
По умолчанию. Указывает, выбран ли переключатель по умолчанию.
Синтаксис. Указывает синтаксис команды, который генерируется при выборе переключателя.
Можно указать любой действительный синтаксис команды, в качестве разрыва строки можно использовать \n.
Значение %%ThisValue%% генерирует разделенный пробелами список синтаксиса, который сгенерирован каждым вложенным элементом управления в переключателе в порядке их следования (сверху вниз).
Новый переключатель можно добавить в пустую строку внизу существующего списка. Ввод любых свойств, отличных от идентификатора, приведет к генерации уникального идентификатора, который можно сохранить или изменить. Переключатель можно удалить, щелкнув по ячейке Идентификатор переключателя и нажав клавишу Delete.
Группа флажков
Управляющий элемент «Группа флажков» представляет собой контейнер для набора управляющих элементов, которые включаются или отключаются как группа с помощью одного флажка. Управляющий элемент «Группа флажков» может содержать следующие типы управляющих элементов: флажок, поле со списком, поле ввода текста, поле ввода чисел, статическое текстовое поле, группу переключателей и обозреватель файлов. Управляющий элемент «Группа флажков» имеет следующие свойства:
Идентификатор. Уникальный идентификатор для этого элемента управления. Идентификатор, который должен использоваться при ссылке на этот элемент управления в шаблоне синтаксиса.
Заголовок. Необязательный заголовок для группы. В случае его отсутствия граница группы не отображается. При использовании заголовков на нескольких строках в качестве символа разрыва строки укажите \n.
Название флажка. Дополнительная метка, которая отображается рядом с управляющим флажком. Поддерживается символ \n в качестве символа разрыва строки.
Всплывающая подсказка. Необязательная всплывающая подсказка, отображаемая, когда пользователь устанавливает курсор мыши над этим элементом управления.