CVB++ 14.0
ValueNode Class Reference

Base class for all nodes, that have a value. More...

#include <cvb/genapi/value_node.hpp>

Inherits Node.

Inherited by BooleanNode, CategoryNode, CommandNode, EnumEntryNode, FloatNode, SelectorNode, and StringNode.

Public Member Functions

void Invalidate ()
 Invalidates the values of this node. More...
 
bool IsStreamable () const
 Returns whether this node should be used when saving camera settings. More...
 
virtual String ToString () const
 Returns this node's value as a string representation. More...
 
virtual void FromString (const String &value)
 Sets the value of this node from the string value. More...
 
ReadWriteVerify VerifyMode () const
 Returns how the values in this node are verified. More...
 
void SetVerifyMode (ReadWriteVerify readWriteVerify)
 Sets how values are verified in this node. More...
 
std::chrono::milliseconds PollingTime () const
 Gets the polling time of this value. More...
 
- Public Member Functions inherited from Node
void * Handle () const noexcept
 Classic API node handle. More...
 
String Name () const
 Gets the full name of this node. More...
 
String DisplayName () const
 Gets the display name of this node. More...
 
String ToolTip () const
 Gets the short descriptive text of this node. More...
 
String Description () const
 Gets the long descriptive text of this node. More...
 
Cvb::GenApi::AccessMode AccessMode () const
 Gets the access mode of this node. More...
 
bool IsImplemented () const
 Helper to check whether this node is implemented. More...
 
bool IsAvailable () const
 Helper to check whether this node is available. More...
 
bool IsReadable () const
 Helper to check whether this node is readable. More...
 
bool IsWriteable () const
 Helper to check whether this node is writable. More...
 
Cvb::GenApi::CacheMode CacheMode () const
 Gets the cache mode of this node. More...
 
String EventID () const
 Nodes with an event identifier may become invalidated, if an event / message is delivered from the device. More...
 
bool IsFeature () const
 Returns whether this node is considered a feature node. More...
 
bool IsDeprecated () const
 Gets whether this node is considered deprecated. More...
 
Cvb::GenApi::Visibility Visibility () const
 Gets the complexity level of this node. More...
 
NodePtr AliasNode () const
 Gets the node, that is an alias value for this node. More...
 
EventCookie RegisterEventUpdated (std::function< void(Node &)> handler)
 Register a listener to node updated event. More...
 
void UnregisterEventUpdated (EventCookie eventCookie) noexcept
 Manually unregister a listener to the node updated event. More...
 
NodeMapPtr NodeMap () const noexcept
 Gets the node map this node resides in. More...
 

Detailed Description

Base class for all nodes, that have a value.

Member Function Documentation

◆ FromString()

virtual void FromString ( const String value)
inlinevirtual

Sets the value of this node from the string value.

Parameters
[in]valueNew value as a string.
Exceptions
Anyexception derived from std::exception including CvbException.

Reimplemented in EnumEntryNode, and CategoryNode.

◆ Invalidate()

void Invalidate ( )
inline

Invalidates the values of this node.

Exceptions
Anyexception derived from std::exception including CvbException.

Invalidate deletes all caches for all nodes on which this node depends (value, min, max, increment,...).

◆ IsStreamable()

bool IsStreamable ( ) const
inline

Returns whether this node should be used when saving camera settings.

Returns
True if the node is streamable, otherwise false.
Exceptions
Anyexception derived from std::exception including CvbException.

◆ PollingTime()

std::chrono::milliseconds PollingTime ( ) const
inline

Gets the polling time of this value.

Returns
std::chrono::milliseconds
Exceptions
Anyexception derived from std::exception including CvbException.

If this node is not intended to be polled, a zero time span is returned.

◆ SetVerifyMode()

void SetVerifyMode ( ReadWriteVerify  readWriteVerify)
inline

Sets how values are verified in this node.

Parameters
[in]readWriteVerifyThe new verify mode.
Exceptions
Anyexception derived from std::exception including CvbException.

◆ ToString()

virtual String ToString ( ) const
inlinevirtual

Returns this node's value as a string representation.

Returns
Value as a string.
Exceptions
Anyexception derived from std::exception including CvbException.

◆ VerifyMode()

ReadWriteVerify VerifyMode ( ) const
inline

Returns how the values in this node are verified.

Returns
The current verify mode.
Exceptions
Anyexception derived from std::exception including CvbException.