WindowManager(ID)

base classes — bpy_struct, ID

class bpy.types.WindowManager(ID)

Window manager data-block defining open windows and other user interface data

addon_filter

Filter add-ons by category

Type

enum in [], default ‘’

addon_search

Filter by add-on name, author & category

Type

string, default “”, (never None)

addon_support

Display support level

• OFFICIAL Official – Officially supported.

• COMMUNITY Community – Maintained by community developers.

• TESTING Testing – Newly contributed scripts (excluded from release builds).

Type

enum set in {‘OFFICIAL’, ‘COMMUNITY’, ‘TESTING’}, default {‘COMMUNITY’, ‘OFFICIAL’}

asset_path_dummy

Full path to the Blender file containing the active asset

Type

string, default “”, (readonly, never None)

is_interface_locked

If true, the interface is currently locked by a running job and data shouldn’t be modified from application timers. Otherwise, the running job might conflict with the handler causing unexpected results or even crashes

Type

boolean, default False, (readonly)

keyconfigs

Registered key configurations

Type

KeyConfigurations bpy_prop_collection of KeyConfig, (readonly)

operators

Operator registry

Type

bpy_prop_collection of Operator, (readonly)

pose_assets

Type

bpy_prop_collection of AssetHandle, (readonly)

poselib_flipped

Type

boolean, default False

poselib_previous_action

Type

Action

preset_name

Name for new preset

Type

string, default “New Preset”, (never None)

windows

Open windows

Type

bpy_prop_collection of Window, (readonly)

xr_session_settings

Type

XrSessionSettings, (readonly, never None)

xr_session_state

Runtime state information about the VR session

Type

XrSessionState, (readonly)

clipboard

Clipboard text storage.

Type

string

classmethod fileselect_add(operator)

Opens a file selector with an operator. The string properties ‘filepath’, ‘filename’, ‘directory’ and a ‘files’ collection are assigned when present in the operator

Parameters

operator (Operator) – Operator to call

classmethod modal_handler_add(operator)

Add a modal handler to the window manager, for the given modal operator (called by invoke() with self, just before returning {‘RUNNING_MODAL’})

Parameters

operator (Operator) – Operator to call

Returns

Whether adding the handler was successful

Return type

boolean

event_timer_add(time_step, window=None)

Add a timer to the given window, to generate periodic ‘TIMER’ events

Parameters

• time_step (float in [0, inf]) – Time Step, Interval in seconds between timer events

• window (Window, (optional)) – Window to attach the timer to, or None

Return type

Timer

event_timer_remove(timer)

event_timer_remove

classmethod gizmo_group_type_ensure(identifier)

Activate an existing widget group (when the persistent option isn’t set)

Parameters

identifier (string, (never None)) – Gizmo group type name

classmethod gizmo_group_type_unlink_delayed(identifier)

Unlink a widget group (when the persistent option is set)

Parameters

identifier (string, (never None)) – Gizmo group type name

progress_begin(min, max)

Start progress report

Parameters

• min (float in [-inf, inf]) – min, any value in range [0,9999]

• max (float in [-inf, inf]) – max, any value in range [min+1,9998]

progress_update(value)

Update the progress feedback

Parameters

value (float in [-inf, inf]) – value, Any value between min and max as set in progress_begin()

progress_end()

Terminate progress report

classmethod invoke_props_popup(operator, event)

Operator popup invoke (show operator properties and execute it automatically on changes)

Parameters

• operator (Operator) – Operator to call

• event (Event) – Event

Returns

result

Return type

enum set in Operator Return Items

classmethod invoke_props_dialog(operator, width=300)

Operator dialog (non-autoexec popup) invoke (show operator properties and only execute it on click on OK button)

Parameters

• operator (Operator) – Operator to call

• width (int in [0, inf], (optional)) – Width of the popup

Returns

result

Return type

enum set in Operator Return Items

classmethod invoke_search_popup(operator)

Operator search popup invoke which searches values of the operator’s bpy.types.Operator.bl_property (which must be an EnumProperty), executing it on confirmation

