Command properties represent an action that can be performed by the device. More...

Inheritance diagram for PropCommand:

Public Member Functions
bool	execute (Error &err=Error::Default())
	Executes the command. More...

bool	isDone (Error &err=Error::Default()) const
	Checks whether a command has finished executing. More...

Public Member Functions inherited from Property
	Property ()=default
	Creates an invalid object.

bool	is_valid () const noexcept
	Checks whether this property is a valid object. More...

bool	operator== (const Property &other) const noexcept
	Checks whether a property object refers to the same property as another property object. More...

bool	operator!= (const Property &other) const noexcept
	Checks whether a property object refers to a different property as another property object. More...

bool	operator< (const Property &other) const noexcept
	Provides an ordering of property objects. More...

PropType	type (Error &err=Error::Default()) const
	Returns the type of the property. More...

std::string	name (Error &err=Error::Default()) const
	Returns the name of the property. More...

bool	isAvailable (Error &err=Error::Default()) const
	Checks whether a property is currently available. More...

bool	isLocked (Error &err=Error::Default()) const
	Checks whether a property is currently locked. More...

bool	isLikelyLockedByStream (Error &err=Error::Default()) const
	Tries to determine whether a property is locked because a data stream is active. More...

bool	isReadOnly (Error &err=Error::Default()) const
	Checks whether a property is read-only. More...

PropVisibility	visibility (Error &err=Error::Default()) const
	Returns a visibility hint for the property. More...

std::string	displayName (Error &err=Error::Default()) const
	Returns the display name of the property. More...

std::string	tooltip (Error &err=Error::Default()) const
	Returns a tooltip for the property. More...

std::string	description (Error &err=Error::Default()) const
	Returns a description for the property. More...

PropCommand	asCommand (Error &err=Error::Default()) const
	Converts this property into a PropCommand. More...

PropInteger	asInteger (Error &err=Error::Default()) const
	Converts this property into a PropInteger. More...

PropBoolean	asBoolean (Error &err=Error::Default()) const
	Converts this property into a PropBoolean. More...

PropFloat	asFloat (Error &err=Error::Default()) const
	Converts this property into a PropFloat. More...

PropString	asString (Error &err=Error::Default()) const
	Converts this property into a PropString. More...

PropEnumeration	asEnumeration (Error &err=Error::Default()) const
	Converts this property into a PropEnumeration. More...

PropEnumEntry	asEnumEntry (Error &err=Error::Default()) const
	Converts this property into a PropEnumEntry. More...

PropRegister	asRegister (Error &err=Error::Default()) const
	Converts this property into a PropRegister. More...

PropCategory	asCategory (Error &=Error::Default()) const
	Converts this property into a PropCategory. More...

NotificationToken	eventAddNotification (NotificationHandler cb, Error &err=Error::Default())
	Registers a new property notification event handler. More...

bool	eventRemoveNotification (NotificationToken token, Error &err=Error::Default())
	Unregisters a previously registered property notification event handler. More...

bool	isSelector (Error &err=Error::Default()) const
	Indicates whether this property's value changes the meaning and/or value of other properties. More...

std::vector< Property >	selectedProperties (Error &err=Error::Default()) const
	Returns the list of properties whose values' meaning depend on this property. More...

Additional Inherited Members
Public Types inherited from Property
using	NotificationHandler = std::function< void(Property &prop)>
	Function prototype for property notification event handlers. More...

using	NotificationToken = void *
	Represents a registered callback. More...

Detailed Description

Command properties represent an action that can be performed by the device.

A common example for a command property is TriggerSoftware.

PropCommand instances are created in two ways:

By converting a Property known to be a command property using Property::asCommand()
By directly querying a typed known property using PropertyMap::findCommand().

Member Function Documentation

◆ execute()

bool execute ( Error & err = Error::Default() )

inline

Executes the command.

Parameters

[out] err Reference to an error handler. See Error Handling for details.

Returns: true on success, otherwise false.
Check the err output parameter for error code and error message.

◆ isDone()

bool isDone ( Error & err = Error::Default() ) const