Method GetValueLabel

cpp/src/Manager.cpp:1730–1771

----------------------------------------------------------------------------- Gets the user-friendly label for the value -----------------------------------------------------------------------------

// Gets the user-friendly label for the value
//-----------------------------------------------------------------------------
string Manager::GetValueLabel
(
		ValueID const& _id,
		int32 _pos
)
{
	string label;
	if( Driver* driver = GetDriver( _id.GetHomeId() ) )
	{
		LockGuard LG(driver->m_nodeMutex);
		if (_pos != -1) {
			if (_id.GetType() != ValueID::ValueType_BitSet) {
				OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "ValueID passed to GetValueLabel is not a BitSet but a position was requested");
				return label;
			}
			ValueBitSet *value = static_cast<ValueBitSet *>(driver->GetValue( _id ));
			label = value->GetBitLabel(_pos);
			value->Release();
			return label;
		} else {
			bool useinstancelabels = true;
			Options::Get()->GetOptionAsBool( "IncludeInstanceLabel", &useinstancelabels );
			Node* node = driver->GetNode( _id.GetNodeId() );
			if ( (useinstancelabels) && ( node ) )
			{
				if ( node->GetNumInstances(_id.GetCommandClassId()) > 1 )
				{
					label = GetInstanceLabel(_id).append(" ");
				}
			}
			if ( Value* value = driver->GetValue( _id ) )
			{

				label.append(value->GetLabel());
				value->Release();
				return label;
			}
		}
		OZW_ERROR(OZWException::OZWEXCEPTION_INVALID_VALUEID, "Invalid ValueID passed to GetValueLabel");
	}
	return label;
}

//-----------------------------------------------------------------------------
// <Manager::SetValueLabel>