15.3.4 Поиск свойств

h = findobj ()

h = findobj (prop_name, prop_value, …)

h = findobj (prop_name, prop_value, "-logical_op", prop_name, prop_value)

h = findobj ("-property", prop_name)

h = findobj ("-regexp", prop_name, pattern)

h = findobj (hlist, …)

h = findobj (hlist, "flat", …)

h = findobj (hlist, "-depth", d, …)

Поиск графических объектов с заданными свойствами.

При вызове без аргументов возвращает все графические объекты, начиная с корневого объекта (0) и включая все его потомки.

Простейший способ сузить результаты:

findobj (prop_name, prop_value)

который возвращает дескрипторы всех объектов, у которых свойство с именем prop_name имеет значение prop_value. Если указано несколько пар свойство/значение, то возвращаются только объекты, удовлетворяющие всем условиям (эквивалентно -and).

Поиск можно ограничить определённым набором объектов и их потомков, передав дескриптор или набор дескрипторов hlist в качестве первого аргумента.

Глубину иерархии объектов, которую нужно просмотреть, можно ограничить с помощью аргумента "-depth". Пример поиска только по трём поколениям потомков:

findobj (hlist, "-depth", 3, prop_name, prop_value)

Указание глубины d равной 0 ограничивает поиск набором объектов, переданным в hlist. Глубина 0 также эквивалентна аргументу "flat". Значение глубины по умолчанию Inf, что включает все потомки.

Между парами prop_name, prop_value можно использовать указанный логический оператор. Поддерживаемые логические операторы: "-and", "-or", "-xor", "-not". Пример кода для поиска всех фигур и осей:

findobj ("type", "figure", "-or", "type", "axes")

Объекты также можно сопоставить, сравнив значение свойства с регулярным выражением, где возвращаются значения свойств, которые соответствуют regexp (prop_value, pattern).

Наконец, можно найти объекты, у которых есть имя свойства, с помощью опции "-property". Например, код для поиска объектов со свойством "meshstyle":

findobj ("-property", "meshstyle")

Примечание по реализации: поиск включает только объекты с видимыми дескрипторами (HandleVisibility = "on"). См. findall для поиска всех объектов, включая скрытые.

См. также: findall, allchild, get, set.

h = findall ()

h = findall (prop_name, prop_value, …)

h = findall (prop_name, prop_value, "-logical_op", prop_name, prop_value)

h = findall ("-property", prop_name)

h = findall ("-regexp", prop_name, pattern)

h = findall (hlist, …)

h = findall (hlist, "flat", …)

h = findall (hlist, "-depth", d, …)

Поиск графических объектов, включая скрытые, с заданными свойствами.

Возвращаемое значение h — список дескрипторов найденных графических объектов.

findall выполняет тот же поиск, что и findobj, но включает скрытые объекты (HandleVisibility = "off"). Полное описание см. в findobj.

См. также: findobj, allchild, get, set.