Método IUIAnimationManager::GetStoryboardFromTag (uianimation.h)

Obtém o storyboard com a marca especificada.

Sintaxe

HRESULT GetStoryboardFromTag(
  [in, optional] IUnknown               *object,
  [in]           UINT32                 id,
  [out]          IUIAnimationStoryboard **storyboard
);

Parâmetros

[in, optional] object

A parte do objeto da marca. Este parâmetro pode ser NULL.

[in] id

A parte do identificador da marca.

[out] storyboard

O storyboard que corresponde à marca especificada ou NULL se nenhuma correspondência for encontrada.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Consulte Códigos de erro de animação do Windows para obter uma lista de códigos de erro.

Comentários

Uma marca é um emparelhamento de um identificador inteiro (id) com um objeto COM (objeto). Um aplicativo pode usar marcas para identificar variáveis de animação e storyboards. NULL é um componente de objeto válido de uma marca; portanto, o parâmetro de objeto pode ser NULL.

As marcas não são necessariamente exclusivas; esse método retornará UI_E_AMBIGUOUS_MATCH se houver mais de um storyboard com a marca especificada.

Requisitos

Confira também

IUIAnimationManager

IUIAnimationStoryboard::GetTag

IUIAnimationStoryboard::SetTag