Partilhar via


AnimatedIcon Classe

Definição

Representa um ícone que exibe e controla um visual que pode animar em resposta à interação do usuário e às alterações de estado visual.

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Source")]
class AnimatedIcon : IconElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Source")]
public class AnimatedIcon : IconElement
Public Class AnimatedIcon
Inherits IconElement
Herança
Atributos

Exemplos

Ponta

Para obter mais informações, diretrizes de design e exemplos de código, consulte ícone animado.

O aplicativo galeria WinUI 3 inclui exemplos interativos da maioria dos controles, recursos e funcionalidades do WinUI 3. Obtenha o aplicativo no da Microsoft Store ou obtenha o código-fonte no gitHub

Adicionar um AnimatedIcon a um botão

Este exemplo demonstra um botão voltar com um ícone de seta para trás que anima quando ocorrem eventos de ponteiro.

  • O AnimatedBackVisualSource é uma animação de seta para trás fornecida pelo WinUI.
  • O FallbackIconSource é usado quando as animações não podem ser reproduzidas.
  • O método UIElement.AddHandler com definido como é usado para eventos que o botão marca como PointerRoutedEventArgs.Handled.
<!-- 
xmlns:animatedvisuals="using:Microsoft.UI.Xaml.Controls.AnimatedVisuals"
-->

<AppBarButton x:Name="BackButton" Label="Back"
              AnimatedIcon.State="Normal"
              PointerEntered="AppBarButton_PointerEntered"
              PointerExited="AppBarButton_PointerExited">
    <AnimatedIcon>
        <animatedvisuals:AnimatedBackVisualSource/>
        <AnimatedIcon.FallbackIconSource>
            <SymbolIconSource Symbol="Back"/>
        </AnimatedIcon.FallbackIconSource>
    </AnimatedIcon>
</AppBarButton>
// Add handlers.
protected override void OnNavigatedTo(NavigationEventArgs e)
{
    SettingsButton.AddHandler(UIElement.PointerPressedEvent, 
        new PointerEventHandler(AppBarButton_PointerPressed), true);
    SettingsButton.AddHandler(UIElement.PointerReleasedEvent, 
        new PointerEventHandler(AppBarButton_PointerReleased), true);
    base.OnNavigatedTo(e);
}

// Remove handlers.
protected override void OnNavigatedFrom(NavigationEventArgs e)
{
    SettingsButton.RemoveHandler(UIElement.PointerPressedEvent, 
        (PointerEventHandler)AppBarButton_PointerPressed);
    SettingsButton.RemoveHandler(UIElement.PointerReleasedEvent, 
        (PointerEventHandler)AppBarButton_PointerReleased);
    base.OnNavigatedFrom(e);
}

private void AppBarButton_PointerEntered(object sender, PointerRoutedEventArgs e)
{
    AnimatedIcon.SetState((UIElement)sender, "PointerOver");
}

private void AppBarButton_PointerPressed(object sender, PointerRoutedEventArgs e)
{
    AnimatedIcon.SetState((UIElement)sender, "Pressed");
}

private void AppBarButton_PointerReleased(object sender, PointerRoutedEventArgs e)
{
    AnimatedIcon.SetState((UIElement)sender, "Normal");
}

private void AppBarButton_PointerExited(object sender, PointerRoutedEventArgs e)
{
    AnimatedIcon.SetState((UIElement)sender, "Normal");
}

Comentários

Defina a propriedade AnimatedIcon.Source para especificar o visual animado para o ícone. O WinUI fornece visuais animados para alguns ícones comuns no namespace Microsoft.UI.Xaml.Controls.AnimatedVisuals.

Em alguns casos, as configurações ou limitações do sistema podem impedir que o ícone seja animado.

  • Se o usuário desativar animações em suas configurações do sistema, AnimatedIcon exibirá o quadro final da transição de estado em que o controle estava.
  • Especifique um FallbackIconSource a ser usado quando não há suporte para animações, como em versões mais antigas do Windows que não dão suporte a animações Lottie.

Animações personalizadas

Você pode criar animações personalizadas para usar como um ícone animado em seu aplicativo. As animações podem ser criadas com adobe AfterEffects, em seguida, você pode usar essa saída com a biblioteca Lottie-Windows para gerar uma classe personalizada que implementa IAnimatedVisualSource2. Você pode usar essa classe como o de origem do para um ícone animado. Para obter mais informações, consulte Usar Lottie para criar conteúdo animado para umAnimatedIcon.

Controlar o estado do ícone animado

Altere a posição de reprodução e o estado da animação definindo a propriedade anexada AnimatedIcon.State. A propriedade state usa um valor de cadeia de caracteres que descreve o estado visual, como "Normal", "PointerOver", ou "Pressed". Você também pode especificar uma transição de estado específica, como "PressedToNormal".

Um ícone animado Origem contém marcadores que mapeiam uma posição na linha do tempo da animação para um estado visual. Os valores de cadeia de caracteres que um Source dá suporte para definir a propriedade anexada State são definidos na coleção Markers. Para obter mais informações, consulte Definir marcadores AnimatedIcon.

