GetVariableFromTag Method

IUIAnimationManager::GetVariableFromTag method

Gets the animation variable with the specified tag.

Syntax


HRESULT GetVariableFromTag(
  [in, optional] IUnknown             *object,
  [in]           UINT32               id,
  [out]          IUIAnimationVariable **variable
);

Parameters

object [in, optional]

The object portion of the tag. This parameter can be NULL.

id [in]

The identifier portion of the tag.

variable [out]

The animation variable that matches the specified tag, or NULL if no match is found.

Return value

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. See Windows Animation Error Codes for a list of error codes.

Remarks

A tag is a pairing of an integer identifier (id) with a COM object (object). An application can use tags to identify animation variables and storyboards. NULL is a valid object component of a tag; therefore, the object parameter can be NULL.

Tags are not necessarily unique; this method returns UI_E_AMBIGUOUS_MATCH if more than one animation variable exists with the specified tag.

Requirements

Minimum supported client

Windows 7, Windows Vista and Platform Update for Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

None supported

Header

UIAnimation.h

IDL

UIAnimation.idl

DLL

UIAnimation.dll

See also

IUIAnimationManager
IUIAnimationVariable
IUIAnimationVariable::GetTag
IUIAnimationVariable::SetTag

 

 

Show:
© 2016 Microsoft