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’}

addon_tags

Type:

BlExtDummyGroup, (readonly)

asset_path_dummy

Full path to the Blender file containing the active asset

Type:

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

extension_search

Filter by extension name, author & category

Type:

string, default “”, (never None)

extension_show_panel_available

Only show installed extensions

Type:

boolean, default True

extension_show_panel_installed

Only show installed extensions

Type:

boolean, default True

extension_tags

Type:

BlExtDummyGroup, (readonly)

extension_type

Show extensions by type

• ADDON Add-ons – Only show add-ons.

• THEME Themes – Only show themes.

Type:

enum in [‘ADDON’, ‘THEME’], default ‘ADDON’

extensions_blocked

Number of installed extensions which are blocked

Type:

int in [-inf, inf], default 0

extensions_updates

Number of extensions with available update

Type:

int in [-inf, inf], default 0

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)

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:

str

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, title='', confirm_text='', cancel_default=False, text_ctxt='', translate=True)

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

• title (string, (optional, never None)) – Title, Optional text to show as title of the popup

• confirm_text (string, (optional, never None)) – Confirm Text, Optional text to show instead to the default “OK” confirmation button text

• cancel_default (boolean, (optional)) – cancel_default

• text_ctxt (string, (optional)) – Override automatic translation context of the given text

• translate (boolean, (optional)) – Translate the given text, when UI translation is enabled

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, *, title='', message='', confirm_text='', icon='NONE', text_ctxt='', translate=True)

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

Parameters:

• operator (Operator) – Operator to call

• event (Event) – Event

• title (string, (optional, never None)) – Title, Optional text to show as title of the popup

• message (string, (optional, never None)) – Message, Optional first line of content text

• confirm_text (string, (optional, never None)) – Confirm Text, Optional text to show instead to the default “OK” confirmation button text

• icon (enum in ['NONE', 'WARNING', 'QUESTION', 'ERROR', 'INFO'], (optional)) – Icon, Optional icon displayed in the dialog

• text_ctxt (string, (optional)) – Override automatic translation context of the given text

• translate (boolean, (optional)) – Translate the given text, when UI translation is enabled

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 (str) – 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 (str) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

classmethod draw_cursor_add(callback, args, space_type, region_type)

Add a new draw cursor handler to this space type. It will be called every time the cursor for the specified region in the space type will be drawn. Note: All arguments are positional only for now.

Parameters:

• callback (Callable[[Any, ..., tuple[int, int]], Any]) – A function that will be called when the cursor is drawn. It gets the specified arguments as input with the mouse position (tuple) as last argument.

• args (tuple[Any, ...]) – Arguments that will be passed to the callback.

• space_type (str) – The space type the callback draws in; for example VIEW_3D. (bpy.types.Space.type)

• region_type (str) – The region type the callback draws in; usually WINDOW. (bpy.types.Region.type)

Returns:

Handler that can be removed later on.

Return type:

object

classmethod draw_cursor_remove(handler)

Remove a draw cursor handler that was added previously.

Parameters:

handler (object) – The draw cursor handler that should be removed.

Inherited Properties

bpy_struct.id_data ID.name ID.name_full ID.id_type ID.session_uid ID.is_evaluated ID.original ID.users ID.use_fake_user ID.use_extra_user ID.is_embedded_data

ID.is_missing ID.is_runtime_data ID.is_editable 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.rename ID.evaluated_get ID.copy ID.asset_mark ID.asset_clear ID.asset_generate_preview ID.override_create ID.override_hierarchy_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