Fontes visuais animadas usadas em modelos de controle geralmente têm um conjunto mais complexo de Markers que mapeiam para controlar estados, enquanto visuais animados para uso mais geral geralmente têm um conjunto mais simples de Markers que mapeiam para eventos de ponteiro.

Onde definir o estado

Você pode definir a propriedade no AnimatedIcon ou em um ancestral na árvore XAML. Em ambos os casos, você precisa usar a sintaxe de propriedade anexada, assim:

<AnimatedIcon AnimatedIcon.State="Normal">...</AnimatedIcon>

Importante

Se você adicionar um AnimatedIcon à árvore XAML e definir a propriedade State em um elemento ancestral, a propriedade State deverá ser definida como um valor inicial antes que o ícone animado seja carregado pela primeira vez para que o ícone seja animado. Normalmente, você define o estado inicial em XAML, conforme mostrado aqui.

<StackPanel AnimatedIcon.State="Normal" ...>
   <AnimatedIcon>
       <animatedvisuals:AnimatedBackVisualSource/>
   </AnimatedIcon>
</StackPanel>

Usar estados visuais

Você pode adicionar um à de um controle XAML e usar um VisualStateManager para definir seu estado. Alguns controles, como NavigationViewItem, definem automaticamente o estado para um AnimatedIcon definido como Icon.

Para ver um exemplo que define AnimatedIcon.State em um estado visual de modelo de controle, consulte o modelo padrão para CheckBox. O controle usa o AnimatedAcceptVisualSource para sua marca de seleção. Os setters de estado visual são semelhantes a este:

<VisualState x:Name="CheckedPointerOver">
    ...
    <VisualState.Setters>
        <Setter Target="CheckGlyph.(AnimatedIcon.State)" Value="PointerOverOn"/>
    </VisualState.Setters>
</VisualState>

Manipular eventos de ponteiro

Para fazer o AnimatedIcon responder à interação do usuário, você precisa definir a propriedade anexada AnimatedIcon.State em resposta a alguns eventos de ponteiro. Esta tabela mostra os eventos de ponteiro que você normalmente manipulará e estados comuns que são mapeados para esses eventos. (No entanto, nem todas as fontes de ícone animado serão mapeadas para esses estados exatamente.)

Acontecimento Estado
UIElement.PointerEntered "PointerOver"
UIElement.PointerPressed "Pressed"
UIElement.PointerReleased "Normal"
UIElement.PointerExited "Normal"

Ponta

Se você colocar a AnimatedIcon dentro de um botão ou outro controle que tenha um evento Click, os eventos PointerPressed e PointerReleased serão marcados como PointerRoutedEventArgs.Handled. Para lidar com esses eventos em um botão, use o método UIElement.AddHandler para conectar o manipulador de eventos e especificar handledEventsToo como true. Use UIElement.RemoveHandler para desconectar o manipulador de eventos.

Consulte a seção Exemplos para obter o código de exemplo que demonstra esses manipuladores de eventos.

Propriedades anexadas ao XAML

AnimatedIcon é a classe de serviço de host para uma propriedade anexada XAML.

Para dar suporte ao acesso do processador XAML às propriedades anexadas e também para expor equivalentes obter e definir operações ao código, cada propriedade anexada XAML tem um par de métodos de acessador Get e Set. Outra maneira de obter ou definir o valor no código é usar o sistema de propriedades de dependência, chamando GetValue ou SetValue e passando o campo de identificador como o identificador da propriedade de dependência.

Construtores

AnimatedIcon()

Inicializa uma nova instância da classe AnimatedIcon.

Propriedades

AccessKey

Obtém ou define a chave de acesso (mnemônica) para esse elemento.

(Herdado de UIElement)
AccessKeyScopeOwner

Obtém ou define um elemento de origem que fornece o escopo da chave de acesso para esse elemento, mesmo que ele não esteja na árvore visual do elemento de origem.

(Herdado de UIElement)
ActualHeight

Obtém a altura renderizada de umFrameworkElement . Consulte Comentários.

(Herdado de FrameworkElement)
ActualOffset

Obtém a posição desse UIElement, em relação ao pai, computado durante a passagem de organização do processo de layout.

(Herdado de UIElement)
ActualSize

Obtém o tamanho que esse UIElement computou durante a passagem de organização do processo de layout.

(Herdado de UIElement)
ActualTheme

Obtém o tema da interface do usuário que atualmente é usado pelo elemento, que pode ser diferente do RequestedTheme.

(Herdado de FrameworkElement)
ActualWidth

Obtém a largura renderizada de um FrameworkElement. Consulte Comentários.

(Herdado de FrameworkElement)
AllowDrop

Obtém ou define um valor que determina se esse UIElement pode ser um destino de soltar para fins de operações de arrastar e soltar.

(Herdado de UIElement)
AllowFocusOnInteraction

Obtém ou define um valor que indica se o elemento obtém automaticamente o foco quando o usuário interage com ele.

(Herdado de FrameworkElement)
AllowFocusWhenDisabled

Obtém ou define se um controle desabilitado pode receber o foco.

(Herdado de FrameworkElement)
BaseUri

Obtém um URI (Uniform Resource Identifier) que representa o URI base para um objeto construído por XAML em tempo de carga XAML. Essa propriedade é útil para resolução de URI em tempo de execução.

(Herdado de FrameworkElement)
CacheMode

Obtém ou define um valor que indica que o conteúdo renderizado deve ser armazenado em cache como um bitmap composto quando possível.

(Herdado de UIElement)
CanBeScrollAnchor

Obtém ou define um valor que indica se o UIElement pode ser um candidato para ancoragem de rolagem.

(Herdado de UIElement)
CanDrag

Obtém ou define um valor que indica se o elemento pode ser arrastado como dados em uma operação de arrastar e soltar.

(Herdado de UIElement)
CenterPoint

Obtém ou define o ponto central do elemento, que é o ponto sobre qual rotação ou dimensionamento ocorre. Afeta a posição de renderização do elemento.

(Herdado de UIElement)
Clip

Obtém ou define o RectangleGeometry usado para definir a estrutura de tópicos do conteúdo de um UIElement.

(Herdado de UIElement)
CompositeMode

Obtém ou define uma propriedade que declara modos alternativos de composição e mesclagem para o elemento em seu layout pai e janela. Isso é relevante para elementos envolvidos em uma interface do usuário XAML/Microsoft DirectX mista.

(Herdado de UIElement)
ContextFlyout

Obtém ou define o submenu associado a esse elemento.

(Herdado de UIElement)
DataContext

Obtém ou define o contexto de dados de umFrameworkElement. Um uso comum de um contexto de dados é quando um FrameworkElement usa a extensão de marcação de {Binding} e participa da associação de dados.

(Herdado de FrameworkElement)
DesiredSize

Obtém o tamanho que esse UIElement computado durante a aprovação da medida do processo de layout.

(Herdado de UIElement)
Dispatcher

Sempre retorna null em um aplicativo do SDK de Aplicativo do Windows. Use DispatcherQueue.

(Herdado de DependencyObject)
DispatcherQueue

Obtém o DispatcherQueue ao qual esse objeto está associado. O DispatcherQueue representa uma instalação que pode acessar o DependencyObject no thread da interface do usuário mesmo que o código seja iniciado por um thread que não seja da interface do usuário.

(Herdado de DependencyObject)
ExitDisplayModeOnAccessKeyInvoked

Obtém ou define um valor que especifica se a exibição da chave de acesso é ignorada quando uma chave de acesso é invocada.

(Herdado de UIElement)
FallbackIconSource

Obtém ou define o ícone estático a ser usado quando o ícone animado não puder ser executado.

FallbackIconSourceProperty

Identifica a propriedade de dependência FallbackIconSource.

FlowDirection

Obtém ou define a direção na qual o texto e outros elementos da interface do usuário fluem dentro de qualquer elemento pai que controla seu layout. Essa propriedade pode ser definida como LeftToRight ou RightToLeft. Definir FlowDirection para RightToLeft em qualquer elemento define o alinhamento para a direita, a ordem de leitura para a direita para a esquerda e o layout do controle para fluir da direita para a esquerda.

(Herdado de FrameworkElement)
FocusState

Obtém um valor que especifica se esse controle tem foco e o modo pelo qual o foco foi obtido.

(Herdado de UIElement)
FocusVisualMargin

Obtém ou define a margem externa do visual de foco para um FrameworkElement.

(Herdado de FrameworkElement)
FocusVisualPrimaryBrush

Obtém ou define o pincel usado para desenhar a borda externa de um visual de foco HighVisibility ou Reveal para um FrameworkElement.

(Herdado de FrameworkElement)
FocusVisualPrimaryThickness

Obtém ou define a espessura da borda externa de um visual de foco ou para umFrameworkElement.

(Herdado de FrameworkElement)
FocusVisualSecondaryBrush

Obtém ou define o pincel usado para desenhar a borda interna de um visual de foco ou para umFrameworkElement.

(Herdado de FrameworkElement)
FocusVisualSecondaryThickness

Obtém ou define a espessura da borda interna de um visual de foco ou para umFrameworkElement.

(Herdado de FrameworkElement)
Foreground

Obtém ou define um pincel que descreve a cor do primeiro plano.

(Herdado de IconElement)
Height

Obtém ou define a altura sugerida de umFrameworkElement.

(Herdado de FrameworkElement)
HighContrastAdjustment

Obtém ou define um valor que indica se a estrutura ajusta automaticamente as propriedades visuais do elemento quando os temas de alto contraste estão habilitados.

(Herdado de UIElement)
HorizontalAlignment

Obtém ou define as características de alinhamento horizontal que são aplicadas a um FrameworkElement quando ele é composto em um pai de layout, como um painel ou controle de itens.

(Herdado de FrameworkElement)
IsAccessKeyScope

Obtém ou define um valor que indica se um elemento define seu próprio escopo de chave de acesso.

(Herdado de UIElement)
IsDoubleTapEnabled

Obtém ou define um valor que determina se o evento DoubleTapped pode se originar desse elemento.

(Herdado de UIElement)
IsHitTestVisible

Obtém ou define se a área contida deste UIElement pode retornar valores verdadeiros para teste de ocorrência.

(Herdado de UIElement)
IsHoldingEnabled

