FrameworkElement.GoToElementStateCore(String, Boolean) Método

Definição

Namespace:

Windows.UI.Xaml

Quando implementado em uma classe derivada, permite a construção por estado de uma árvore visual para um modelo de controle no código, em vez de carregar XAML para todos os estados na inicialização de controle.

protected:
 virtual bool GoToElementStateCore(Platform::String ^ stateName, bool useTransitions) = GoToElementStateCore;

bool GoToElementStateCore(winrt::hstring const& stateName, bool const& useTransitions);

protected virtual bool GoToElementStateCore(string stateName, bool useTransitions);

function goToElementStateCore(stateName, useTransitions)

Protected Overridable Function GoToElementStateCore (stateName As String, useTransitions As Boolean) As Boolean

Parâmetros

stateName

String

Platform::String

winrt::hstring

O estado para fazer a transição.

useTransitions

Boolean

bool

true para usar um VisualTransition para fazer a transição entre estados. false para ignorar o uso de transições e ir diretamente para o estado solicitado. O padrão é false.

Retornos

Boolean

bool

true se o controle fizer a transição com êxito para o novo estado ou se já estiver usando esse estado; caso contrário, false.

Comentários

A implementação padrão de FrameworkElement.GoToElementStateCore fornece o comportamento normal de alteração de estado acessado chamando VisualStateManager.GoToState e também o modelo de controle padrão/comportamento de carregamento de estado visual para qualquer controle XAML. Você só deve substituir FrameworkElement.GoToElementStateCore se estiver preparado para assumir total responsabilidade pela construção da árvore visual para um controle em seu código em tempo de execução. Isso inclui a apresentação de qualquer conteúdo proveniente de propriedades de conteúdo, coleções de elementos filho e assim por diante.

Para a lógica de alteração de estado geral em um controle personalizado, você deve usar VisualStateManager.GoToState. O cenário pretendido para FrameworkElement.GoToElementStateCore é mais limitado, destina-se especificamente a aplicativos ou controles que desejam otimizar o modelo ou a lógica que cria a árvore visual de um ListViewItem ou um GridViewItem e apresenta o conteúdo.

VisualStateManager.GoToState tem uma assinatura ligeiramente diferente porque é uma API de utilitário estático e usa um parâmetro de controle para especificar a qual controle aplicar alterações de estado. FrameworkElement.GoToElementStateCore usa o objeto de chamada para obter essas informações.

Confira também

• GoToState(Control, String, Boolean)
• Animações de storyboard para estados visuais