IDS peak genericC++  v1.7.2
peak::core::nodes::EnumerationNode Class Reference

Represents a GenAPI enumeration node. More...

#include <peak/node_map/peak_enumeration_node.hpp>

Inheritance diagram for peak::core::nodes::EnumerationNode:
peak::core::nodes::Node

Public Member Functions

 EnumerationNode ()=delete
 
 ~EnumerationNode () override=default
 
 EnumerationNode (const EnumerationNode &other)=delete
 
EnumerationNode & operator= (const EnumerationNode &other)=delete
 
 EnumerationNode (EnumerationNode &&other)=delete
 
EnumerationNode & operator= (EnumerationNode &&other)=delete
 
std::shared_ptr< EnumerationEntryNode > CurrentEntry (NodeCacheUsePolicy cacheUsePolicy=NodeCacheUsePolicy::UseCache) const
 Returns the current entry. More...
 
void SetCurrentEntry (const std::shared_ptr< EnumerationEntryNode > &entry)
 Sets the current entry. More...
 
void SetCurrentEntry (const std::string &symbolicValue)
 Sets the current entry to an entry with the given symbolic value. More...
 
void SetCurrentEntry (int64_t value)
 Sets the current entry to an entry with the given value. More...
 
std::shared_ptr< EnumerationEntryNode > FindEntry (const std::string &symbolicValue) const
 Tries to find a entry with the given symbolic value. More...
 
std::shared_ptr< EnumerationEntryNode > FindEntry (int64_t value) const
 Tries to find a entry with the given numeric value. More...
 
std::vector< std::shared_ptr< EnumerationEntryNode > > Entries () const
 Returns the entries. More...
 
- Public Member Functions inherited from peak::core::nodes::Node
 Node ()=delete
 
virtual ~Node ()
 
 Node (const Node &other)=delete
 
Node & operator= (const Node &other)=delete
 
 Node (Node &&other)=delete
 
Node & operator= (Node &&other)=delete
 
std::string Name () const
 Returns the name. More...
 
std::string DisplayName () const
 Returns the display name. More...
 
NodeNamespace Namespace () const
 Returns the namespace the node belongs to. More...
 
NodeVisibility Visibility () const
 Returns the visibility. More...
 
NodeAccessStatus AccessStatus () const
 Returns the access status. More...
 
bool IsCacheable () const
 Checks whether the node is cacheable. More...
 
bool IsAccessStatusCacheable () const
 Checks whether the node's access status is cacheable. More...
 
bool IsStreamable () const
 Checks whether the node is streamable. More...
 
bool IsDeprecated () const
 Checks whether the node is deprecated. More...
 
bool IsFeature () const
 Checks whether the node is a feature, i.e. it can be reached via category nodes from a category node named "Root". More...
 
NodeCachingMode CachingMode () const
 Returns the caching mode. More...
 
int64_t PollingTime () const
 Returns the polling time. More...
 
std::string ToolTip () const
 Returns the tool tip. More...
 
std::string Description () const
 Returns the description. More...
 
NodeType Type () const
 Returns the type. More...
 
std::shared_ptr< NodeMap > ParentNodeMap () const
 Returns the parent node map. More...
 
std::shared_ptr< Node > FindInvalidatedNode (const std::string &name) const
 Tries to find an invalidated node with the given name. More...
 
template<class NodeType , typename std::enable_if< std::is_base_of< Node, NodeType >::value, int >::type = 0>
std::shared_ptr< NodeType > FindInvalidatedNode (const std::string &name) const
 Tries to find an invalidated node with the given name and type. More...
 
std::vector< std::shared_ptr< Node > > InvalidatedNodes () const
 Returns the invalidated nodes. More...
 
std::shared_ptr< Node > FindInvalidatingNode (const std::string &name) const
 Tries to find an invalidating node with the given name. More...
 
template<class NodeType , typename std::enable_if< std::is_base_of< Node, NodeType >::value, int >::type = 0>
std::shared_ptr< NodeType > FindInvalidatingNode (const std::string &name) const
 Tries to find an invalidating node with the given name and type. More...
 
std::vector< std::shared_ptr< Node > > InvalidatingNodes () const
 Returns the invalidating nodes. More...
 
std::shared_ptr< Node > FindSelectedNode (const std::string &name) const
 Tries to find a selected node with the given name. More...
 
template<class NodeType , typename std::enable_if< std::is_base_of< Node, NodeType >::value, int >::type = 0>
std::shared_ptr< NodeType > FindSelectedNode (const std::string &name) const
 Tries to find a selected node with the given name and type. More...
 
std::vector< std::shared_ptr< Node > > SelectedNodes () const
 Returns the selected nodes. More...
 
std::shared_ptr< Node > FindSelectingNode (const std::string &name) const
 Tries to find a selecting node with the given name. More...
 
template<class NodeType , typename std::enable_if< std::is_base_of< Node, NodeType >::value, int >::type = 0>
std::shared_ptr< NodeType > FindSelectingNode (const std::string &name) const
 Tries to find a selecting node with the given name and type. More...
 