Obtém ou define um valor que determina se o evento Holding pode se originar desse elemento.

(Herdado de UIElement)
IsLoaded

Obtém um valor que indica se o elemento foi adicionado à árvore de elementos e está pronto para interação.

(Herdado de FrameworkElement)
IsRightTapEnabled

Obtém ou define um valor que determina se o evento RightTapped pode se originar desse elemento.

(Herdado de UIElement)
IsTabStop

Obtém ou define um valor que indica se um controle está incluído na navegação de tabulação.

(Herdado de UIElement)
IsTapEnabled

Obtém ou define um valor que determina se o evento Tapped pode se originar desse elemento.

(Herdado de UIElement)
KeyboardAcceleratorPlacementMode

Obtém ou define um valor que indica se o controle dica de ferramenta exibe a combinação de teclas para seu acelerador de teclado associado.

(Herdado de UIElement)
KeyboardAcceleratorPlacementTarget

Obtém ou define um valor que indica o controle dica de ferramenta que exibe a combinação de teclas de acelerador.

(Herdado de UIElement)
KeyboardAccelerators

Obtém a coleção de combinações de teclas que invocam uma ação usando o teclado.

Os aceleradores normalmente são atribuídos a botões ou itens de menu.

Exemplo de um menu mostrando aceleradores de teclado para vários itens de menu
exemplo de um menu mostrando aceleradores de teclado para vários itens de menu

(Herdado de UIElement)
KeyTipHorizontalOffset

Obtém ou define um valor que indica o quão à esquerda ou à direita a Dica de Chave é colocada em relação ao UIElement.

(Herdado de UIElement)
KeyTipPlacementMode

Obtém ou define um valor que indica onde a dica de chave de acesso é colocada em relação ao limite do UIElement.

(Herdado de UIElement)
KeyTipTarget

Obtém ou define um valor que indica o elemento direcionado pela dica de chave de acesso.

(Herdado de UIElement)
KeyTipVerticalOffset

Obtém ou define um valor que indica o quanto a dica de chave é colocada para cima ou para baixo em relação ao elemento de interface do usuário.

(Herdado de UIElement)
Language

Obtém ou define informações de linguagem de localização/globalização que se aplicam a um FrameworkElement e também a todos os elementos filho do FrameworkElement atual na representação do objeto e na interface do usuário.

(Herdado de FrameworkElement)
Lights

Obtém a coleção de objetos XamlLight anexados a esse elemento.

(Herdado de UIElement)
ManipulationMode

Obtém ou define o valor ManipulationModes usado para comportamento e interação de UIElement com gestos. Definir esse valor permite lidar com os eventos de manipulação desse elemento no código do aplicativo.

(Herdado de UIElement)
Margin

Obtém ou define a margem externa de umFrameworkElement .

(Herdado de FrameworkElement)
MaxHeight

Obtém ou define a restrição de altura máxima de um FrameworkElement.

(Herdado de FrameworkElement)
MaxWidth

Obtém ou define a restrição de largura máxima de um FrameworkElement.

(Herdado de FrameworkElement)
MinHeight

Obtém ou define a restrição de altura mínima de um FrameworkElement.

(Herdado de FrameworkElement)
MinWidth

Obtém ou define a restrição de largura mínima de um FrameworkElement.

(Herdado de FrameworkElement)
MirroredWhenRightToLeft

Obtém ou define um valor que indica se o ícone é espelhado quando o FlowDirection é RightToLeft.

MirroredWhenRightToLeftProperty

Identifica a propriedade de dependência MirroredWhenRightToLeft.

Name

Obtém ou define o nome de identificação do objeto. Quando um processador XAML cria a árvore de objetos com base na marcação XAML, o código em tempo de execução pode se referir ao objeto declarado por XAML com esse nome.

(Herdado de FrameworkElement)
Opacity

Obtém ou define o grau de opacidade do objeto.

(Herdado de UIElement)
OpacityTransition

Obtém ou define o ScalarTransition que anima as alterações na propriedade Opacity.

(Herdado de UIElement)
Parent

Obtém o objeto pai deste FrameworkElement na árvore de objetos.

(Herdado de FrameworkElement)
PointerCaptures

Obtém o conjunto de todos os ponteiros capturados, representados como valores de ponteiro .

(Herdado de UIElement)
Projection

Obtém ou define a projeção de perspectiva (efeito 3D) a ser aplicada ao renderizar esse elemento.

(Herdado de UIElement)
ProtectedCursor

Obtém ou define o cursor exibido quando o ponteiro está sobre esse elemento. O padrão é nulo, indicando nenhuma alteração no cursor.

(Herdado de UIElement)
RasterizationScale

Obtém um valor que representa o número de pixels brutos (físicos) para cada pixel de exibição.

(Herdado de UIElement)
RenderSize

Obtém o tamanho final de renderização de umUIElement . O uso não é recomendado, consulte Comentários.

(Herdado de UIElement)
RenderTransform

Obtém ou define informações de transformação que afetam a posição de renderização de umUIElement .

(Herdado de UIElement)
RenderTransformOrigin

Obtém ou define o ponto de origem de qualquer possível transformação de renderização declarada por RenderTransform, em relação aos limites do UIElement.

