When passing an EnumProperty value to the function parameters, just like with direct assignment, we must always specify the value from the constant list exactly, otherwise, Blender will throw an error.
Content on PatreonFor example, specifying an icon for a button in the UI we pass the text identifier to the “icon” parameter of the “layout.operator” function.
|
1 2 3 4 5 |
self.layout.operator( "mesh.primitive_cube_add", icon='ICON', text="" ) |
If it is not correct, Blender throws an error:
TypeError: UILayout.operator(): error with keyword argument “icon” – enum “ICON” not found in (‘NONE’, ‘QUESTION’, ‘ERROR’,…)
All possible identifier values that can be passed in the function parameter can be obtained from the RNA structure.
Let’s define a function that will take three parameters – the type of the object from which the function is called, the name of the function, and the name of the parameter passed to it and will return a list of possible Enum values for this parameter.
|
1 2 3 4 |
import bpy def enum_values(type, func_name, param_name): return [i.identifier for i in type.bl_rna.functions[func_name].parameters[param_name].enum_items] |
Now we can get all the values for the “icon” parameter of the “layout.operator” function:
|
1 2 3 |
print(enum_values(bpy.types.UILayout, 'operator', 'icon')) # ['NONE', 'QUESTION', 'ERROR', 'CANCEL', 'TRIA_RIGHT', ... ] |
and always pass the correct value to the “icon” parameter.