std::vector< std::shared_ptr< Node > > SelectingNodes () const
 Returns the selecting nodes. More...
 
ChangedCallbackHandle RegisterChangedCallback (const ChangedCallback &callback)
 Registers a callback for signaling a change to the node. More...
 
void UnregisterChangedCallback (ChangedCallbackHandle callbackHandle)
 Unregisters a changed callback. More...
 

Additional Inherited Members

- Public Types inherited from peak::core::nodes::Node
using ChangedCallback = std::function< void(const std::shared_ptr< Node > &changedNode)>
 
using ChangedCallbackHandle = ChangedCallback *
 

Detailed Description

Represents a GenAPI enumeration node.

Constructor & Destructor Documentation

◆ EnumerationNode() [1/3]

peak::core::nodes::EnumerationNode::EnumerationNode ( )
delete

◆ ~EnumerationNode()

peak::core::nodes::EnumerationNode::~EnumerationNode ( )
overridedefault

◆ EnumerationNode() [2/3]

peak::core::nodes::EnumerationNode::EnumerationNode ( const EnumerationNode &  other)
delete

◆ EnumerationNode() [3/3]

peak::core::nodes::EnumerationNode::EnumerationNode ( EnumerationNode &&  other)
delete

Member Function Documentation

◆ CurrentEntry()

std::shared_ptr< EnumerationEntryNode > peak::core::nodes::EnumerationNode::CurrentEntry ( NodeCacheUsePolicy  cacheUsePolicy = NodeCacheUsePolicy::UseCache) const
inline

Returns the current entry.

Parameters
[in]cacheUsePolicyA flag telling whether the value should be read using the internal cache.
Returns
Current entry
Since
1.0
Exceptions
IOExceptionA communication error has occured, e.g. when the device is disconnected.
InternalErrorExceptionAn internal error has occurred.

◆ Entries()

std::vector< std::shared_ptr< EnumerationEntryNode > > peak::core::nodes::EnumerationNode::Entries ( ) const
inline

Returns the entries.

Returns
Entries
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ FindEntry() [1/2]

std::shared_ptr< EnumerationEntryNode > peak::core::nodes::EnumerationNode::FindEntry ( const std::string &  symbolicValue) const
inline

Tries to find a entry with the given symbolic value.

Parameters
[in]symbolicValueThe symbolic value of the entry to find.
Returns
Found entry.
If no entry with the given name exists, a NotFoundException is thrown.
Since
1.0
Exceptions
NotFoundExceptionThere is no entry with the given name.
InternalErrorExceptionAn internal error has occurred.

◆ FindEntry() [2/2]

std::shared_ptr< EnumerationEntryNode > peak::core::nodes::EnumerationNode::FindEntry ( int64_t  value) const
inline

Tries to find a entry with the given numeric value.

Parameters
[in]valueThe value of the entry to find.
Returns
Found entry.
If no entry with the given numeric value, a NotFoundException is thrown.
Since
1.0
Exceptions
NotFoundExceptionThere is no entry with the given numeric value.
InternalErrorExceptionAn internal error has occurred.

◆ operator=() [1/2]

EnumerationNode& peak::core::nodes::EnumerationNode::operator= ( const EnumerationNode &  other)
delete

◆ operator=() [2/2]

EnumerationNode& peak::core::nodes::EnumerationNode::operator= ( EnumerationNode &&  other)
delete

◆ SetCurrentEntry() [1/3]

void peak::core::nodes::EnumerationNode::SetCurrentEntry ( const std::shared_ptr< EnumerationEntryNode > &  entry)
inline

Sets the current entry.

Parameters
[in]entryThe entry to set as current entry.
Since
1.0
Exceptions
InvalidArgumentExceptionThere is no matching entry in this enumeration node.
IOExceptionA communication error has occured, e.g. when the device is disconnected.
InternalErrorExceptionAn internal error has occurred.

◆ SetCurrentEntry() [2/3]

void peak::core::nodes::EnumerationNode::SetCurrentEntry ( const std::string &  symbolicValue)
inline

Sets the current entry to an entry with the given symbolic value.

Parameters
[in]symbolicValueThe symbolic value of the entry to set.
Since
1.0
Exceptions
InvalidArgumentExceptionThere is no entry with this symbolicValue in this enumeration node.
IOExceptionA communication error has occured, e.g. when the device is disconnected.
InternalErrorExceptionAn internal error has occurred.

◆ SetCurrentEntry() [3/3]

void peak::core::nodes::EnumerationNode::SetCurrentEntry ( int64_t  value)
inline

Sets the current entry to an entry with the given value.

Parameters
[in]valueThe value of the entry to set.
Since
1.0
Exceptions
InvalidArgumentExceptionThere is no entry with this value in this enumeration node.
IOExceptionA communication error has occured, e.g. when the device is disconnected.
InternalErrorExceptionAn internal error has occurred.

The documentation for this class was generated from the following file: