35.4 Функции утилиты графического интерфейса пользователя

Эти функции не реализуют элемент графического интерфейса пользователя, но полезны при разработке программ, которые это делают. Функции uiwait, uiresume, и waitfor доступны только с наборами инструментов qt или fltk.

data = guidata (h)

guidata (h, data)

Запрос или установка пользовательских данных графического интерфейса.

Данные графического интерфейса хранятся в дескрипторе фигуры h. Если h не является дескриптором фигуры, то используется родительская фигура для хранения.

data должен быть одним объектом, что означает, что обычно предпочтительно, чтобы это был контейнер данных, такой как ячейковый массив или структура, чтобы легко добавлять дополнительные элементы данных.

См. также: getappdata, setappdata, get, set, getpref, setpref.

hdata = guihandles (h)

hdata = guihandles

Возвращает структуру дескрипторов объектов для фигуры, связанной с дескриптором h.

Если дескриптор не указан, используется текущая фигура, возвращаемая функцией gcf.

Имя поля для каждого элемента hdata взято из свойства "tag" графического объекта. Если метка пустая, дескриптор не возвращается. Если несколько графических объектов имеют одну и ту же метку, запись в hdata будет вектором дескрипторов. guihandles включает все возможные дескрипторы, включая те, для которых "HandleVisibility" является "off".

См. также: guidata, findobj, findall, allchild.

have_window_system ()

Возвращает true, если система окон доступна (X11, Windows или Apple OS X), и false в противном случае.

См. также: isguirunning.

isguirunning ()

Возвращает true, если Octave работает в режиме графического интерфейса пользователя, и false в противном случае.

См. также: have_window_system.

movegui

movegui (h)

movegui (pos)

movegui (h, pos)

movegui (h, event)

movegui (h, event, pos)

Перемещает фигуру, заданную дескриптором фигуры h, в позицию на экране, определенную pos.

h является дескриптором фигуры или дескриптором графического объекта. В последнем случае будет использоваться родительская фигура. Если не указано, h будет установлен на дескриптор соответствующей фигуры, если выполняется обратный вызов (gcbf), в противном случае он будет установлен на дескриптор текущей фигуры (gcf).

pos — это либо числовой вектор из двух значений, либо строка. Если pos числовой, то он должен иметь вид [h, v], определяющий горизонтальные и вертикальные смещения фигуры относительно экрана. Положительное значение указывает смещение между левым (или нижним для вертикальной составляющей) краем экрана и левым (или нижним) краем фигуры. Отрицательное значение указывает смещение между правым (или верхним) краем экрана и правым (или верхним) краем фигуры.

Возможные значения для pos в виде строки:

north

Центр верхнего края экрана.

south

Центр нижнего края экрана.

east

Центр правого края экрана.

west

Центр левого края экрана.

northeast

Верхний правый угол экрана.

northwest

Верхний левый угол экрана.

southeast

Нижний правый угол экрана.

southwest

Нижний левый угол экрана.

center

Центр экрана.

onscreen (default)

Фигура будет минимально перемещена, чтобы полностью отображаться на экране, с дополнительным отступом в 30 пикселей по бокам экрана. Это значение по умолчанию, если оно не указано.

event содержит данные события, которые будут игнорироваться. Эта конструкция облегчает вызов movegui из обратного вызова.

openvar (name)

Открыть переменную name в графическом редакторе переменных.

uiwait

uiwait (h)

uiwait (h, timeout)

Приостанавливает выполнение программы до тех пор, пока фигура с дескриптором h не будет удалена или не будет вызван uiresume.

Когда дескриптор фигуры не указан, эта функция использует текущую фигуру. Если дескриптор фигуры недействителен или текущая фигура отсутствует, эта функция возвращает немедленно.

Если указан, timeout определяет количество секунд ожидания удаления фигуры или вызова uiresume. Значение таймаута должно быть не менее 1. Если указано меньшее значение, выводится предупреждение, и вместо него используется таймаут в 1 секунду. Если указано нецелое значение, оно усекается к 0. Если timeout не указан, выполнение программы приостанавливается на неопределенный срок.

См. также: uiresume, waitfor.

uiresume (h)

Возобновляет выполнение программы, приостановленное функцией uiwait.

Дескриптор h должен совпадать с указанным в uiwait. Если дескриптор недействителен или для фигуры с дескриптором h нет ожидающего вызова uiwait, эта функция ничего не делает.

См. также: uiwait.

waitfor (h)

waitfor (h, prop)

waitfor (h, prop, value)

waitfor (…, "timeout", timeout)

Приостанавливает выполнение текущей программы до тех пор, пока не будет выполнено условие для графического дескриптора h.

Пока программа приостановлена, графические события обрабатываются нормально, что позволяет обратным вызовам изменять состояние графических объектов. Эта функция рекурсивна и может быть вызвана из обратного вызова, в то время как другой вызов waitfor ожидается на верхнем уровне.

В первом варианте выполнение программы приостанавливается до тех пор, пока графический объект h не будет уничтожен. Если дескриптор графического объекта недействителен или если h является корневым дескриптором графического объекта, и свойство prop не было предоставлено, функция возвращается немедленно.

Во втором варианте выполнение приостанавливается до тех пор, пока графический объект не будет уничтожен или свойство с именем prop не будет изменено. Если дескриптор графического объекта недействителен или свойство не существует, функция возвращается немедленно.

В третьем варианте выполнение приостанавливается до тех пор, пока графический объект не будет уничтожен или свойство с именем prop не будет установлено в значение value. Для сравнения значений свойств используется функция isequal. Если дескриптор графического объекта недействителен, свойство не существует или свойство уже установлено в value, функция возвращается немедленно.

Дополнительный таймаут может быть указан с помощью свойства "timeout". Это значение таймаута — количество секунд ожидания выполнения условия. timeout должен быть не менее 1. Если указано меньшее значение, выводится предупреждение, и вместо него используется значение 1. Если значение таймаута не является целым числом, оно усекается к 0.

Для определения условия на свойстве с именем "timeout" используйте строку '\timeout'.

Во всех случаях нажатие CTRL-C немедленно останавливает выполнение программы.

См. также: waitforbuttonpress, isequal.