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 Radial 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

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', 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

  • 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)

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

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)

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)

separator_spacer()

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

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

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_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

template_search_preview(data, property, search_data, search_property, new='', unlink='', 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

  • 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_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_grease_pencil_modifiers()

Generates the panels for the grease pencil modifier stack

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 (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_node_link

template_node_view(ntree, node, socket)

template_node_view

template_node_asset_menu_items(catalog_path='')

template_node_asset_menu_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 idenify 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

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