UILayout(bpy_struct)#

base class — bpy_struct

class bpy.types.UILayout(bpy_struct)#

User interface layout in a panel or header

activate_init#

When true, buttons defined in popups will be activated on first display (use so you can type into a field without having to click on it first)

Type:

boolean, default False

active#
Type:

boolean, default False

active_default#

When true, an operator button defined after this will be activated when pressing return(use with popup dialogs)

Type:

boolean, default False

alert#
Type:

boolean, default False

alignment#
Type:

enum in [‘EXPAND’, ‘LEFT’, ‘CENTER’, ‘RIGHT’], default ‘EXPAND’

direction#
Type:

enum in [‘HORIZONTAL’, ‘VERTICAL’], default ‘HORIZONTAL’, (readonly)

emboss#
  • NORMAL Regular – Draw standard button emboss style.

  • NONE None – Draw only text and icons.

  • PULLDOWN_MENU Pulldown Menu – Draw pulldown menu style.

  • RADIAL_MENU Pie Menu – Draw radial menu style.

  • NONE_OR_STATUS None or Status – Draw with no emboss unless the button has a coloring status like an animation state.

Type:

enum in [‘NORMAL’, ‘NONE’, ‘PULLDOWN_MENU’, ‘RADIAL_MENU’, ‘NONE_OR_STATUS’], default ‘NORMAL’

enabled#

When false, this (sub)layout is grayed out

Type:

boolean, default False

operator_context#
Type:

enum in Operator Context Items, default ‘INVOKE_DEFAULT’

scale_x#

Scale factor along the X for items in this (sub)layout

Type:

float in [0, inf], default 0.0

scale_y#

Scale factor along the Y for items in this (sub)layout

Type:

float in [0, inf], default 0.0

ui_units_x#

Fixed size along the X for items in this (sub)layout

Type:

float in [0, inf], default 0.0

ui_units_y#

Fixed size along the Y for items in this (sub)layout

Type:

float in [0, inf], default 0.0

use_property_decorate#
Type:

boolean, default False

use_property_split#
Type:

boolean, default False

row(align=False, heading='', heading_ctxt='', translate=True)#

Sub-layout. Items placed in this sublayout are placed next to each other in a row.

Parameters:
  • align (boolean, (optional)) – Align buttons to each other

  • heading (string, (optional, never None)) – Heading, Label to insert into the layout for this sub-layout

  • heading_ctxt (string, (optional, never None)) – Override automatic translation context of the given heading

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

Returns:

Sub-layout to put items in

Return type:

UILayout

column(align=False, heading='', heading_ctxt='', translate=True)#

Sub-layout. Items placed in this sublayout are placed under each other in a column.

Parameters:
  • align (boolean, (optional)) – Align buttons to each other

  • heading (string, (optional, never None)) – Heading, Label to insert into the layout for this sub-layout

  • heading_ctxt (string, (optional, never None)) – Override automatic translation context of the given heading

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

Returns:

Sub-layout to put items in

Return type:

UILayout

panel(idname, default_closed=False)#

Creates a collapsable panel. Whether it is open or closed is stored in the region using the given idname. This can only be used when the panel has the full width of the panel region available to it. So it can’t be used in e.g. in a box or columns.

Parameters:
  • idname (string, (never None)) – Identifier of the panel

  • default_closed (boolean, (optional)) – Open by Default, When true, the panel will be open the first time it is shown

Return (layout_header, layout_body):

layout_header, Sub-layout to put items in, UILayout

layout_body, Sub-layout to put items in. Will be none if the panel is collapsed., UILayout

panel_prop(data, property)#

Similar to .panel(…) but instead of storing whether it is open or closed in the region, it is stored in the provided boolean property. This should be used when multiple instances of the same panel can exist. For example one for every item in a collection property or list. This can only be used when the panel has the full width of the panel region available to it. So it can’t be used in e.g. in a box or columns.

Parameters:
  • data (AnyType, (never None)) – Data from which to take the open-state property

  • property (string, (never None)) – Identifier of the boolean property that determines whether the panel is open or closed

Return (layout_header, layout_body):

layout_header, Sub-layout to put items in, UILayout

layout_body, Sub-layout to put items in. Will be none if the panel is collapsed., UILayout

column_flow(columns=0, align=False)#

column_flow

Parameters:
  • columns (int in [0, inf], (optional)) – Number of columns, 0 is automatic

  • align (boolean, (optional)) – Align buttons to each other

