Exponenta Banner

uitoggletool

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

свернуть все на странице

Синтаксис

tt = uitoggletool
tt = uitoggletool(parent)
tt = uitoggletool(___,Name,Value)

Описание

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. В программном файле:

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

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

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

  • Создайте синюю матрицу изображений истинного цвета. Установите инструмент 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 имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

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

Примечание

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

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

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

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

Если вы задаете m- n- 3 массива, это интерпретировано как матрица изображений истинного цвета. Для получения дополнительной информации о матрицах изображений истинного цвета, смотрите Типы изображения.

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

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

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

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

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

  • Значения с двойной точностью между 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

Документация MATLAB

Поддержка