(Herdado de UIElement)
RequestedTheme

Obtém ou define o tema da interface do usuário usado pelo UIElement (e seus elementos filho) para determinação de recursos. O tema da interface do usuário especificado com RequestedTheme pode substituir o RequestedThemeno nível do aplicativo.

(Herdado de FrameworkElement)
Resources

Obtém o dicionário de recursos definido localmente. No XAML, você pode estabelecer itens de recurso como elementos de objeto filho de um elemento de propriedade frameworkElement.Resources, por meio da sintaxe da coleção implícita XAML.

(Herdado de FrameworkElement)
Rotation

Obtém ou define o ângulo da rotação no sentido horário, em graus. Gira em relação ao RotationAxis e ao CenterPoint. Afeta a posição de renderização do elemento.

(Herdado de UIElement)
RotationAxis

Obtém ou define o eixo para girar o elemento ao redor.

(Herdado de UIElement)
RotationTransition

Obtém ou define o ScalarTransition que anima as alterações na propriedade Rotation.

(Herdado de UIElement)
Scale

Obtém ou define a escala do elemento. Dimensiona em relação ao CenterPoint do elemento. Afeta a posição de renderização do elemento.

(Herdado de UIElement)
ScaleTransition

Obtém ou define o Vector3Transition que anima as alterações na propriedade Scale.

(Herdado de UIElement)
Shadow

Obtém ou define o efeito de sombra convertido pelo elemento.

(Herdado de UIElement)
Source

Obtém ou define o visual animado mostrado pelo objeto AnimatedIcon.

SourceProperty

Identifica a propriedade de dependência de origem .

StateProperty

Identifica a propriedade anexada AnimatedIcon.State XAML.

Style

Obtém ou define uma instância Style que é aplicada a esse objeto durante o layout e a renderização.

(Herdado de FrameworkElement)
TabFocusNavigation

Obtém ou define um valor que modifica como o tabbing e TabIndex funcionam para esse controle.

(Herdado de UIElement)
TabIndex

Obtém ou define um valor que determina a ordem na qual os elementos recebem foco quando o usuário navega pelos controles usando a da guia .

(Herdado de UIElement)
Tag

Obtém ou define um valor de objeto arbitrário que pode ser usado para armazenar informações personalizadas sobre esse objeto.

(Herdado de FrameworkElement)
Transform3D

Obtém ou define o efeito de transformação 3D a ser aplicado ao renderizar esse elemento.

(Herdado de UIElement)
TransformMatrix

Obtém ou define a matriz de transformação a ser aplicada ao elemento.

(Herdado de UIElement)
Transitions

Obtém ou define a coleção de elementos de estilo de Transição de que se aplicam a umUIElement .

(Herdado de UIElement)
Translation

Obtém ou define a posição de renderização x, y e z do elemento.

(Herdado de UIElement)
TranslationTransition

Obtém ou define o Vector3Transition que anima as alterações na propriedade Translation.

(Herdado de UIElement)
Triggers

Obtém a coleção de gatilhos para animações definidas para umFrameworkElement. Não é usado com frequência. Consulte Comentários.

(Herdado de FrameworkElement)
UseLayoutRounding

Obtém ou define um valor que determina se a renderização para o objeto e sua subárvore visual deve usar o comportamento de arredondamento que alinha a renderização a pixels inteiros.

(Herdado de UIElement)
UseSystemFocusVisuals

Obtém ou define um valor que indica se o controle usa visuais de foco desenhados pelo sistema ou elementos visuais de foco definidos no modelo de controle.

(Herdado de UIElement)
VerticalAlignment

Obtém ou define as características de alinhamento vertical que são aplicadas a um FrameworkElement quando ele é composto em um objeto pai, como um painel ou controle de itens.

(Herdado de FrameworkElement)
Visibility

Obtém ou define a visibilidade de umUIElement . Um UIElement que não está visível não é renderizado e não comunica seu tamanho desejado para layout.

(Herdado de UIElement)
Width

Obtém ou define a largura de umFrameworkElement.

(Herdado de FrameworkElement)
XamlRoot

Obtém ou define o XamlRoot em que esse elemento está sendo exibido.

(Herdado de UIElement)
XYFocusDown

Obtém ou define o objeto que obtém o foco quando um usuário pressiona para baixo no Teclado Direcional (D-pad) de um controlador de jogo.

(Herdado de UIElement)
XYFocusDownNavigationStrategy

Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação para baixo.

(Herdado de UIElement)
XYFocusKeyboardNavigation

Obtém ou define um valor que habilita ou desabilita a navegação usando as setas direcionais do teclado.

(Herdado de UIElement)
XYFocusLeft

Obtém ou define o objeto que obtém o foco quando um usuário pressiona à esquerda no Painel Direcional (D-pad) de um controlador de jogo.

(Herdado de UIElement)
XYFocusLeftNavigationStrategy

Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação à esquerda.

(Herdado de UIElement)
XYFocusRight

Obtém ou define o objeto que obtém o foco quando um usuário pressiona diretamente no Painel Direcional (D-pad) de um controlador de jogo.

(Herdado de UIElement)
XYFocusRightNavigationStrategy

Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação correta.