Returns:

Sub-layout to put items in

Return type:

UILayout

grid_flow(row_major=False, columns=0, even_columns=False, even_rows=False, align=False)#

grid_flow

Parameters:
  • row_major (boolean, (optional)) – Fill row by row, instead of column by column

  • columns (int in [-inf, inf], (optional)) – Number of columns, positive are absolute fixed numbers, 0 is automatic, negative are automatic multiple numbers along major axis (e.g. -2 will only produce 2, 4, 6 etc. columns for row major layout, and 2, 4, 6 etc. rows for column major layout).

  • even_columns (boolean, (optional)) – All columns will have the same width

  • even_rows (boolean, (optional)) – All rows will have the same height

  • align (boolean, (optional)) – Align buttons to each other

Returns:

Sub-layout to put items in

Return type:

UILayout

box()#

Sublayout (items placed in this sublayout are placed under each other in a column and are surrounded by a box)

Returns:

Sub-layout to put items in

Return type:

UILayout

split(factor=0.0, align=False)#

split

Parameters:
  • factor (float in [0, 1], (optional)) – Percentage, Percentage of width to split at (leave unset for automatic calculation)

  • align (boolean, (optional)) – Align buttons to each other

Returns:

Sub-layout to put items in

Return type:

UILayout

menu_pie()#

Sublayout. Items placed in this sublayout are placed in a radial fashion around the menu center).

Returns:

Sub-layout to put items in

Return type:

UILayout

classmethod icon(data)#

Return the custom icon for this data, use it e.g. to get materials or texture icons.

Parameters:

data (AnyType, (never None)) – Data from which to take the icon

Returns:

Icon identifier

Return type:

int in [0, inf]

classmethod enum_item_name(data, property, identifier)#

Return the UI name for this enum item

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • identifier (string, (never None)) – Identifier of the enum item

Returns:

UI name of the enum item

Return type:

string, (never None)

classmethod enum_item_description(data, property, identifier)#

Return the UI description for this enum item

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • identifier (string, (never None)) – Identifier of the enum item

Returns:

UI description of the enum item

Return type:

string, (never None)

classmethod enum_item_icon(data, property, identifier)#

Return the icon for this enum item

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • identifier (string, (never None)) – Identifier of the enum item

Returns:

Icon identifier

Return type:

int in [0, inf]

prop(data, property, text='', text_ctxt='', translate=True, icon='NONE', placeholder='', expand=False, slider=False, toggle=-1, icon_only=False, event=False, full_event=False, emboss=True, index=-1, icon_value=0, invert_checkbox=False)#

Item. Exposes an RNA item and places it into the layout.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

  • placeholder (string, (optional)) – Hint describing the expected value when empty

  • expand (boolean, (optional)) – Expand button to show more detail

  • slider (boolean, (optional)) – Use slider widget for numeric values

  • toggle (int in [-1, 1], (optional)) – Use toggle widget for boolean values, or a checkbox when disabled (the default is -1 which uses toggle only when an icon is displayed)

  • icon_only (boolean, (optional)) – Draw only icons in buttons, no text

  • event (boolean, (optional)) – Use button to input key events

  • full_event (boolean, (optional)) – Use button to input full events including modifiers

  • emboss (boolean, (optional)) – Draw the button itself, not just the icon/text. When false, corresponds to the ‘NONE_OR_STATUS’ layout emboss type.

  • index (int in [-2, inf], (optional)) – The index of this button, when set a single member of an array can be accessed, when set to -1 all array members are used

  • icon_value (int in [0, inf], (optional)) – Icon Value, Override automatic icon of the item

  • invert_checkbox (boolean, (optional)) – Draw checkbox value inverted

props_enum(data, property)#

props_enum

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

prop_menu_enum(data, property, text='', text_ctxt='', translate=True, icon='NONE')#

prop_menu_enum

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

prop_with_popover(data, property, text="", text_ctxt="", translate=True, icon='NONE', icon_only=False, panel)#

prop_with_popover

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

  • icon_only (boolean, (optional)) – Draw only icons in tabs, no text

  • panel (string, (never None)) – Identifier of the panel

prop_with_menu(data, property, text="", text_ctxt="", translate=True, icon='NONE', icon_only=False, menu)#

prop_with_menu

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

  • icon_only (boolean, (optional)) – Draw only icons in tabs, no text

  • menu (string, (never None)) – Identifier of the menu

