FrameworkContentElement.RegisterName(String, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.