Property base

PropertyBase ¶

Abstract base class for both Property and PropertyGroup.

Info

PropertyBase is the base class for both Property and PropertyGroup, so PropertyBase attributes and methods are available when working with properties and property groups.

See: https://ae-scripting.docsforadobe.dev/property/propertybase/

Attributes¶

active ¶

active: bool

Same as enabled.

auto_name ¶

auto_name: str

The automatic (display) name derived from match_name.

can_set_enabled ¶

can_set_enabled: bool

True if the enabled attribute value can be set.

This is True for all layers, effect property groups, shape vector groups, and text path options. Read-only.

elided ¶

elided: bool

When True, the property is not shown in the UI. An elided property is still present in the timeline but hidden from view. Read-only.

enabled ¶

enabled = bool('_tdsb', 'enabled', default=True)

Corresponds to the setting of the eyeball icon. Read / Write.

is_effect ¶

is_effect: bool

When True, this property is an effect PropertyGroup. Read-only.

is_mask ¶

is_mask: bool

When True, this property is a mask PropertyGroup. Read-only.

is_modified ¶

is_modified: bool

True if this property has been changed since its creation.

A property is considered modified if its value differs from the default, if it has keyframes, or if an expression is enabled. A property group is modified if any of its children are modified, or if it is an indexed group with children (adding items to an indexed group like Effects or Masks is itself a modification).

is_name_set ¶

is_name_set: bool

True if the name has been explicitly set by the user. Read-only.

match_name ¶

match_name: str

A special name for the property used to build unique naming paths. The match name is not displayed, but you can refer to it in scripts. Every property has a unique match-name identifier. Read-only.

name ¶

name: str

Display name of the property. Read / Write.

parent_property ¶

parent_property: PropertyGroup | None

The parent PropertyGroup of this property, or None for top-level layer property groups. Read-only.

property_depth ¶

property_depth: int

The number of levels of parent groups between this property and the containing layer. The value is 0 for a layer. Read-only.

property_index ¶

property_index: int | None

The 0-based position of this property within its parent group.

Returns None for layers (property depth 0).

Warning

Unlike ExtendScript (1-based), this uses Python's 0-based convention so that group.properties[prop.property_index] works directly.

Read-only.

property_type ¶

property_type: PropertyType

The type of this property. One of PropertyType.PROPERTY, PropertyType.NAMED_GROUP, or PropertyType.INDEXED_GROUP. Read-only.

selected ¶

selected: bool

When True, the property is selected. Read / Write.