prop_tabs_enum(data, property, data_highlight=None, property_highlight='', icon_only=False)#

prop_tabs_enum

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • data_highlight (AnyType, (optional, never None)) – Data from which to take highlight property

  • property_highlight (string, (optional, never None)) – Identifier of highlight property in data

  • icon_only (boolean, (optional)) – Draw only icons in tabs, no text

prop_enum(data, property, value, text='', text_ctxt='', translate=True, icon='NONE')#

prop_enum

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • value (string, (never None)) – Enum property value

  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

prop_search

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • search_data (AnyType, (never None)) – Data from which to take collection to search in

  • search_property (string, (never None)) – Identifier of search collection property

  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

  • results_are_suggestions (boolean, (optional)) – Accept inputs that do not match any item

prop_decorator(data, property, index=-1)#

prop_decorator

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • index (int in [-2, inf], (optional)) – The index of this button, when set a single member of an array can be accessed, when set to -1 all array members are used

operator(operator, text='', text_ctxt='', translate=True, icon='NONE', emboss=True, depress=False, icon_value=0, search_weight=0.0)#

Item. Places a button into the layout to call an Operator.

Parameters:
  • operator (string, (never None)) – Identifier of the operator

  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

  • emboss (boolean, (optional)) – Draw the button itself, not just the icon/text

  • depress (boolean, (optional)) – Draw pressed in

  • icon_value (int in [0, inf], (optional)) – Icon Value, Override automatic icon of the item

  • search_weight (float in [-inf, inf], (optional)) – Search Weight, Influences the sorting when using menu-seach

Returns:

Operator properties to fill in

Return type:

OperatorProperties

operator_menu_hold(operator, text="", text_ctxt="", translate=True, icon='NONE', emboss=True, depress=False, icon_value=0, menu)#

Item. Places a button into the layout to call an Operator.

Parameters:
  • operator (string, (never None)) – Identifier of the operator

  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

  • emboss (boolean, (optional)) – Draw the button itself, not just the icon/text

  • depress (boolean, (optional)) – Draw pressed in

  • icon_value (int in [0, inf], (optional)) – Icon Value, Override automatic icon of the item

  • menu (string, (never None)) – Identifier of the menu

Returns:

Operator properties to fill in

Return type:

OperatorProperties

operator_enum(operator, property, icon_only=False)#

operator_enum

Parameters:
  • operator (string, (never None)) – Identifier of the operator

  • property (string, (never None)) – Identifier of property in operator

  • icon_only (boolean, (optional)) – Draw only icons in buttons, no text

operator_menu_enum(operator, property, text='', text_ctxt='', translate=True, icon='NONE')#

operator_menu_enum

Parameters:
  • operator (string, (never None)) – Identifier of the operator

  • property (string, (never None)) – Identifier of property in operator

  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

Returns:

Operator properties to fill in

Return type:

OperatorProperties

label(text='', text_ctxt='', translate=True, icon='NONE', icon_value=0)#

Item. Displays text and/or icon in the layout.

Parameters:
  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

  • icon_value (int in [0, inf], (optional)) – Icon Value, Override automatic icon of the item

menu(menu, text='', text_ctxt='', translate=True, icon='NONE', icon_value=0)#

menu

Parameters:
  • menu (string, (never None)) – Identifier of the menu

  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

  • icon_value (int in [0, inf], (optional)) – Icon Value, Override automatic icon of the item

menu_contents(menu)#

menu_contents

Parameters:

menu (string, (never None)) – Identifier of the menu

popover(panel, text='', text_ctxt='', translate=True, icon='NONE', icon_value=0)#

popover

Parameters:
  • panel (string, (never None)) – Identifier of the panel

  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

  • icon_value (int in [0, inf], (optional)) – Icon Value, Override automatic icon of the item

popover_group(space_type, region_type, context, category)#

popover_group

Parameters:
  • space_type (enum in Space Type Items) – Space Type

  • region_type (enum in Region Type Items) – Region Type

  • context (string, (never None)) – panel type context

  • category (string, (never None)) – panel type category

separator(factor=1.0, type='AUTO')#

Item. Inserts empty space into the layout between items.