(Herdado de UIElement)
XYFocusUp

Obtém ou define o objeto que obtém o foco quando um usuário pressiona o Teclado Direcional (D-pad) de um controlador de jogo.

(Herdado de UIElement)
XYFocusUpNavigationStrategy

Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação para cima.

(Herdado de UIElement)

Propriedades Anexadas

State

Propriedade que o desenvolvedor define em AnimatedIcon.

Métodos

AddHandler(RoutedEvent, Object, Boolean)

Adiciona um manipulador de eventos roteado para um evento roteado especificado, adicionando o manipulador à coleção de manipuladores no elemento atual. Especifique handledEventsToo como true para que o manipulador fornecido seja invocado mesmo se o evento for tratado em outro lugar.

(Herdado de UIElement)
Arrange(Rect)

Posiciona objetos filho e determina um tamanho para um UIElement. Os objetos pai que implementam o layout personalizado para seus elementos filho devem chamar esse método de implementações de substituição de layout para formar uma atualização de layout recursivo.

(Herdado de UIElement)
ArrangeOverride(Size)

Fornece o comportamento da passagem de layout "Organizar". As classes podem substituir esse método para definir seu próprio comportamento de passagem "Organizar".

(Herdado de FrameworkElement)
CancelDirectManipulations()

Cancela o processamento contínuo de manipulação direta (movimento panorâmico/zoom definido pelo sistema) em qualquer ScrollViewer pai que contenha oUIElement atual.

(Herdado de UIElement)
CapturePointer(Pointer)

Define a captura de ponteiro para umUIElement . Uma vez capturado, somente o elemento que tem a captura disparará eventos relacionados ao ponteiro.

(Herdado de UIElement)
ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade de dependência.

(Herdado de DependencyObject)
FindName(String)

Recupera um objeto que tem o nome do identificador especificado.

