Exponenta Banner

findobj

Класс: указатель

Нахождение объектов указателя

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

Синтаксис

Hmatch = findobj(H)
Hmatch = findobj(H,property,value,...,property,value)
Hmatch = findobj(H,'-not',property,value)
Hmatch = findobj(H,'-regexp',property,value)
Hmatch = findobj(H,property,value,'-logicaloperator',property,value)
Hmatch = findobj(H,'-function',fh)
Hmatch = findobj(H,'-function',property,fh)
Hmatch = findobj(H,'-class',class)
Hmatch = findobj(H,'-isa',class)
Hmatch = findobj(H,'-property',property)
Hmatch = findobj(H,'-method',methodname)
Hmatch = findobj(H,'-event',eventname)
Hmatch = findobj(H,'-depth',d,___)

Описание

Hmatch = findobj(H) возвращает объекты, перечисленные в H и все их потомки.

Hmatch = findobj(H,property,value,...,property,value) находит handle объекты, которые имеют заданный набор свойств к заданному значению.

Hmatch = findobj(H,'-not',property,value) инвертирует выражение в следующем property value пара. Таким образом, найдите объекты, заданное свойство которых не равно value.

Hmatch = findobj(H,'-regexp',property,value) обрабатывает содержимое value аргумент как регулярные выражения.

Hmatch = findobj(H,property,value,'-logicaloperator',property,value) применяет логический оператор к парам имя/значение. Поддерживаемые логические операторы включают:

  • '-or' (значение по умолчанию, если вы не задаете оператор),

  • '-and'

  • '-xor'

Hmatch = findobj(H,'-function',fh) вызывает указатель на функцию fh на объектах в H и возвращает объекты, для которых функция возвращает true.

Hmatch = findobj(H,'-function',property,fh) вызывает указатель на функцию fh на значении заданного свойства для объектов в H и возвращает объекты, для которых функция возвращает true. Функция должна возвратить скалярное логическое значение.

Hmatch = findobj(H,'-class',class) находит все объекты, принадлежащие заданному классу.

Hmatch = findobj(H,'-isa',class) находит все объекты, принадлежащие заданному классу.

Hmatch = findobj(H,'-property',property) находит весь объект в H наличие именованного свойства.

Hmatch = findobj(H,'-method',methodname) находит объекты, которые имеют заданное имя метода.

Hmatch = findobj(H,'-event',eventname) находит объекты, которые имеют заданное имя события.

Hmatch = findobj(H,'-depth',d,___) задает сколько уровней в иерархиях экземпляра под объектами в H искать.

Задайте весь -options как векторы символов или скаляры строки.

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

развернуть все

Объекты искать от, заданный как массив указателей на объект. Если вы не задают '-depth' опция, findobj ищет объекты во входном массиве H и дочерние объекты в иерархии экземпляра.

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

Типы данных: char | string

Класс объекта найти, заданный как чувствительный к регистру, заключенный в кавычки текст.

Типы данных: char | string

Значение свойства, заданное как значение или выражение MATLAB®.

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

Типы данных: char | string

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

Типы данных: char | string

Глубина поиска, заданного как целое число, указывающее на количество уровней ниже любого данного объекта во входном массиве H.

  • d = n — Поисковый n уровни иерархии ниже каждого объекта в H

  • d = 0 — Ищите только тот же уровень как объекты в H.

  • d = inf — Ищите все уровни ниже объектов в HЭто значение по умолчанию.

Указатель на функцию, задавая функцию, которая выполнена для каждого объекта во входном массиве H. Эта функция должна возвратить скаляр, логическое значение, указывающее, существует ли соответствие (true) или не (false).

Выходные аргументы

развернуть все

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

Примеры

Объект с определенным значением свойства

Найдите объект с определенным значением свойства. Учитывая handle класс, BasicHandle:

classdef BasicHandle < handle
   properties
      Prop1
   end
   methods
      function obj = BasicHandle(val)
         if nargin > 0
            obj.Prop1 = val;
         end
      end
   end
end

Создайте массив BasicHandle объекты:

h(1) = BasicHandle(7);
h(2) = BasicHandle(11);
h(3) = BasicHandle(27);

Найдите указатель объекта чей Prop1 свойство имеет значение 7:

h7 = findobj(h,'Prop1',7);
h7.Prop1

ans =

     7

Объект с определенным именем свойства

Найдите объект с определенным динамическим свойством. Учитывая button класс:

classdef button < dynamicprops
   properties
      UiHandle
   end
   methods
      function obj = button(pos)
         if nargin > 0
            if length(pos) == 4
               obj.UiHandle = uicontrol('Position',pos,...
                'Style','pushbutton');
            else
               error('Improper position')
            end
         end
      end     
   end   
end

Создайте массив объектов кнопки, только один элемент которых задает динамическое свойство. Используйте findobj получить указатель объекта с динамическим свойством под названием ButtonCoord:

b(1) = button([20 40 80 20]);
addprop(b(1),'ButtonCoord');
b(1).ButtonCoord = [2,3];
b(2) = button([120 40 80 20]);
b(3) = button([220 40 80 20]);

h =  findobj(b,'-property','ButtonCoord');
h.ButtonCoord

ans =

     2     3

Советы

  • findobj имеет доступ только к общедоступным участникам.

  • Если нет никаких соответствий, findobj возвращает пустой массив того же класса как входной массив H.

  • Приоритет логических операторов следует правилам приоритета MATLAB. Для получения дополнительной информации см. Приоритет операторов.

  • Управляйте приоритетом путем группировки в массивах ячеек

Смотрите также

Введенный в R2008a

Документация MATLAB
Поддержка