Parameters:
  • factor (float in [0, inf], (optional)) – Percentage, Percentage of width to space (leave unset for default space)

  • type (enum in ['AUTO', 'SPACE', 'LINE'], (optional)) –

    Type, The type of the separator

    • AUTO Auto – Best guess at what type of separator is needed..

    • SPACE Empty space – Horizontal or Vertical empty space, depending on layout direction..

    • LINE Line – Horizontal or Vertical line, depending on layout direction..

separator_spacer()#

Item. Inserts horizontal spacing empty space into the layout between items.

progress(text='', text_ctxt='', translate=True, factor=0.0, type='BAR')#

Progress indicator

Parameters:
  • text (string, (optional)) – Override automatic text of the item

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

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

  • factor (float in [0, 1], (optional)) – Factor, Amount of progress from 0.0f to 1.0f

  • type (enum in ['BAR', 'RING'], (optional)) – Type, The type of progress indicator

context_pointer_set(name, data)#

context_pointer_set

Parameters:
  • name (string, (never None)) – Name, Name of entry in the context

  • data (AnyType) – Pointer to put in context

context_string_set(name, value)#

context_string_set

Parameters:
  • name (string, (never None)) – Name, Name of entry in the context

  • value (string, (never None)) – Value, String to put in context

template_header()#

Inserts common Space header UI (editor type selector)

template_ID(data, property, new='', open='', unlink='', filter='ALL', live_icon=False, text='', text_ctxt='', translate=True)#

template_ID

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • new (string, (optional, never None)) – Operator identifier to create a new ID block

  • open (string, (optional, never None)) – Operator identifier to open a file for creating a new ID block

  • unlink (string, (optional, never None)) – Operator identifier to unlink the ID block

  • filter (enum in ['ALL', 'AVAILABLE'], (optional)) – Optionally limit the items which can be selected

  • live_icon (boolean, (optional)) – Show preview instead of fixed icon

  • text (string, (optional)) – Override automatic text of the item

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

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

template_ID_preview(data, property, new='', open='', unlink='', rows=0, cols=0, filter='ALL', hide_buttons=False)#

template_ID_preview

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • new (string, (optional, never None)) – Operator identifier to create a new ID block

  • open (string, (optional, never None)) – Operator identifier to open a file for creating a new ID block

  • unlink (string, (optional, never None)) – Operator identifier to unlink the ID block

  • rows (int in [0, inf], (optional)) – Number of thumbnail preview rows to display

  • cols (int in [0, inf], (optional)) – Number of thumbnail preview columns to display

  • filter (enum in ['ALL', 'AVAILABLE'], (optional)) – Optionally limit the items which can be selected

  • hide_buttons (boolean, (optional)) – Show only list, no buttons

template_any_ID(data, property, type_property, text='', text_ctxt='', translate=True)#

template_any_ID

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • type_property (string, (never None)) – Identifier of property in data giving the type of the ID-blocks to use

  • text (string, (optional)) – Override automatic text of the item

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

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

template_ID_tabs(data, property, new='', menu='', filter='ALL')#

template_ID_tabs

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • new (string, (optional, never None)) – Operator identifier to create a new ID block

  • menu (string, (optional, never None)) – Context menu identifier

  • filter (enum in ['ALL', 'AVAILABLE'], (optional)) – Optionally limit the items which can be selected

template_action(id, new='', unlink='', text='', text_ctxt='', translate=True)#

template_action

Parameters:
  • id (ID, (never None)) – The data-block for which to select an Action

  • new (string, (optional, never None)) – Operator identifier to create a new ID block

  • unlink (string, (optional, never None)) – Operator identifier to unlink the ID block

  • text (string, (optional)) – Override automatic text of the item

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

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

template_search

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • search_data (AnyType, (never None)) – Data from which to take collection to search in

  • search_property (string, (never None)) – Identifier of search collection property

  • new (string, (optional, never None)) – Operator identifier to create a new item for the collection

  • unlink (string, (optional, never None)) – Operator identifier to unlink or delete the active item from the collection

  • text (string, (optional)) – Override automatic text of the item

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

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

template_search_preview(data, property, search_data, search_property, new='', unlink='', text='', text_ctxt='', translate=True, rows=0, cols=0)#

template_search_preview

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • search_data (AnyType, (never None)) – Data from which to take collection to search in

  • search_property (string, (never None)) – Identifier of search collection property

  • new (string, (optional, never None)) – Operator identifier to create a new item for the collection

  • unlink (string, (optional, never None)) – Operator identifier to unlink or delete the active item from the collection

  • text (string, (optional)) – Override automatic text of the item

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

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

  • rows (int in [0, inf], (optional)) – Number of thumbnail preview rows to display

  • cols (int in [0, inf], (optional)) – Number of thumbnail preview columns to display

template_path_builder(data, property, root, text='', text_ctxt='', translate=True)#

template_path_builder

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • root (ID) – ID-block from which path is evaluated from

  • text (string, (optional)) – Override automatic text of the item

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

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

template_modifiers()#

Generates the UI layout for the modifier stack

template_collection_exporters()#

Generates the UI layout for collection exporters

template_constraints(use_bone_constraints=True)#

Generates the panels for the constraint stack

Parameters:

use_bone_constraints (boolean, (optional)) – Add panels for bone constraints instead of object constraints

template_shaderfx()#

Generates the panels for the shader effect stack

template_greasepencil_color(data, property, rows=0, cols=0, scale=1.0, filter='ALL')#

template_greasepencil_color

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • rows (int in [0, inf], (optional)) – Number of thumbnail preview rows to display

  • cols (int in [0, inf], (optional)) – Number of thumbnail preview columns to display

  • scale (float in [0.1, 1.5], (optional)) – Scale of the image thumbnails

  • filter (enum in ['ALL', 'AVAILABLE'], (optional)) – Optionally limit the items which can be selected

template_constraint_header(data)#

Generates the header for constraint panels

Parameters:

data (Constraint, (never None)) – Constraint data

template_preview(id, show_buttons=True, parent=None, slot=None, preview_id='')#

Item. A preview window for materials, textures, lights or worlds.

Parameters:
  • id (ID) – ID data-block

  • show_buttons (boolean, (optional)) – Show preview buttons?

  • parent (ID, (optional)) – ID data-block

  • slot (TextureSlot, (optional)) – Texture slot

  • preview_id (string, (optional, never None)) – Identifier of this preview widget, if not set the ID type will be used (i.e. all previews of materials without explicit ID will have the same size…).

template_curve_mapping(data, property, type='NONE', levels=False, brush=False, use_negative_slope=False, show_tone=False)#

Item. A curve mapping widget used for e.g falloff curves for lights.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • type (enum in ['NONE', 'VECTOR', 'COLOR', 'HUE'], (optional)) – Type, Type of curves to display

  • levels (boolean, (optional)) – Show black/white levels

  • brush (boolean, (optional)) – Show brush options

  • use_negative_slope (boolean, (optional)) – Use a negative slope by default

  • show_tone (boolean, (optional)) – Show tone options

template_curveprofile(data, property)#

A profile path editor used for custom profiles

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_color_ramp(data, property, expand=False)#

Item. A color ramp widget.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • expand (boolean, (optional)) – Expand button to show more detail

template_icon(icon_value, scale=1.0)#

Display a large icon

Parameters:
  • icon_value (int in [0, inf]) – Icon to display

  • scale (float in [1, 100], (optional)) – Scale, Scale the icon size (by the button size)

template_icon_view(data, property, show_labels=False, scale=6.0, scale_popup=5.0)#

Enum. Large widget showing Icon previews.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • show_labels (boolean, (optional)) – Show enum label in preview buttons

  • scale (float in [1, 100], (optional)) – UI Units, Scale the button icon size (by the button size)

  • scale_popup (float in [1, 100], (optional)) – Scale, Scale the popup icon size (by the button size)

template_histogram(data, property)#

Item. A histogramm widget to analyze imaga data.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_waveform(data, property)#

Item. A waveform widget to analyze imaga data.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_vectorscope(data, property)#

Item. A vectorscope widget to analyze imaga data.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_layers(data, property, used_layers_data, used_layers_property, active_layer)#

template_layers

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • used_layers_data (AnyType) – Data from which to take property

  • used_layers_property (string, (never None)) – Identifier of property in data

  • active_layer (int in [0, inf]) – Active Layer

template_color_picker(data, property, value_slider=False, lock=False, lock_luminosity=False, cubic=False)#

Item. A color wheel widget to pick colors.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • value_slider (boolean, (optional)) – Display the value slider to the right of the color wheel

  • lock (boolean, (optional)) – Lock the color wheel display to value 1.0 regardless of actual color

  • lock_luminosity (boolean, (optional)) – Keep the color at its original vector length

  • cubic (boolean, (optional)) – Cubic saturation for picking values close to white

template_palette(data, property, color=False)#

Item. A palette used to pick colors.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • color (boolean, (optional)) – Display the colors as colors or values

template_image_layers(image, image_user)#

template_image_layers

template_image(data, property, image_user, compact=False, multiview=False)#

Item(s). User interface for selecting images and their source paths.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • compact (boolean, (optional)) – Use more compact layout

  • multiview (boolean, (optional)) – Expose Multi-View options

template_image_settings(image_settings, color_management=False)#

User interface for setting image format options

Parameters:

color_management (boolean, (optional)) – Show color management settings

template_image_stereo_3d(stereo_3d_format)#

User interface for setting image stereo 3d options

template_image_views(image_settings)#

User interface for setting image views output options

template_movieclip(data, property, compact=False)#

Item(s). User interface for selecting movie clips and their source paths.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • compact (boolean, (optional)) – Use more compact layout

template_track(data, property)#

Item. A movie-track widget to preview tracking image.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_marker(data, property, clip_user, track, compact=False)#

Item. A widget to control single marker settings.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

  • compact (boolean, (optional)) – Use more compact layout

template_movieclip_information(data, property, clip_user)#

Item. Movie clip information data.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_list(listtype_name, list_id, dataptr, propname, active_dataptr, active_propname, item_dyntip_propname='', rows=5, maxrows=5, type='DEFAULT', columns=9, sort_reverse=False, sort_lock=False)#

Item. A list widget to display data, e.g. vertexgroups.

Parameters:
  • listtype_name (string, (never None)) – Identifier of the list type to use

  • list_id (string, (never None)) – Identifier of this list widget. Necessary to tell apart different list widgets. Mandatory when using default “UI_UL_list” class. If this not an empty string, the uilist gets a custom ID, otherwise it takes the name of the class used to define the uilist (for example, if the class name is “OBJECT_UL_vgroups”, and list_id is not set by the script, then bl_idname = “OBJECT_UL_vgroups”)

  • dataptr (AnyType) – Data from which to take the Collection property

  • propname (string, (never None)) – Identifier of the Collection property in data

  • active_dataptr (AnyType, (never None)) – Data from which to take the integer property, index of the active item

  • active_propname (string, (never None)) – Identifier of the integer property in active_data, index of the active item

  • item_dyntip_propname (string, (optional, never None)) – Identifier of a string property in items, to use as tooltip content

  • rows (int in [0, inf], (optional)) – Default and minimum number of rows to display

  • maxrows (int in [0, inf], (optional)) – Default maximum number of rows to display

  • type (enum in Uilist Layout Type Items, (optional)) – Type, Type of layout to use

  • columns (int in [0, inf], (optional)) – Number of items to display per row, for GRID layout

  • sort_reverse (boolean, (optional)) – Display items in reverse order by default

  • sort_lock (boolean, (optional)) – Lock display order to default value

template_running_jobs()#

template_running_jobs

template_operator_search

template_menu_search

template_header_3D_mode()#
template_edit_mode_selection()#

Inserts common 3DView Edit modes header UI (selector for selection mode)

template_reports_banner()#

template_reports_banner

template_input_status()#

template_input_status

template_status_info()#

template_status_info

template_node_link

template_node_view(ntree, node, socket)#

template_node_view

template_node_asset_menu_items(catalog_path='')#

template_node_asset_menu_items

template_modifier_asset_menu_items(catalog_path='')#

template_modifier_asset_menu_items

template_node_operator_asset_menu_items(catalog_path='')#

template_node_operator_asset_menu_items

template_node_operator_asset_root_items()#

template_node_operator_asset_root_items

template_texture_user()#

template_texture_user

template_keymap_item_properties(item)#

template_keymap_item_properties

template_component_menu(data, property, name='')#

Item. Display expanded property in a popup menu

Parameters:
  • data (AnyType) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_colorspace_settings(data, property)#

Item. A widget to control input color space settings.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_colormanaged_view_settings(data, property)#

Item. A widget to control color managed view settings.

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_node_socket(color=(0.0, 0.0, 0.0, 1.0))#

Node Socket Icon

Parameters:

color (float array of 4 items in [0, 1], (optional)) – Color

template_cache_file(data, property)#

Item(s). User interface for selecting cache files and their source paths

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_cache_file_velocity(data, property)#

Show cache files velocity properties

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_cache_file_procedural(data, property)#