(Herdado de FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

Habilita uma subclasse UIElement para expor elementos filho que ajudam a resolver o direcionamento de toque.

(Herdado de UIElement)
Focus(FocusState)

Tenta definir o foco para esse elemento.

(Herdado de UIElement)
GetAnimationBaseValue(DependencyProperty)

Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria em casos em que uma animação não está ativa.

(Herdado de DependencyObject)
GetBindingExpression(DependencyProperty)

Retorna o BindingExpression que representa a associação na propriedade especificada.

(Herdado de FrameworkElement)
GetChildrenInTabFocusOrder()

Habilita uma subclasse UIElement para expor elementos filho que participam do foco de Tab.

(Herdado de UIElement)
GetState(DependencyObject)

Recupera o valor da propriedade anexada AnimatedIcon.State para o DependencyObjectespecificado.

GetValue(DependencyProperty)

Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject.

(Herdado de DependencyObject)
GetVisualInternal()

Recupera o Visual para o qual o elemento resolve.

(Herdado de UIElement)
GoToElementStateCore(String, Boolean)

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 do controle.

(Herdado de FrameworkElement)
InvalidateArrange()

Invalida o estado de organização (layout) para umUIElement . Após a invalidação, o UIElement terá seu layout atualizado, o que ocorrerá de forma assíncrona.

(Herdado de UIElement)
InvalidateMeasure()

Invalida o estado de medida (layout) de um UIElement.

(Herdado de UIElement)
InvalidateViewport()

Invalida o estado do visor para um UIElement usado para calcular o visor efetivo.

(Herdado de FrameworkElement)
Measure(Size)

Atualiza o DesiredSize de um UIElement. Normalmente, os objetos que implementam o layout personalizado para seus filhos de layout chamam esse método de suas próprias implementações de MeasureOverride para formar uma atualização de layout recursivo.

(Herdado de UIElement)
MeasureOverride(Size)

Fornece o comportamento da passagem "Medida" do ciclo de layout. As classes podem substituir esse método para definir seu próprio comportamento de aprovação "Medida".

(Herdado de FrameworkElement)
OnApplyTemplate()

Invocada sempre que o código do aplicativo ou processos internos (como um passe de layout de recompilação) ApplyTemplate. Em termos mais simples, isso significa que o método é chamado pouco antes de um elemento de interface do usuário ser exibido em seu aplicativo. Substitua esse método para influenciar a lógica pós-modelo padrão de uma classe.

(Herdado de FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

Chamado antes que o evento BringIntoViewRequested ocorra.

(Herdado de UIElement)
OnCreateAutomationPeer()

Quando implementado em uma classe derivada, retorna implementações AutomationPeer específicas da classe para a infraestrutura de Automação da Interface do Usuário da Microsoft.

(Herdado de UIElement)
OnDisconnectVisualChildren()

Substitua esse método para implementar como o layout e a lógica devem se comportar quando os itens são removidos de uma propriedade filho ou conteúdo específico da classe.

(Herdado de UIElement)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

Chamado quando um atalho de teclado (ou acelerador) é processado em seu aplicativo. Substitua esse método para lidar com a resposta do aplicativo quando um acelerador de teclado é invocado.

(Herdado de UIElement)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Chamado pouco antes de um atalho de teclado (ou acelerador) é processado em seu aplicativo. Invocado sempre que o código do aplicativo ou processos internos chamam ProcessKeyboardAccelerators. Substitua esse método para influenciar o tratamento do acelerador padrão.

(Herdado de UIElement)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Define uma propriedade que pode ser animada.

(Herdado de UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

Quando substituído em uma classe derivada, define uma propriedade que pode ser animada.

(Herdado de UIElement)
ReadLocalValue(DependencyProperty)

Retorna o valor local de uma propriedade de dependência, se um valor local for definido.

(Herdado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registra uma função de notificação para ouvir alterações em um dependencyProperty específico nesta instância dependencyObject .

(Herdado de DependencyObject)
ReleasePointerCapture(Pointer)

Libera capturas de ponteiro para captura de um ponteiro específico por este UIElement .

(Herdado de UIElement)
ReleasePointerCaptures()

Libera todas as capturas de ponteiro mantidas por esse elemento.

(Herdado de UIElement)
RemoveHandler(RoutedEvent, Object)

Remove o manipulador de eventos roteado especificado deste UIElement . Normalmente, o manipulador em questão foi adicionado por AddHandler.

(Herdado de UIElement)
SetBinding(DependencyProperty, BindingBase)

Anexa uma associação a umFrameworkElement usando o objeto de associação fornecido.

(Herdado de FrameworkElement)
SetState(DependencyObject, String)

Especifica o valor da propriedade anexada AnimatedIcon.State para oDependencyObject especificado.

SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência em um DependencyObject.

(Herdado de DependencyObject)
StartAnimation(ICompositionAnimationBase)

Inicia a animação especificada no elemento.

(Herdado de UIElement)
StartBringIntoView()

Inicia uma solicitação para a estrutura XAML para colocar o elemento em exibição em qualquer região rolável em que ele está contido.

(Herdado de UIElement)
StartBringIntoView(BringIntoViewOptions)

Inicia uma solicitação para a estrutura XAML para colocar o elemento em exibição usando as opções especificadas.

(Herdado de UIElement)
StartDragAsync(ExpPointerPoint)

Representa um ícone que exibe e controla um visual que pode animar em resposta à interação do usuário e às alterações de estado visual.

(Herdado de UIElement)
StartDragAsync(PointerPoint)

Inicia uma operação de arrastar e soltar.

Importante

Não há suporte se um usuário executar o aplicativo no modo elevado, como administrador.

(Herdado de UIElement)
StopAnimation(ICompositionAnimationBase)

Interrompe a animação especificada no elemento.

(Herdado de UIElement)
TransformToVisual(UIElement)

Retorna um objeto de transformação que pode ser usado para transformar coordenadas do UIElement para o objeto especificado.

(Herdado de UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Tenta invocar um atalho de teclado (ou acelerador) pesquisando toda a árvore visual do UIElement para obter o atalho.

(Herdado de UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback.

(Herdado de DependencyObject)
UpdateLayout()

Garante que todas as posições de objetos filho de um UIElement sejam atualizadas corretamente para layout.

(Herdado de UIElement)

Eventos

AccessKeyDisplayDismissed

Ocorre quando as chaves de acesso não devem mais ser exibidas.

(Herdado de UIElement)
AccessKeyDisplayRequested

Ocorre quando o usuário solicita que as chaves de acesso sejam exibidas.

(Herdado de UIElement)
AccessKeyInvoked

Ocorre quando um usuário conclui uma sequência de chaves de acesso.

(Herdado de UIElement)
ActualThemeChanged

Ocorre quando o valor da propriedade ActualTheme é alterado.

(Herdado de FrameworkElement)
BringIntoViewRequested

Ocorre quando StartBringIntoView é chamado nesse elemento ou em um de seus descendentes.

(Herdado de UIElement)
CharacterReceived

Ocorre quando um único caractere composto é recebido pela fila de entrada.

(Herdado de UIElement)
ContextCanceled

Ocorre quando um gesto de entrada de contexto continua em um gesto de manipulação, para notificar o elemento de que o submenu de contexto não deve ser aberto.

(Herdado de UIElement)
ContextRequested

Ocorre quando o usuário concluiu um gesto de entrada de contexto, como um clique com o botão direito do mouse.

(Herdado de UIElement)
DataContextChanged

Ocorre quando o valor da propriedade FrameworkElement.DataContext é alterado.

(Herdado de FrameworkElement)
DoubleTapped

Ocorre quando uma interação DoubleTap sem tratamento ocorre na área de teste de ocorrência desse elemento.

(Herdado de UIElement)
DragEnter

Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com esse elemento como destino.

(Herdado de UIElement)
DragLeave

Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com esse elemento como a origem.

(Herdado de UIElement)
DragOver

Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com esse elemento como o destino de queda potencial.

(Herdado de UIElement)
DragStarting

Ocorre quando uma operação de arrastar é iniciada.

(Herdado de UIElement)
Drop

Ocorre quando o sistema de entrada relata um evento de queda subjacente com esse elemento como o destino de soltar.

(Herdado de UIElement)
DropCompleted

Ocorre quando uma operação de arrastar e soltar com esse elemento como a origem é encerrada.

(Herdado de UIElement)
EffectiveViewportChanged

Ocorre quando o FrameworkElementvisor efetivo alterações.

(Herdado de FrameworkElement)
GettingFocus

Ocorre antes que um UIElement receba o foco. Esse evento é gerado de forma síncrona para garantir que o foco não seja movido enquanto o evento estiver borbulhando.

(Herdado de UIElement)
GotFocus

Ocorre quando um UIElement recebe o foco. Esse evento é gerado de forma assíncrona, para que o foco possa se mover novamente antes que o borbulhamento seja concluído.

(Herdado de UIElement)
Holding

Ocorre quando uma interação Hold sem tratamento ocorre na área de teste de ocorrência desse elemento.

(Herdado de UIElement)
KeyDown

Ocorre quando uma tecla de teclado é pressionada enquanto o UIElement tem foco.

(Herdado de UIElement)
KeyUp

Ocorre quando uma tecla de teclado é lançada enquanto o UIElement tem foco.

(Herdado de UIElement)
LayoutUpdated

Ocorre quando o layout da árvore visual é alterado devido a propriedades relevantes ao layout alterando o valor ou alguma outra ação que atualiza o layout.

(Herdado de FrameworkElement)
Loaded

Ocorre quando um FrameworkElement foi construído e adicionado à árvore de objetos e está pronto para interação.

(Herdado de FrameworkElement)
Loading

Ocorre quando um FrameworkElement começa a ser carregado.

(Herdado de FrameworkElement)
LosingFocus

Ocorre antes que um UIElement perca o foco. Esse evento é gerado de forma síncrona para garantir que o foco não seja movido enquanto o evento estiver borbulhando.

(Herdado de UIElement)
LostFocus

Ocorre quando um UIElement perde o foco. Esse evento é gerado de forma assíncrona, para que o foco possa se mover novamente antes que o borbulhamento seja concluído.

(Herdado de UIElement)
ManipulationCompleted

Ocorre quando uma manipulação no UIElement é concluída.

(Herdado de UIElement)
ManipulationDelta

Ocorre quando o dispositivo de entrada altera a posição durante uma manipulação.

(Herdado de UIElement)
ManipulationInertiaStarting

Ocorre quando o dispositivo de entrada perde contato com o objeto UIElement durante o início de uma manipulação e inércia.

(Herdado de UIElement)
ManipulationStarted

Ocorre quando um dispositivo de entrada inicia uma manipulação no UIElement.

(Herdado de UIElement)
ManipulationStarting

Ocorre quando o processador de manipulação é criado pela primeira vez.

(Herdado de UIElement)
NoFocusCandidateFound

Ocorre quando um usuário tenta mover o foco (por meio de setas de guia ou direção), mas o foco não se move porque nenhum candidato de foco é encontrado na direção do movimento.

(Herdado de UIElement)
PointerCanceled

Ocorre quando um ponteiro que fez contato perde contato anormalmente.

(Herdado de UIElement)
PointerCaptureLost

Ocorre quando a captura de ponteiro anteriormente mantida por esse elemento se move para outro elemento ou em outro lugar.

(Herdado de UIElement)
PointerEntered

Ocorre quando um ponteiro entra na área de teste de ocorrência desse elemento.

(Herdado de UIElement)
PointerExited

Ocorre quando um ponteiro deixa a área de teste de ocorrência desse elemento.

(Herdado de UIElement)
PointerMoved

Ocorre quando um ponteiro se move enquanto o ponteiro permanece dentro da área de teste de ocorrência desse elemento.

(Herdado de UIElement)
PointerPressed

Ocorre quando o dispositivo de ponteiro inicia uma ação Pressione dentro desse elemento.

(Herdado de UIElement)
PointerReleased

Ocorre quando o dispositivo de ponteiro que iniciou anteriormente uma ação Pressionar é liberado, enquanto dentro desse elemento. Observe que o fim de uma ação Press não é garantido para disparar um evento PointerReleased; em vez disso, outros eventos podem ser acionados. Para obter mais informações, consulte Comentários.

(Herdado de UIElement)
PointerWheelChanged

Ocorre quando o valor delta de uma roda de ponteiro é alterado.

(Herdado de UIElement)
PreviewKeyDown

Ocorre quando uma tecla de teclado é pressionada enquanto o UIElement tem foco.

(Herdado de UIElement)
PreviewKeyUp

Ocorre quando uma tecla de teclado é lançada enquanto o UIElement tem foco.

(Herdado de UIElement)
ProcessKeyboardAccelerators

Ocorre quando um atalho de teclado (ou acelerador) é pressionado.

(Herdado de UIElement)
RightTapped

Ocorre quando ocorre um estímulo de entrada de toque à direita enquanto o ponteiro está sobre o elemento.

(Herdado de UIElement)
SizeChanged

Ocorre quando o ActualHeight ou a propriedade ActualWidth altera o valor em umFrameworkElement.

(Herdado de FrameworkElement)
Tapped

Ocorre quando uma interação Toque sem tratamento ocorre na área de teste de ocorrência desse elemento.

(Herdado de UIElement)
Unloaded

Ocorre quando esse objeto não está mais conectado à árvore de objetos principal.

(Herdado de FrameworkElement)

Aplica-se a

Confira também