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.