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". Пример кода для поиска всех объектов типа figure и axes:

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.