Python: documentation about overriding context members.

This commit is contained in:
Brecht Van Lommel
2012-05-02 13:28:13 +00:00
parent 4fd18b5d3c
commit 2151c2f28e
2 changed files with 36 additions and 0 deletions

View File

@@ -0,0 +1,18 @@
"""
Overriding Context
++++++++++++++++++
It is possible to override context members that the operator sees, so that they
act on specified rather than the selected or active data, or to execute an
operator in the different part of the user interface.
The context overrides are passed as a dictionary, with keys matching the context
member names in bpy.context. For example to override bpy.context.active_object,
you would pass {'active_object': object}.
"""
# remove all objects in scene rather than the selected ones
import bpy
override = {'selected_bases': list(bpy.context.scene.object_bases)}
bpy.ops.object.delete(override)

View File

@@ -0,0 +1,18 @@
"""
It is also possible to run an operator in a particular part of the user
interface. For this we need to pass the window, screen, area and sometimes
a region.
"""
# maximize 3d view in all windows
import bpy
for window in bpy.context.window_manager.windows:
screen = window.screen
for area in screen.areas:
if area.type == 'VIEW_3D':
override = {'window': window, 'screen': screen, 'area': area}
bpy.ops.screen.screen_full_area(override)
break