Parameters

operator (Operator) – Operator to call

classmethod invoke_popup(operator, width=300)

Operator popup invoke (only shows operator’s properties, without executing it)

Parameters

• operator (Operator) – Operator to call

• width (int in [0, inf], (optional)) – Width of the popup

Returns

result

Return type

enum set in Operator Return Items

classmethod invoke_confirm(operator, event)

Operator confirmation popup (only to let user confirm the execution, no operator properties shown)

Parameters

• operator (Operator) – Operator to call

• event (Event) – Event

Returns

result

Return type

enum set in Operator Return Items

classmethod popmenu_begin__internal(title, icon='NONE')

popmenu_begin__internal

Parameters

icon (enum in Icon Items, (optional)) – icon

Return type

UIPopupMenu, (never None)

classmethod popmenu_end__internal(menu)

popmenu_end__internal

classmethod popover_begin__internal(ui_units_x=0, from_active_button=False)

popover_begin__internal

Parameters

• ui_units_x (int in [0, inf], (optional)) – ui_units_x

• from_active_button (boolean, (optional)) – Use Button, Use the active button for positioning

Return type

UIPopover, (never None)

classmethod popover_end__internal(menu, keymap=None)

popover_end__internal

Parameters

keymap (KeyMap, (optional)) – Key Map, Active key map

classmethod piemenu_begin__internal(title, icon='NONE', event=None)

piemenu_begin__internal

Parameters

icon (enum in Icon Items, (optional)) – icon

Return type

UIPieMenu, (never None)

classmethod piemenu_end__internal(menu)

piemenu_end__internal

classmethod operator_properties_last(operator)

operator_properties_last

Return type

OperatorProperties, (never None)

print_undo_steps()

print_undo_steps

classmethod tag_script_reload()

Tag for refreshing the interface after scripts have been reloaded

popover(draw_func, *, ui_units_x=0, keymap=None, from_active_button=False)

popup_menu(draw_func, *, title='', icon='NONE')

Popup menus can be useful for creating menus without having to register menu classes.

Note that they will not block the scripts execution, so the caller can’t wait for user input.

import bpy


def draw(self, context):
    self.layout.label(text="Hello World")


bpy.context.window_manager.popup_menu(draw, title="Greeting", icon='INFO')

popup_menu_pie(event, draw_func, *, title='', icon='NONE')

classmethod bl_rna_get_subclass(id, default=None)

Parameters

id (string) – The RNA type identifier.

Returns

The RNA type or default when not found.

Return type

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)

Parameters

id (string) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

draw_cursor_add()

Undocumented, consider contributing.

draw_cursor_remove()

Undocumented, consider contributing.

Inherited Properties

bpy_struct.id_data ID.name ID.name_full ID.is_evaluated ID.original ID.users ID.use_fake_user ID.use_extra_user

ID.is_embedded_data ID.tag ID.is_library_indirect ID.library ID.library_weak_reference ID.asset_data ID.override_library ID.preview

Inherited Functions

bpy_struct.as_pointer bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.id_properties_clear bpy_struct.id_properties_ensure bpy_struct.id_properties_ui bpy_struct.is_property_hidden bpy_struct.is_property_overridable_library bpy_struct.is_property_readonly bpy_struct.is_property_set bpy_struct.items bpy_struct.keyframe_delete bpy_struct.keyframe_insert bpy_struct.keys bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.pop bpy_struct.property_overridable_library_set bpy_struct.property_unset

bpy_struct.type_recast bpy_struct.values ID.evaluated_get ID.copy ID.asset_mark ID.asset_clear ID.asset_generate_preview ID.override_create ID.override_hierarchy_create ID.override_template_create ID.user_clear ID.user_remap ID.make_local ID.user_of_id ID.animation_data_create ID.animation_data_clear ID.update_tag ID.preview_ensure ID.bl_rna_get_subclass ID.bl_rna_get_subclass_py

References

BlendData.window_managers

Context.window_manager