Управление внешним видом и поведением инструмента
Инструменты переключения - это кнопки переключения, которые отображаются на панели инструментов в верхней части фигуры. uitoggletool функция создает кнопку-переключатель на панели инструментов и задает все необходимые свойства перед ее отображением. Изменяя значения свойств, можно изменять некоторые аспекты их внешнего вида и поведения. Используйте точечную нотацию для ссылки на определенный объект и свойство.
tt = uitoggletool; tt.Separator = 'on';
State - Переключить состояние инструмента'off' (по умолчанию) | логическое значение on/offПереключить состояние кнопки, указанное как 'off' или 'on'или как числовое или логическое 0 (false) или 1 (true) . Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
Когда это свойство имеет значение 'on', переключатель появляется в нижнем (нажатом) положении. Когда это свойство имеет значение 'off', кнопка переключения появляется в верхнем положении. Изменение состояния вызывает соответствующее OnCallback или OffCallback функция для выполнения.
Icon - Источник или файл значка'' (по умолчанию) | символьный вектор | строковый скаляр | mоколо-n-by-3 массив цветных изображенийИсточник или файл значка, указанный как вектор символа, скаляр строки или mоколо-n-на-3 массив цветных изображений. Если указан вектор символов или строковый скаляр, это может быть имя файла изображения по пути MATLAB ® или полный путь к файлу изображения. Если вы планируете поделиться своим приложением с другими пользователями, поместите файл изображения в путь MATLAB, чтобы облегчить упаковку приложения. Поддерживаемые форматы изображений включают JPEG, PNG, GIF и SVG.
При указании mоколо-nМассив -by-3 интерпретируется как массив изображения truecolor. Дополнительные сведения о массивах изображений truecolor см. в разделе Типы изображений.
Если указанное изображение больше 16 на 16 пикселей, то Icon масштабирует изображение таким образом, что все изображение помещается в инструмент. Если указанное изображение меньше 16 на 16 пикселей, оно не масштабируется в соответствии с имеющимся пространством.
Icon поддерживается только в App Designer и uifigure-based apps. Если Icon и CData оба свойства установлены, затем CData свойство игнорируется.
Пример: 'icon.png' указывает файл изображения по пути MATLAB.
Пример: 'C:\Documents\icon.png' указывает полный путь к файлу изображения.
CData - Массив изображений[] (по умолчанию) | mоколо-n-by-3 массив цветных изображенийМассив изображений, указанный как mоколо-n-на-3 массив цветных изображений. Значения в массиве могут быть следующими:
Значения двойной точности между 0.0 и 1.0
uint8 значения между 0 и 255
Чтобы изображение не появлялось обрезанным или искаженным, укажите массив с помощью m и n меньше или равно 16. Если изображение обрезано, используется только центральная часть массива 16 на 16.
Примечание
Для конструктора приложений и uifigure- приложения на основе, используйте Icon для указания значков инструмента нажатия и переключения.
Separator - Режим разделительной линии'off' (по умолчанию) | логическое значение on/offРежим разделительной линии, указанный как 'off' или 'on'или как числовое или логическое 0 (false) или 1 (true) . Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
Установка для этого свойства значения 'on' рисует разделительную линию слева от инструмента на панели инструментов.
Visible - Состояние видимости'on' (по умолчанию) | логическое значение on/offСостояние видимости, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
'on' - Просмотр объекта.
'off' - Скрыть объект, не удаляя его. По-прежнему можно получить доступ к свойствам невидимого компонента пользовательского интерфейса.
Чтобы приложение начиналось быстрее, установите Visible свойство для 'off' для всех компонентов пользовательского интерфейса, которые не должны появляться при запуске.
Enable - Рабочее состояние'on' (по умолчанию) | логическое значение on/offРабочее состояние, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
Если для этого свойства задано значение 'on'пользователь приложения может взаимодействовать с компонентом.
Если для этого свойства задано значение 'off', компонент выглядит затемненным, указывая, что пользователь приложения не может взаимодействовать с ним и что он не инициирует обратный вызов.
Tooltip - ПодсказкаПодсказка, заданная как символьный вектор, строковый скаляр или категориальный массив. Это свойство используется для отображения сообщения при наведении курсора на компонент в запущенном приложении. Подсказка не отображается, когда компонент отключен. Если это свойство указано как категориальный массив, MATLAB использует значения в массиве, а не полный набор категорий.
В фигурах, созданных с помощью uifigure функции, инструменты нажатия и переключения поддерживают многострочные подсказки. Для создания многострочной подсказки используйте команду sprintf для вставки новых символов строки ('\n') в вашем тексте. Например:
txt = sprintf('Line 1\nLine 2');Затем установите Tooltip свойство к значению, возвращенному sprintf.
В фигурах, созданных с помощью figure функция, инструменты нажатия и переключения не поддерживают многострочные подсказки.
ContextMenu - Контекстное менюGraphicsPlaceholder массив (по умолчанию) | ContextMenu объектУстановка этого свойства не влияет на объекты этого типа.
TooltipString - Подсказка (не рекомендуется)Подсказка, заданная как символьный вектор, строковый скаляр или категориальный массив. Подсказка появляется при наведении курсора на компонент в приложении. Если это свойство указано как категориальный массив, MATLAB использует значения в массиве, а не полный набор категорий.
Примечание
TooltipString не рекомендуется запускать свойство в R2018b. Используйте Tooltip вместо этого свойство.
ClickedCallback - Выполнен обратный вызов с помощью инструмента'' (по умолчанию) | дескриптор функции | массив ячеек | символьный векторВыполнен обратный вызов, указанный как одно из следующих значений:
Дескриптор функции.
Массив ячеек, в котором первый элемент является дескриптором функции. Последующие элементы в массиве ячеек являются аргументами для передачи функции обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.
Дополнительные сведения об указании функций обратного вызова в качестве дескрипторов функций, массивов ячеек или векторов символов см. в разделе Как задать значения свойств обратного вызова.
Типы данных: function_handle | cell | char
OnCallback - Переключение инструмента при обратном вызове'' (по умолчанию) | дескриптор функции | массив ячеек | символьный векторПереключение инструмента обратного вызова, указанного как одно из следующих значений:
Дескриптор функции.
Массив ячеек, в котором первый элемент является дескриптором функции. Последующие элементы в массиве ячеек являются аргументами для передачи функции обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.
Этот обратный вызов выполняется, когда пользователь включает инструмент переключения.
Дополнительные сведения об указании функций обратного вызова в качестве дескрипторов функций, массивов ячеек или векторов символов см. в разделе Как задать значения свойств обратного вызова.
Типы данных: function_handle | cell | char
OffCallback - Отключить обратный вызов с помощью инструмента'' (по умолчанию) | дескриптор функции | массив ячеек | символьный векторОтключить обратный вызов инструмента, указанный как одно из следующих значений:
Дескриптор функции.
Массив ячеек, в котором первый элемент является дескриптором функции. Последующие элементы в массиве ячеек являются аргументами для передачи функции обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.
Этот обратный вызов выполняется, когда пользователь выключает инструмент переключения.
Дополнительные сведения об указании функций обратного вызова в качестве дескрипторов функций, массивов ячеек или векторов символов см. в разделе Как задать значения свойств обратного вызова.
Типы данных: function_handle | cell | char
CreateFcn - Функция создания компонента'' (по умолчанию) | дескриптор функции | массив ячеек | символьный векторФункция создания компонента, заданная как одно из следующих значений:
Дескриптор функции.
Массив ячеек, в котором первый элемент является дескриптором функции. Последующие элементы в массиве ячеек являются аргументами для передачи функции обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.
Дополнительные сведения об указании значения свойства обратного вызова в качестве дескриптора функции, массива ячеек или символьного вектора см. в разделе Как задать значения свойства обратного вызова.
Это свойство определяет функцию обратного вызова, выполняемую при создании компонента MATLAB. MATLAB инициализирует все значения свойств компонентов перед выполнением CreateFcn обратный вызов. Если не указать CreateFcn , то MATLAB выполняет функцию создания по умолчанию.
Используйте gcbo функция в вашей CreateFcn для получения создаваемого объекта компонента.
Установка CreateFcn свойство для существующего объекта-компонента не влияет.
DeleteFcn - Функция удаления компонента'' (по умолчанию) | дескриптор функции | массив ячеек | символьный векторФункция удаления компонента, заданная как одно из следующих значений:
Дескриптор функции.
Массив ячеек, в котором первый элемент является дескриптором функции. Последующие элементы в массиве ячеек являются аргументами для передачи функции обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.
Дополнительные сведения об указании значения свойства обратного вызова в качестве дескриптора функции, массива ячеек или символьного вектора см. в разделе Как задать значения свойства обратного вызова.
DeleteFcn свойство определяет функцию обратного вызова, выполняемую при удалении компонента MATLAB (например, при закрытии окна пользователем). MATLAB выполняет команду DeleteFcn обратный вызов перед уничтожением свойств объекта компонента. Если не указать DeleteFcn , то MATLAB выполняет функцию удаления по умолчанию.
Используйте gcbo функция в вашей DeleteFcn для получения удаляемого объекта компонента.
Interruptible - Прерывание обратного вызова'on' (по умолчанию) | on/off логические значенияПрерывание обратного вызова, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
Interruptible определяет, можно ли прервать выполняющийся обратный вызов. Существует два состояния обратного вызова:
Выполняемый обратный вызов - это выполняемый в данный момент обратный вызов.
Обратный вызов с прерыванием - это обратный вызов, который пытается прервать выполняющийся обратный вызов.
Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать выполняющийся обратный вызов (если он существует). Interruptible свойство объекта, владеющего выполняющимся обратным вызовом, определяет, разрешено ли прерывание:
Значение 'on' позволяет другим обратным вызовам прерывать обратные вызовы объекта. Прерывание происходит в следующей точке, где MATLAB обрабатывает очередь, например, при наличии drawnow, figure, getframe, waitfor, или pause.
Если выполняемый обратный вызов содержит одну из этих команд, MATLAB останавливает выполнение обратного вызова в этот момент и выполняет обратный вызов с прерыванием. MATLAB возобновляет выполнение выполняющегося обратного вызова после завершения прерванного обратного вызова.
Если выполняемый обратный вызов не содержит одну из этих команд, MATLAB завершает выполнение обратного вызова без прерывания.
Значение 'off' блокирует все попытки прерывания. BusyAction свойство объекта, владеющего прерывистым обратным вызовом, определяет, отбрасывается ли прерывистый обратный вызов или помещается в очередь.
Примечание
Прерывание и выполнение обратного вызова ведут себя по-разному в следующих ситуациях:
Если обратный вызов с прерыванием является DeleteFcn, CloseRequestFcn, или SizeChangedFcn обратный вызов, то прерывание происходит независимо от Interruptible значение свойства.
Если выполняемый обратный вызов в данный момент выполняется waitfor функция, то прерывание происходит независимо от Interruptible значение свойства.
Timer объекты выполняются в соответствии с графиком независимо от Interruptible значение свойства.
MATLAB не сохраняет состояние свойств или отображения при прерывании. Например, объект, возвращенный gca или gcf при выполнении другого обратного вызова команда может измениться.
Пример, показывающий, как Interruptible и BusyAction свойства влияют на поведение программы.
BusyAction - Постановка в очередь обратного вызова'queue' (по умолчанию) | 'cancel'Очередь обратного вызова указана как 'queue' (по умолчанию) или 'cancel'. BusyAction определяет, как MATLAB обрабатывает выполнение прерывания обратных вызовов. Существует два состояния обратного вызова:
Выполняемый обратный вызов - это выполняемый в данный момент обратный вызов.
Обратный вызов с прерыванием - это обратный вызов, который пытается прервать выполняющийся обратный вызов.
BusyAction свойство источника обратного вызова прерывания определяет, как MATLAB обрабатывает его выполнение. BusyAction свойство имеет следующие значения:
'queue' - Поместить прерывистый обратный вызов в очередь для обработки после завершения выполнения выполняющегося обратного вызова.
'cancel' - Не выполняйте обратный вызов прерывания.
Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов всегда пытается прервать выполнение обратного вызова. Interruptible свойство объекта, обратный вызов которого выполняется, определяет, разрешено ли прерывание. Если Interruptible имеет значение:
on - Прерывание происходит в следующей точке, где MATLAB обрабатывает очередь. Это значение по умолчанию.
off- BusyAction свойство (объекта, владеющего прерывистым обратным вызовом) определяет, ставит ли MATLAB в очередь или игнорирует прерывистый обратный вызов.
Пример, показывающий, как BusyAction и Interruptible свойства влияют на поведение программы.
BeingDeleted - Статус удаленияЭто свойство доступно только для чтения.
Состояние удаления, возвращаемое как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState.
MATLAB устанавливает BeingDeleted свойство для 'on' когда DeleteFcn обратный вызов начинает выполнение. BeingDeleted свойство остается установленным в значение 'on' до тех пор, пока объект-компонент больше не будет существовать.
Проверьте значение BeingDeleted для проверки того, что объект не будет удален перед запросом или изменением.
HitTest - Возможность стать текущим объектом (не рекомендуется)'on' (по умолчанию) | логическое значение on/offЭто свойство не влияет на объекты этого типа.
Parent - Родительский объектToolbar объектРодительский объект, указанный как Toolbar объект. Это свойство используется для задания родительской панели инструментов при создании инструмента или для перемещения существующего инструмента на другую панель инструментов.
HandleVisibility - Видимость ручки объекта'on' (по умолчанию) | 'callback' | 'off'Видимость дескриптора объекта, указанного как 'on', 'callback', или 'off'.
Это свойство управляет видимостью объекта в родительском списке потомков. Если объект не виден в списке нижестоящих элементов родительского объекта, он не возвращается функциями, получающими объекты путем поиска в иерархии объектов или запроса свойств. Эти функции включают get, findobj, gca, gcf, gco, newplot, cla, clf, и close. HandleVisibility свойство также управляет видимостью дескриптора объекта в родительском рисунке CurrentObject собственность. Объекты действительны, даже если они не видны. При наличии доступа к объекту можно задать и получить его свойства и передать его любой функции, которая работает с объектами.
| Значение HandleVisibility | Описание |
|---|---|
'on' | Дескриптор объекта всегда виден. |
'callback' | Дескриптор объекта виден внутри обратных вызовов или функций, вызываемых обратными вызовами, но не внутри функций, вызываемых из командной строки. Этот параметр блокирует доступ к объекту в командной строке, но разрешает доступ к нему функциям обратного вызова. |
'off' | Дескриптор объекта всегда невидим. Этот параметр полезен для предотвращения непреднамеренных изменений пользовательского интерфейса другой функцией. Установите HandleVisibility кому 'off' для временного скрытия дескриптора во время выполнения этой функции. |
Type - Тип графического объекта'uitoggletool'Это свойство доступно только для чтения.
Тип графического объекта, возвращаемого как 'uitoggletool'.
Tag - Идентификатор объекта'' (по умолчанию) | символьный вектор | строковый скалярИдентификатор объекта, заданный как вектор символа или скаляр строки. Можно указать уникальный Tag для использования в качестве идентификатора объекта. При необходимости доступа к объекту в другом месте кода можно использовать findobj для поиска объекта на основе Tag значение.
UserData - Данные пользователя[] (по умолчанию) | массивПользовательские данные, указанные как любой массив. Определение UserData может быть полезен для совместного использования данных в приложениях. Дополнительные сведения см. в разделе Совместное использование данных среди обратных вызовов.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.