Форматирование элементов диалога

Начало  Предыдущая  Следующая

В окнах, отображаемых функцией ArcShowDialogProcW, в параметре ControlsDesc могут быть заданы элементы диалога в следующем формате (пустая строка – дополнительные элементы отсутствуют).

{~XX~}<Значение1>{~XX~}<Значение2>{~XX~}<ЗначениеN>

Здесь XX – один из кодов обозначающий тот или иной элемент:

Код

 

Комментарий

Ch

Dlg_CheckBox

Элемент CheckBox. Далее указывается <Значение> в следующем формате:

N<текст флажка>

Здесь N – число 0 или 1. Значение 1 – если флажок установлен.

RB

Dlg_RadioBut

Элемент RadioButton. Формат <Значение> аналогичен, как для CheckBox.

Lb

Label

Элемент Label. Здесь <Значение> – строка задающая текст надписи. Текст может содержать форматированные конструкции [f…;…] .

Sp

 

Space. Здесь <Значение>  – целое число, интервал между элементами.

Co

Dlg_ComboBox

Элемент ComboBox. Формат <Значение> :

TN|<заголовок>|<текст по умолчанию>|<текст1>|<текст2>|…|<текстX>

Здесь T – это один из символов:

"e" – это ComboBox с возможностью редактировать текст,

"a" – это ComboBox с возможностью редактировать текст и с AutoComplete,

"x" – ComboBox без возможности редактировать текст.

N – это число, номер выбранного текста по умолчанию. Если это "-" (минус) – то по умолчанию не выбран ни один из текстов, если это пустая строка – то выбранный элемент определяется текстом по умолчанию.

<заголовок> – текст, печатаемый возле ComboBox.

<текст по умолчанию> – начальный текст в ComboBox (может быть пустым, если указан N).

<текстX> – перечисление альтернатив в выпадающем списке ComboBox.

 

Если символ "|" является частью текста, то перед ним может быть установлен экранирующий символ "\".

TB

Dlg_Edit

Элемент TextBox. Формат <Значение> :

T|<заголовок>|<текст по умолчанию>

Здесь T – это один из символов:

"E" – это обычный TextBox,

"f" – TextBox с возможностью выбора файла,

"F" – TextBox с возможностью выбора папки,

"A" – TextBox с возможностью выбора папки или файла.

Если символ "|" является частью текста, то перед ним может быть установлен экранирующий символ "\".

CL

Dlg_CommandLink

Элемент CommandLink. Здесь <Значение> – строка, задающая текст CommandLink. При этом первая строка этого текста выделяется большим шрифтом.

Текст может содержать форматированные конструкции [f…;…] .

Первым символом в тексте может быть указан символ "~" – тогда данный элемент будет недоступен, символ "+" – явное указание, что элемент доступен, символ "!" – элемент доступен и выбран по умолчанию.

Строки текста разделяются символом с десятичным кодом 13 или парой символов с кодами 13 10.

По умолчанию, если элементы CommandLink не указаны, то в окне будет присутствовать кнопка "ОК", если указаны – то только кнопка "Отмена".

В случае нажатия одной из CommandLink функция вернет порядковый номер CommandLink начиная с 0.

Bu

Dlg_But

Элемент Кнопка. Показываются внизу окна. Здесь <Значение> – это текст на кнопке.

Вместо текста можно указать число от 1 и выше, тогда будет выведен стандартный текст для кнопок. Коды этих текстов смотрите в языковых lng-файлах в подкаталоге Languages (так 1 соответствует кнопке "ОК", 2 – "Отмена" и т.д.).

 

В случае если указано несколько кнопок, то при их выборе функция вернет -1 – для первой кнопки слева, -2 – для второй и т.д.