uitoggletool

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

Описание

tt = uitoggletool создает инструмент переключения на панели инструментов текущей фигуры и возвращает ToggleTool объект.

Эта текущая фигура должен быть создан с figure функция. Если на текущей фигуре нет дочерней панели инструментов, то MATLAB® создает единицу в текущей фигуре, которая будет служить родительским элементом. Если рисунок создан с figure функция не существует, затем MATLAB создает ее и вызывает uitoolbar функция для создания панели инструментов, которая будет служить родительским элементом.

Инструменты переключения имеют два состояния: 'off' или 'on'. Состояние кнопки изменяется каждый раз, когда вы нажимаете на нее.

пример

tt = uitoggletool(parent) создает инструмент переключения на указанной родительской панели инструментов.

пример

tt = uitoggletool(___,Name,Value) создает инструмент переключения со значениями свойств, заданными с помощью одного или нескольких аргументов пары "имя-значение". Задайте пары "имя-значение" с любым из предыдущих синтаксисов.

Примеры

свернуть все

Создайте рисунок путем вызова figure функция. Добавьте на рисунок панель инструментов. Он появляется под панелью инструментов рисунка по умолчанию.

f = figure;
tb = uitoolbar(f);

Figure that displays the default toolbar and another empty toolbar below it.

Создайте инструмент переключения на панели инструментов. Создайте массив нулей 16 на 16 на 3, чтобы быть его значком. Установите CData значение свойства для этого массива, чтобы отобразить черный квадратный значок в инструменте переключения.

tt = uitoggletool(tb);
ttImage = zeros(16,16,3);
tt.CData = ttImage;

Figure that displays the default toolbar and a custom toolbar below it. The custom toolbar displays a black square as a toggle tool.

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

Сначала создайте программный файл с именем toggleColor.m. В программном файле:

  • Создайте фигуру пользовательского интерфейса.

  • Создайте панель инструментов в фигуру пользовательского интерфейса.

  • Добавить инструмент переключения на панель инструментов.

  • Создайте синий массив изображений truecolor. Установите переключатель инструмента Icon значение свойства для него.

  • Установите ClickedCallback свойство указателю на функцию, который ссылается на функцию обратного вызова toggleFigureColor.

  • Создайте функцию обратного вызова toggleFigureColor. В нем запросите значение State свойство для инструмента переключения. Если состояние 'on'измените цвет фона рисунка на синий и сделайте переключатель инструмента черным. Точно так же, если состояние 'off', затем смените рисунок цвет фона на черный и сделайте переключатель инструмента синим.

function toggleColor
fig = uifigure;
tb = uitoolbar(fig);
tt = uitoggletool(tb);

ttImage = zeros(16,16,3);
ttImage(:,:,3) = ones(16);
tt.Icon = ttImage;
tt.ClickedCallback = @toggleFigureColor;

    function toggleFigureColor(src,event)
        state = src.State;
        
        if strcmp(state,'on')
            fig.Color = 'blue';
            tt.Icon = zeros(16,16,3);
        else
            fig.Color = 'black';
            tt.Icon = ttImage;
        end
        
    end

end

Выполняйте toggleColor. Щелкните на инструменте переключения, чтобы изменить цвет фона рисунка.

toggleColor
UI figure that displays a toolbar and a toggle tool with a blue square icon.

Входные параметры

свернуть все

Родительская панель инструментов, заданная как Toolbar объект. Используйте это свойство, чтобы задать родительскую панель инструментов при создании инструмента переключения или переместить существующий инструмент на другую панель инструментов.

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

Если рисунок создан с figure функция не существует, затем MATLAB создает ее и вызывает uitoolbar функция для создания панели инструментов, которая служит родительским элементом.

Если вы добавляете несколько инструментов нажатия или переключения на панель инструментов, они добавляются налево направо в том порядке, в котором они созданы.

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: 'Separator','on' устанавливает режим линии диафрагмы равным 'on'.

Примечание

Перечисленные здесь свойства являются только подмножеством. Полный список см. в разделе Свойства ToggleTool.

Кнопка-переключатель, заданное как 'off' или 'on', или как числовое или логическое 0 (false) или 1 (true). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

Когда это значение свойства 'on', кнопка-переключатель появляется в положении вниз (вдавленный). Когда это значение свойства 'off', кнопка-переключатель появляется в положении вверх. Изменение состояния вызывает соответствующую OnCallback или OffCallback функцию для выполнения.

Источник значка или файл, заданный как вектор символов, строковый скаляр или m-by- n-by-3 truecolor массив изображений. Если вы задаете вектор символов или строковый скаляр, это может быть имя файла изображения в пути MATLAB или полный путь к файлу изображения. Если вы планируете поделиться своим приложением с другими, поместите файл изображения на путь MATLAB, чтобы облегчить упаковку приложений. Поддерживаемые форматы изображений включают JPEG, PNG, GIF и SVG.

Если вы задаете m-by- n-by-3 массив интерпретируется как массив изображений truecolor. Дополнительные сведения о массивах изображений truecolor см. в разделе Типы изображений.

Если заданное изображение больше 16 на 16 пикселей, то Icon свойство масштабирует изображение вниз так, чтобы все изображение находилось внутри инструмента. Если заданное изображение меньше 16 на 16 пикселей, оно не масштабируется, чтобы соответствовать доступному пространству.

The Icon свойство поддерживается только в App Designer и uifigure-основанные на приложениях Если Icon и CData свойства оба заданы, затем CData свойство проигнорировано.

Пример: 'icon.png' задает файл изображения в пути MATLAB.

Пример: 'C:\Documents\icon.png' задает полный путь к файлу изображения.

Массив изображений, заданный как m-by- n-by-3 truecolor массив изображений. Значения в массиве могут быть:

  • Значения двойной точности между 0.0 и 1.0

  • uint8 значения между 0 и 255

Чтобы предотвратить появление обрезанного или искаженного изображения, задайте массив с m и n меньше или равно 16. Если изображение обрезано, используется только центральная часть массива 16 на 16.

Примечание

Для App Designer и uifigure- основанные на приложениях, используйте Icon свойство, чтобы задать нажатие и переключение значков инструмента.

Совет

  • Toolbar объекты (и их дочерний объект PushTool и ToggleTool объекты) не появляются на рисунках, чьи WindowStyle для свойства задано значение 'modal'. Если рисунок, содержащая дочерний элемент панели инструментов, имеет свои WindowStyle изменено на 'modal'дочерний элемент панели инструментов все еще существует в Children свойство рисунка. Однако панель инструментов не отображается во время WindowStyle установлено в 'modal'.

См. также

Функции

Свойства

Представлено до R2006a
Для просмотра документации необходимо авторизоваться на сайте