I'd like to add a poll function to my BoolProperty, but I don't understand how it works.

Is it similar to the poll function of an operator? What represents the "object" argument of this function?

EDIT after Teck-freak answer:

enter image description here

  • $\begingroup$ There is no poll function for Properties. You can hide the property in the layout or (even better) block the layout (layout.enable=False) so it can be seen but not used. You can also fake the behaviour within the update-funktion, but you'll need a second prop $\endgroup$ – Teck-freak Dec 6 '17 at 23:12
  • $\begingroup$ With respect to your image, that was likely an old version of the API...you should post the link that you used. If you look at the current version (link in my answer), there is no such function. $\endgroup$ – JakeD Dec 7 '17 at 23:29
  • $\begingroup$ The image come from the 2.79 API documentation docs.blender.org/api/2.79/… $\endgroup$ – pistiwique Dec 8 '17 at 13:40

There is no poll function for Properties.

HOWEVER: You can skip the property in the layout or (even better) block the layout (layout.enable=False) so it can be seen but not used. You can also fake the behaviour within the update-funktion, but you'll need a second property. Finally you can define getter, and setter functions for your property.


row = layout.row()
row.enable = False
row.prop(self, 'MyBool') #this will appear grayed out


def get_MyBool(self, context):
    return self.MyBool_internal
def set_MyBool(self, context, value):
    if not self.dont_touch_MyBool:
        self.MyBool_internal = value
MyBool_internal = bpy.props.BoolProperty() # This is where its actually stored
MyBool = bpy.props.BoolProperty( # This is for your user-interface
         name='MyBool', get=get_MyBool, set=set_MyBool)

ABUSING THE UPDATE-FUNCTION: (Documentary only. Avoid if possible.)

def update_MyBool(self, context):
    if self.dont_touch_MyBool: # condition to check if changing mybool is allowed
        self.MyBool = self.MyBool_Backup
        self.MyBool_Backup = self.MyBool
MyBool = bpy.props.BoolProperty(name='MyBool', update=update_MyBool)

You can read more about bpy.props here


Let's say you'd like to define an integer that may NOT accept multiples of 2 or 3.

# this will only be called if a valid entry is made
def upd_MyInt(self, context):
    print('Entry accepted')
# This is where its actually stored
MyInt_Internal = bpy.props.IntProperty()

# This is for your user-interface
def get_MyInt(self, context):
    return self.MyInt_internal
def set_MyInt(self, context, value):
    if value%2 and value%3:
        self.MyInt_internal = value
MyInt = bpy.props.IntProperty(get=get_MyInt, set=set_MyInt)
  • $\begingroup$ Sorry, I misspoke. Speaking of the poll function, I wanted to talk about the function that the poll parameter of the property expects. I edited my post to add an image $\endgroup$ – pistiwique Dec 7 '17 at 6:14
  • $\begingroup$ I have litterally NO IDEA where you got that part. Properties have no poll function . However you can achieve what you want by defining your property with getters, setters, and a second property in the background. If you state more about your goal, I might be able to help you. $\endgroup$ – Teck-freak Dec 7 '17 at 15:05
  • $\begingroup$ It's weird because it's from the Blender API. But it doesn't matter, I sould have to get what I want by "blocking" the layout. Thanks for your help :) $\endgroup$ – pistiwique Dec 7 '17 at 17:53
  • $\begingroup$ @pistiwique Ah I see. 2.79 is fairly new and we tend to program with the second or third-newest version instead, to avoid bugs and crashes. It seems the poll-function would take the object the property binds to as first, and your value as second input. $\endgroup$ – Teck-freak Dec 8 '17 at 23:33
  • $\begingroup$ Just as a side note, the Accepted answer above (Teck freak) gives this error in Blender 2.79: TypeError: set keyword: expected a function taking 2 arguments, not 3 $\endgroup$ – N. Wells Jul 3 '18 at 15:10

From: https://blender.stackexchange.com/a/19431/28015

[P]oll, checked before running the operator, which will never run when poll fails, used to check if an operator can run, menu items will be greyed out and if key bindings should be ignored.

A poll operator method would not make sense for a property. You may be looking for the update method.

update (function) – Function to be called when this value is modified, This function must take 2 values (self, context) and return None. Warning there are no safety checks to avoid infinite recursion.

  • $\begingroup$ Using the poll for pointer properties. $\endgroup$ – batFINGER Jul 3 '18 at 15:41

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.