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.