Command.validateInputs Event

Gets an event that is fired to allow you to check if the current state of the inputs are valid for execution.

The timing of this event is indeterminate and not always tied to the editing of an input. There are cases where this isn't fired when an input is edited. This happens when an input is able to validate its content on its own. For example, if you enter an invalid value for a ValueCommandInput, it can evaluate this on its own, and as a result, the validate inputs event is not fired. Fusion will sometimes fire this event at other random times that are not tied to the edit of an input.

If you want to be notified when an input changes, you should use the input changed event instead.

Python Using fusion360utils
Python
C++

-------- Import ---------

# Import fusion360utils folder, which includes event_utils.py.
from ...lib import fusion360utils as futil

-------- Global variables ---------

# Global variable used to maintain a reference to all event handlers.
local_handlers = []

-------- Connect the handler to the event. ---------

# "command_var" is a variable referencing a Command object.
# "command_validateInputs" is the event handler function.
futil.add_handler(command_var.validateInputs, command_validateInputs, local_handlers=local_handlers)

-------- Event handler function definition ---------

# Event handler for the validateInputs event.
def command_validateInputs(args: adsk.core.ValidateInputsEventArgs):
    # Code to react to the event.
    app.log('In command_validateInputs event handler.')

-------- Global variables ---------

# Global variable used to maintain a reference to all event handlers.
handlers = []

-------- Connect the handler to the event. ---------

# "command_var" is a variable referencing a Command object.
# "MyValidateInputsHandler" is the name of the class that handles the event.
onValidateInputs = MyValidateInputsHandler()
command_var.validateInputs.add(onValidateInputs)
handlers.append(onValidateInputs)

-------- Event handler class definition ---------

# Event handler for the validateInputs event.
class MyValidateInputsHandler(adsk.core.ValidateInputsEventHandler):
    def __init__(self):
        super().__init__()
    def notify(self, args: adsk.core.ValidateInputsEventArgs):
        # Code to react to the event.
        app.log('In MyValidateInputsHandler event handler.')

--------- Required include files. ---------

#include <Core/UserInterface/Command.h>
#include <Core/UserInterface/ValidateInputsEvent.h>
#include <Core/UserInterface/ValidateInputsEventHandler.h>
#include <Core/UserInterface/ValidateInputsEventArgs.h>

--------- Event handler class definition and global declaration. ---------

// Event handler for the validateInputs event.
class MyValidateInputsEventHandler : public adsk::core::ValidateInputsEventHandler
{
public:
    void notify(const Ptr<ValidateInputsEventArgs>& eventArgs) override
    {
        // Code to react to the event.
        ui->messageBox("In MyValidateInputsEventHandler event handler.");
    }
} _validateInputs;

--------- Connect the handler to the event. ---------

// "command_var" is a variable referencing a Command object.
// Connect the handler function to the event.
Ptr<ValidateInputsEvent> validateInputsEvent = command_var->validateInputs();
if (!validateInputsEvent)
    return;

bool isOk = validateInputsEvent->add(&_validateInputs);
if (!isOk)
    return;

Command.validateInputs Event

Description

Syntax

Property Value

Version