Alterator/New/Packages: различия между версиями
Qwest (обсуждение | вклад) (→Button) |
Qwest (обсуждение | вклад) |
||
Строка 777: | Строка 777: | ||
==== | |||
Именно в этот виджет вставляются все остальные. | === Описание виджетов и их атрибутов === | ||
* | |||
* | |||
* | ==== Корневой виджет ==== | ||
Именно в этот виджет вставляются все остальные. Имеет следующие атрибуты: | |||
* '''title''' - заголовок окна | |||
* '''width''' -- ширина окна | |||
* '''height''' -- высота окна | |||
==== Box ==== | ==== Box ==== | ||
Контейнер для других виджетов. | Контейнер для других виджетов. | ||
* | * '''orientation''' - со значением ''horizontal'' - это развернутый вариант виджета '''hbox'''. Аналогично, со значением ''vertical'' - развернутый вариант виджета '''vbox'''. | ||
==== Button ==== | ==== Button ==== | ||
Строка 791: | Строка 797: | ||
<u>Атрибуты:</u> | <u>Атрибуты:</u> | ||
* | * '''text''' - текст на кнопке; | ||
* | * '''pixmap''' - картинка из списка. | ||
<u>События:</u> | <u>События:</u> | ||
* < | * '''clicked''' - вызывается при нажатии кнопки. | ||
==== CheckBox ==== | |||
Кнопка-флажок с двумя состояниями ''true'' или ''false''. | |||
* '''text''' - описание кнопки; | |||
* '''state''' - состояние флажка. Если значение ''#t'', то флажок выставлен. При значении ''#f'' флажок отсутствует; | |||
* '''value''' - то же, что и '''state'''. | |||
==== DateEdit ==== | |||
Текущая дата. | |||
* '''expanded''' - со значением ''#t'' дополнительно отображает календарь. | |||
==== TimeEdit ==== | |||
Отображает время. | |||
* '''expanded''' - со значением ''#t'' добавляет графические часы; | |||
* '''stop''' - остановка счета времени; | |||
* '''start''' - запуск счета времени; | |||
* '''value''' - задание времени. | |||
==== Radio ==== | |||
Радиокнопка позволяет выбрать один пункт из набора, в пределах одного контейнера. | |||
* '''state''' - состояние пункта. Данный пункт выбран при значении ''#t''; | |||
* '''text''' - описание пункта; | |||
==== Edit ==== | |||
Однострочное текстовое поле ввода. | |||
* '''echo''' - режим отображения. Возможные варианты: ''normal'' (по умолчанию), ''stars'' (звёздочки, для паролей), ''no'' (ввод не отображается); | |||
* '''alterability''' - разрешение на изменение текста. Если значение ''#f'', содержимое поля доступно только для чтения; | |||
* '''text''' - содержимое поля; | |||
* '''value''' - то же, что и '''text'''. | |||
==== GridBox ==== | |||
Вертикальный контейнер "сетки". Основой способ организации виджетов на экране. | |||
* '''columns''' - ширина стобцов сетки в процентном соотношении от общей ширины. | |||
==== Label ==== | |||
Предназначен для отображения какой-либо надписи без возможности редактирования. | |||
* '''text-wrap''' - отображение одной длинной строки в виде многострочного текста (''#t''/''#f''); | |||
* '''text''' - отображаемый текст. | |||
==== GroupBox ==== | |||
Объединение группы виджетов в один контейнер. | |||
* '''checked''' - в случае значения #t рядом с заголовком отображается checkbox (если он не выделен, то содержимое группы неактивно и недоступно для работы); | |||
* '''orientation''' - ориентация контейнера (''horizontal''/''vertical''); | |||
* '''state''' - состояние checkbox в случае режима checked; | |||
* '''title''' - заголовок группы. | |||
==== ProgressBar ==== | |||
Строка прогресса некоторого процесса. | |||
* '''maximum''' - максимальное допустимое значение, соответствует 100%; | |||
* '''minimum''' - минимальное допустимое значение, соответствует 0%; | |||
* '''text''' - информация в строке прогресса; | |||
* '''value''' - текущее значение прогресса. | |||
==== SpinBox ==== | |||
Поле со счетчиком для ввода чисел. | |||
* '''maximum''' - максимальное допустимое значение; | |||
* '''minimum''' - минимальное допустимое значение; | |||
* '''step''' - шаг приращения значения; | |||
* '''value''' - текущее значение. | |||
==== TextBox ==== | |||
Многострочное текстовое поле ввода. | |||
* '''alterability''' - разрешение на изменение текста. Если значение ''#f'', содержимое поля доступно только для чтения; | |||
* '''text''' - содержимое поля; | |||
* '''append-text''' - добавить текст в конец поля; | |||
* '''url''' - показать содержимое указанного файла. | |||
==== FileSelect ==== | |||
Выбор файла из файловой системы, для дальнейшей работы с ним. | |||
* '''filter''' - допустимые расширения файлов; | |||
* '''hints''' - условие выбора файла (обычно используется значение ''existing_file'' для проверки на существование выбранного файла); | |||
* '''title''' - заголовок; | |||
* '''url''' - путь поиска файлов. | |||
<u>Пример:</u> | |||
<pre style="width:30em"> | |||
(document:surround "/std/frame") | |||
(define fileselect (make-widget 'fileselect)) | |||
(define url (make-attribute 'url)) | |||
(define filter (make-attribute 'filter)) | |||
(define hints (make-attribute 'hints)) | |||
(gridbox columns "100" | |||
(fileselect title (_"Import CA certificate") | |||
url "/" | |||
filter "*.cert *.crt *.pem" | |||
hints "existing_file")) | |||
</pre> |
Версия от 15:22, 2 сентября 2013
Текущее состояние модулей альтератора
Packages Internals
Таблица виджетов
Таблица общих атрибутов для всех виджетов
Attribute | Значения | Описание |
---|---|---|
align | "left" "right" "middle" "hmiddle" "center" "top" "bottom" | выравнивание внутри ячейки «сетки» |
activity | #t #f | активирует/отключает виджет |
visibility | #t #f | видимость/невидимость виджета |
colspan | <число> | количество столбцов "сетки" под данный виджет |
rowspan | <число> | количество строк "сетки" под данный виджет |
tooltip | <текст> | справочная информация, выводимая во всплывающей подсказке |
focus | #t #f | атрибут только для записи, помещает фокус на виджет для которого указано значение #t |
width | <число> | ширина виджета |
height | <число> | высота виджета |
title | <текст> | заголовок родительского контейнера |
name | <текст> | имя виджета |
nameref | <текст> | аналог name (?) |
margin | <число> | ширина "рамки" вокруг контейнера |
spacing | <число> | промежуток между виджетами (применим только к контейнерам) |
Описание виджетов и их атрибутов
Корневой виджет
Именно в этот виджет вставляются все остальные. Имеет следующие атрибуты:
- title - заголовок окна
- width -- ширина окна
- height -- высота окна
Box
Контейнер для других виджетов.
- orientation - со значением horizontal - это развернутый вариант виджета hbox. Аналогично, со значением vertical - развернутый вариант виджета vbox.
Button
Кнопка с текстом и картинкой.
Атрибуты:
- text - текст на кнопке;
- pixmap - картинка из списка.
События:
- clicked - вызывается при нажатии кнопки.
CheckBox
Кнопка-флажок с двумя состояниями true или false.
- text - описание кнопки;
- state - состояние флажка. Если значение #t, то флажок выставлен. При значении #f флажок отсутствует;
- value - то же, что и state.
DateEdit
Текущая дата.
- expanded - со значением #t дополнительно отображает календарь.
TimeEdit
Отображает время.
- expanded - со значением #t добавляет графические часы;
- stop - остановка счета времени;
- start - запуск счета времени;
- value - задание времени.
Radio
Радиокнопка позволяет выбрать один пункт из набора, в пределах одного контейнера.
- state - состояние пункта. Данный пункт выбран при значении #t;
- text - описание пункта;
Edit
Однострочное текстовое поле ввода.
- echo - режим отображения. Возможные варианты: normal (по умолчанию), stars (звёздочки, для паролей), no (ввод не отображается);
- alterability - разрешение на изменение текста. Если значение #f, содержимое поля доступно только для чтения;
- text - содержимое поля;
- value - то же, что и text.
GridBox
Вертикальный контейнер "сетки". Основой способ организации виджетов на экране.
- columns - ширина стобцов сетки в процентном соотношении от общей ширины.
Label
Предназначен для отображения какой-либо надписи без возможности редактирования.
- text-wrap - отображение одной длинной строки в виде многострочного текста (#t/#f);
- text - отображаемый текст.
GroupBox
Объединение группы виджетов в один контейнер.
- checked - в случае значения #t рядом с заголовком отображается checkbox (если он не выделен, то содержимое группы неактивно и недоступно для работы);
- orientation - ориентация контейнера (horizontal/vertical);
- state - состояние checkbox в случае режима checked;
- title - заголовок группы.
ProgressBar
Строка прогресса некоторого процесса.
- maximum - максимальное допустимое значение, соответствует 100%;
- minimum - минимальное допустимое значение, соответствует 0%;
- text - информация в строке прогресса;
- value - текущее значение прогресса.
SpinBox
Поле со счетчиком для ввода чисел.
- maximum - максимальное допустимое значение;
- minimum - минимальное допустимое значение;
- step - шаг приращения значения;
- value - текущее значение.
TextBox
Многострочное текстовое поле ввода.
- alterability - разрешение на изменение текста. Если значение #f, содержимое поля доступно только для чтения;
- text - содержимое поля;
- append-text - добавить текст в конец поля;
- url - показать содержимое указанного файла.
FileSelect
Выбор файла из файловой системы, для дальнейшей работы с ним.
- filter - допустимые расширения файлов;
- hints - условие выбора файла (обычно используется значение existing_file для проверки на существование выбранного файла);
- title - заголовок;
- url - путь поиска файлов.
Пример:
(document:surround "/std/frame") (define fileselect (make-widget 'fileselect)) (define url (make-attribute 'url)) (define filter (make-attribute 'filter)) (define hints (make-attribute 'hints)) (gridbox columns "100" (fileselect title (_"Import CA certificate") url "/" filter "*.cert *.crt *.pem" hints "existing_file"))