Pylon::IBooleanEx#
#include <pylon/BooleanParameter.h>
Inherits from GenApi::IBoolean, Pylon::IValueEx, GenApi::IValue, GenApi::IBase
Inherited by Pylon::CBooleanParameter
Public Functions#
Name | |
---|---|
virtual bool | TrySetValue(bool value) Sets the Boolean value of the parameter if the parameter is writable. |
virtual bool | GetValueOrDefault(bool defaultValue) Gets the Boolean value of the parameter if the parameter is readable. |
virtual void | SetValue(bool Value, bool Verify =true) Set node value. |
virtual bool | GetValue(bool Verify =false, bool IgnoreCache =false) const Get node value. |
virtual bool | operator()() const Get node value. |
virtual INode * | GetNode() Get the INode interface of the node. |
virtual GenICam::gcstring | ToString(bool Verify =false, bool IgnoreCache =false) Get content of the node as string. |
virtual void | FromString(const GenICam::gcstring & ValueStr, bool Verify =true) Set content of the node as string. |
virtual bool | IsValueCacheValid() const Checks if the value comes from cache or is requested from another node. |
virtual EAccessMode | GetAccessMode() const Get the access mode of the node. |
virtual bool | IsReadable() const Indicates whether the parameter is readable. |
virtual bool | IsWritable() const Indicates whether the parameter is writable. |
virtual bool | IsValid() const Indicates whether a node is attached. |
virtual String_t | GetInfo(EParameterInfo info) Gets the parameter information. |
virtual String_t | GetInfoOrDefault(EParameterInfo info, const String_t defaultInfo) Gets the parameter information if the parameter is attached to a node. |
virtual String_t | ToStringOrDefault(const String_t & defaultValue) Gets the parameter value as string if the parameter is readable. |
Additional inherited members#
Public Functions inherited from GenApi::IBoolean
Name | |
---|---|
virtual void | operator=(bool Value) Set node value. |
Public Functions inherited from GenApi::IBase
Name | |
---|---|
virtual | ~IBase() Virtual destructor enforcing virtual destructor on all derived classes. |
Public Functions Documentation#
TrySetValue#
virtual bool TrySetValue(
bool value
)
Sets the Boolean value of the parameter if the parameter is writable.
Parameters:
- value The Boolean value to set.
Return: Returns false if the parameter is not writable.
Thread Safety:
The method accesses the parameter multiple times. These accesses are not synchronized by a lock.
Error Safety:
Can throw exceptions if the preconditions are not met or if writing the value fails.
Reimplemented by: Pylon::CBooleanParameter::TrySetValue
GetValueOrDefault#
virtual bool GetValueOrDefault(
bool defaultValue
)
Gets the Boolean value of the parameter if the parameter is readable.
Parameters:
- defaultValue The default value returned if the parameter is not readable.
Return: Returns the parameter value if the parameter is readable. Otherwise returns the default value.
Thread Safety:
The method accesses the parameter multiple times. These accesses are not synchronized by a lock.
Error Safety:
Can throw exceptions if reading the value fails.
Reimplemented by: Pylon::CBooleanParameter::GetValueOrDefault
Otherwise returns the default value.
SetValue#
virtual void SetValue(
bool Value,
bool Verify =true
)
Set node value.
Parameters:
- Value The value to set
- Verify Enables AccessMode and Range verification (default = true)
Reimplemented by: Pylon::CBooleanParameter::SetValue
GetValue#
virtual bool GetValue(
bool Verify =false,
bool IgnoreCache =false
) const
Get node value.
Parameters:
- Verify Enables Range verification (default = false). The AccessMode is always checked
- IgnoreCache If true the value is read ignoring any caches (default = false)
Return: The value read
Reimplemented by: Pylon::CBooleanParameter::GetValue
operator()#
inline virtual bool operator()() const
Get node value.
Reimplemented by: Pylon::CBooleanParameter::operator()
GetNode#
inline virtual INode * GetNode()
Get the INode interface of the node.
Reimplemented by: Pylon::CArrayParameter::GetNode
ToString#
virtual GenICam::gcstring ToString(
bool Verify =false,
bool IgnoreCache =false
)
Get content of the node as string.
Parameters:
- Verify Enables Range verification (default = false). The AccessMode is always checked
- IgnoreCache If true the value is read ignoring any caches (default = false)
Return: The value read
Reimplemented by: Pylon::CArrayParameter::ToString
FromString#
virtual void FromString(
const GenICam::gcstring & ValueStr,
bool Verify =true
)
Set content of the node as string.
Parameters:
- ValueStr The value to set
- Verify Enables AccessMode and Range verification (default = true)
Reimplemented by: Pylon::CArrayParameter::FromString
IsValueCacheValid#
virtual bool IsValueCacheValid() const
Checks if the value comes from cache or is requested from another node.
Reimplemented by: Pylon::CArrayParameter::IsValueCacheValid
GetAccessMode#
virtual EAccessMode GetAccessMode() const
Get the access mode of the node.
Reimplemented by: Pylon::CArrayParameter::GetAccessMode
IsReadable#
virtual bool IsReadable() const
Indicates whether the parameter is readable.
Return: Returns true if the parameter is readable.
Error Safety:
Does not throw C++ exceptions.
Reimplemented by: Pylon::CArrayParameter::IsReadable
IsWritable#
virtual bool IsWritable() const
Indicates whether the parameter is writable.
Return: Returns true if the parameter is writable.
Error Safety:
Does not throw C++ exceptions.
Reimplemented by: Pylon::CArrayParameter::IsWritable
IsValid#
virtual bool IsValid() const
Indicates whether a node is attached.
Return: Returns true if a node is attached.
Error Safety:
Does not throw C++ exceptions.
Reimplemented by: Pylon::CArrayParameter::IsValid, Pylon::CCommandParameter::IsValid, Pylon::CBooleanParameter::IsValid, Pylon::CStringParameter::IsValid, Pylon::CParameter::IsValid, Pylon::CEnumParameter::IsValid, Pylon::CIntegerParameter::IsValid, Pylon::CFloatParameter::IsValid
GetInfo#
virtual String_t GetInfo(
EParameterInfo info
)
Gets the parameter information.
Parameters:
- info The type information to return.
Return: Returns the parameter information.
Thread Safety:
The method accesses the parameter multiple times. These accesses are not synchronized by a lock.
Error Safety:
Throws an exception if no node is attached. Can throw exceptions if the retrieval of the information fails.
Reimplemented by: Pylon::CArrayParameter::GetInfo
GetInfoOrDefault#
virtual String_t GetInfoOrDefault(
EParameterInfo info,
const String_t defaultInfo
)
Gets the parameter information if the parameter is attached to a node.
Parameters:
- info The type information to return. Otherwise returns the default information. This method is useful if you want to display parameter information and handle the case that some parameters are not available for a device.
- defaultInfo The default information returned if the parameter is not attached to a node.
Return: Returns the parameter information if the parameter is attached to a node. Otherwise returns the default information.
Thread Safety:
The method accesses the parameter multiple times. These accesses are not synchronized by a lock.
Error Safety:
Can throw exceptions if the retrieval of the information fails.
Reimplemented by: Pylon::CArrayParameter::GetInfoOrDefault
See IsValid().
ToStringOrDefault#
virtual String_t ToStringOrDefault(
const String_t & defaultValue
)
Gets the parameter value as string if the parameter is readable.
Parameters:
- defaultValue The default value returned if the parameter is not readable.
Return: Returns the parameter value if the parameter is readable. Otherwise returns the default value.
Thread Safety:
The method accesses the parameter multiple times. These accesses are not synchronized by a lock.
Error Safety:
Can throw exceptions if reading the value fails.
Reimplemented by: Pylon::CArrayParameter::ToStringOrDefault
Otherwise returns the default value.
Updated on 5 July 2022 at 15:30:00