Show cache files render procedural properties

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_cache_file_time_settings(data, property)#

Show cache files time settings

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_cache_file_layers(data, property)#

Show cache files override layers properties

Parameters:
  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_recent_files(rows=5)#

Show list of recently saved .blend files

Parameters:

rows (int in [1, inf], (optional)) – Maximum number of items to show

Returns:

Number of items drawn

Return type:

int in [0, inf]

template_file_select_path(params)#

Item. A text button to set the active file browser path.

template_event_from_keymap_item(item, text='', text_ctxt='', translate=True)#

Display keymap item as icons/text

Parameters:
  • item (KeyMapItem, (never None)) – Item

  • text (string, (optional)) – Override automatic text of the item

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

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

template_asset_view(list_id, asset_library_dataptr, asset_library_propname, assets_dataptr, assets_propname, active_dataptr, active_propname, filter_id_types={}, display_options={}, activate_operator='', drag_operator='')#

Item. A scrollable list of assets in a grid view

Parameters:
  • list_id (string, (never None)) – Identifier of this asset view. Necessary to tell apart different asset views and to identify an asset view read from a .blend

  • asset_library_dataptr (AnyType, (never None)) – Data from which to take the active asset library property

  • asset_library_propname (string, (never None)) – Identifier of the asset library property

  • assets_dataptr (AnyType, (never None)) – Data from which to take the asset list property

  • assets_propname (string, (never None)) – Identifier of the asset list property

  • active_dataptr (AnyType, (never None)) – Data from which to take the integer property, index of the active item

  • active_propname (string, (never None)) – Identifier of the integer property in active_data, index of the active item

  • filter_id_types (enum set in {}, (optional)) – filter_id_types

  • display_options (enum set in {'NO_NAMES', 'NO_FILTER', 'NO_LIBRARY'}, (optional)) –

    Displaying options for the asset view

    • NO_NAMES Do not display the name of each asset underneath preview images.

    • NO_FILTER Do not display buttons for filtering the available assets.

    • NO_LIBRARY Do not display buttons to choose or refresh an asset library.

  • activate_operator (string, (optional, never None)) – Name of a custom operator to invoke when activating an item

  • drag_operator (string, (optional, never None)) – Name of a custom operator to invoke when starting to drag an item. Never invoked together with the active_operator (if set), it’s either the drag or the activate one

Return (activate_operator_properties, drag_operator_properties):

activate_operator_properties, Operator properties to fill in for the custom activate operator passed to the template, OperatorProperties

drag_operator_properties, Operator properties to fill in for the custom drag operator passed to the template, OperatorProperties

template_light_linking_collection(context_layout, data, property)#

Visualization of a content of a light linking collection

Parameters:
  • context_layout (UILayout, (never None)) – Layout to set active list element as context properties

  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

template_bone_collection_tree()#

Show bone collections tree

template_grease_pencil_layer_tree()#

View of the active grease pencil layer tree

template_node_tree_interface(interface)#

Show a node tree interface

Parameters:

interface (NodeTreeInterface, (never None)) – Node Tree Interface, Interface of a node tree to display

template_node_inputs(node)#

Show a node settings and input socket values

Parameters:

node (Node, (never None)) – Node, Display inputs of this node

template_asset_shelf_popover(asset_shelf, name='', icon='NONE', icon_value=0)#

Create a button to open an asset shelf in a popover

Parameters:
  • asset_shelf (string, (never None)) – Identifier of the asset shelf to display (bl_idname)

  • name (string, (optional)) – Optional name to indicate the active asset

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

  • icon_value (int in [0, inf], (optional)) – Icon Value, Override automatic icon of the item

template_popup_confirm(operator, text='', text_ctxt='', translate=True, icon='NONE', cancel_text='', cancel_default=False)#

Add confirm & cancel buttons into a popup which will close the popup when pressed

Parameters:
  • operator (string, (never None)) – Identifier of the operator

  • text (string, (optional)) – Override automatic text of the item

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

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

  • icon (enum in Icon Items, (optional)) – Icon, Override automatic icon of the item

  • cancel_text (string, (optional, never None)) – Optional text to use for the cancel, not shown when an empty string

  • cancel_default (boolean, (optional)) – Cancel button by default

Returns:

Operator properties to fill in

Return type:

OperatorProperties

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

introspect()#

Return a dictionary containing a textual representation of the UI layout.

Inherited Properties#

Inherited Functions#

References#