FrameworkContentElement.RegisterName(String, Object) Método

Definição

Fornece um acessador que simplifica o acesso ao método de registro NameScope.

public:
 void RegisterName(System::String ^ name, System::Object ^ scopedElement);
public void RegisterName (string name, object scopedElement);
member this.RegisterName : string * obj -> unit
Public Sub RegisterName (name As String, scopedElement As Object)

Parâmetros

name
String

Nome a ser usado para o mapeamento de nome-objeto especificado.

scopedElement
Object

Objeto para o mapeamento.

Comentários

Esse método é um método de conveniência para chamar RegisterName. A implementação verificará os elementos pai sucessivos até encontrar a implementação aplicável NameScope , que é encontrada encontrando um elemento que implementa INameScope. Para obter mais informações sobre namescopes, consulte Namescopes XAML do WPF.

A chamada RegisterName é necessária para conectar corretamente storyboards de animação para aplicativos quando criados em código. Isso ocorre porque uma das principais propriedades TargetNamedo storyboard usa uma pesquisa de nome em tempo de execução em vez de ser capaz de fazer uma referência a um elemento de destino. Isso é verdadeiro mesmo se esse elemento estiver acessível por referência do código. Para obter mais informações sobre por que você precisa registrar nomes para destinos de storyboard, consulte Visão geral de Storyboards. Animações para elementos de conteúdo são menos comuns do que animações em controles, a visão geral de Storyboards se concentra em cenários de controle.

Aplica-se a

Confira também