FrameworkElement Classe
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 uma classe de elemento base para Windows Runtime objetos de interface do usuário. FrameworkElement define uma API comum que dá suporte à interação da interface do usuário e ao sistema de layout automático. FrameworkElement também define a API relacionada à associação de dados, à definição e ao exame da árvore de objetos e ao tempo de vida do objeto de rastreamento.
public ref class FrameworkElement : UIElement/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FrameworkElement : UIElement[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class FrameworkElement : UIElementPublic Class FrameworkElement
Inherits UIElement- Herança
- Derivado
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Comentários
FrameworkElement é um elemento base: é uma classe da qual muitas outras classes Windows Runtime herdam para dar suporte ao modelo de elemento de interface do usuário XAML. Propriedades, métodos e eventos definidos pelo FrameworkElement são herdados por centenas de outras classes Windows Runtime.
Muitas classes comuns de interface do usuário XAML derivam de FrameworkElement, diretamente ou por meio de classes base intermediárias, como Painel ou Controle. Normalmente, você não deriva classes diretamente do FrameworkElement, porque determinados serviços esperados para uma classe destinada a uma representação de interface do usuário (como suporte a modelo) não são totalmente implementados lá. As classes base usadas com mais frequência para classes personalizadas derivadas são:
- Controles específicos que não são lacrados (por exemplo, TextBox).
- Classes base de controle (Control, ContentControl, UserControl).
- Elementos de navegação (Page, Frame).
- Classes de painel (a classe base Panel ou implementações não lacradas específicas, como Grid).
Frameworkelement API e recursos
FrameworkElement estende UIElement, que é outro elemento base, e adiciona suporte para várias áreas de recursos Windows Runtime.
Layout
O sistema de layout reconhece todos os objetos derivados de FrameworkElement como elementos que potencialmente participam do layout e devem ter uma área de exibição na interface do usuário do aplicativo. O sistema de layout lê várias propriedades definidas no nível de FrameworkElement, como MinWidth. A maioria dos elementos de interface do usuário usa a Largura e a Altura definidas por FrameworkElement para suas informações básicas de dimensionamento. FrameworkElement fornece métodos extensíveis para comportamento de layout especializado que painéis e controles com conteúdo podem substituir em suas implementações de classe. Para obter mais informações, consulte Definir layouts com XAML.
API proeminente de FrameworkElement que dá suporte a layout: Height, Width, ActualHeight, ActualWidth, Margin, MeasureOverride, ArrangeOverride, HorizontalAlignment, VerticalAlignment, LayoutUpdated.
Eventos de tempo de vida do objeto
Geralmente, você deseja saber quando um objeto é carregado pela primeira vez (carregado é definido como quando um objeto é anexado a uma árvore de objetos que se conecta ao visual raiz). FrameworkElement define eventos relacionados ao tempo de vida do objeto que fornecem ganchos úteis para operações code-behind. Por exemplo, você precisa de informações de tempo de vida do objeto para adicionar objetos filho a uma coleção ou definir propriedades em objetos filho pouco antes do uso, com a garantia de que os objetos necessários na árvore de objetos já foram instanciados da marcação XAML. Para saber mais, confira Visão geral de eventos e eventos roteados.
API proeminente de FrameworkElement que dá suporte a eventos de tempo de vida do objeto: Loaded, SizeChanged, Unloaded, OnApplyTemplate.
Vinculação de dados
A capacidade de definir um valor para um contexto de dados potencialmente herdado para uma associação de dados é implementada pelo FrameworkElement. FrameworkElement também tem a API para estabelecer a associação de dados no código em vez de em XAML. Para obter mais informações, consulte Vinculação de dados em detalhes.
API proeminente do FrameworkElement que dá suporte à associação de dados: DataContext, DataContextChanged, SetBinding, GetBindingExpression.
Integração de modelo de programação e linguagem XAML
Normalmente, a estrutura de elementos do aplicativo é semelhante à marcação XAML que você definiu para criar a interface do usuário, mas às vezes essa estrutura muda depois que o XAML é analisado. FrameworkElement define a propriedade Name e a API relacionada, que são úteis para localizar elementos e relações de elementos em tempo de execução. Para saber mais, veja Namescopes XAML.
API proeminente do FrameworkElement que dá suporte a XAML e modelo de programação: Name, FindName, Parent, BaseUri, OnApplyTemplate.
Globalização
A classe FrameworkElement define a propriedade Language e a propriedade FlowDirection . Para obter mais informações, consulte Globalizando seu aplicativo.
Suporte a estilos e temas
A classe FrameworkElement define a propriedade Style e a propriedade RequestedTheme . Além disso, a propriedade Resources é usada para definir os dicionários de recursos XAML no nível da página que normalmente definem estilos e modelos, bem como outros recursos compartilhados. Para obter mais informações, consulte Controles de estilo e Referências de recursos ResourceDictionary e XAML.
Propriedades de dependência frameworkElement
Muitas das propriedades de leitura/gravação da classe de elemento base FrameworkElement são propriedades de dependência. As propriedades de dependência dão suporte a alguns dos recursos básicos do modelo de programação para um aplicativo UWP usando C++, C# ou Visual Basic, como estilos e modelos, associação de dados, referências de recursos XAML e lógica alterada pela propriedade. Para obter mais informações sobre as propriedades de dependência e os recursos aos quais elas dão suporte, consulte Visão geral das propriedades de dependência.
Classes derivadas de FrameworkElement
FrameworkElement é a classe pai de várias classes derivadas imediatamente que distinguem várias classificações amplas de elementos de interface do usuário. Aqui estão algumas das classes derivadas notáveis:
- Controle: o controle tem muito mais classes de controle derivadas, basicamente todos os controles XAML que você usa para uma interface do usuário Windows Runtime são derivados de Control.
- Apresentadores: um apresentador é uma classe que transmite uma aparência visual, geralmente contribuindo para algum cenário de controle, mas o próprio apresentador normalmente não é interativo. Por exemplo: Border, ContentPresenter (pai de ScrollContentPresenter e outros), ItemsPresenter, Viewbox.
- Mídia e elementos da Web: Image, WebView, MediaElement, CaptureElement. Eles exibem conteúdo e têm algum nível de interatividade que acontece dentro do conteúdo, mas não são realmente controles.
- Elementos de exibição de texto: TextBlock, RichTextBlock, RichTextBlockOverflow, Glyphs. (Elementos de texto como Run e Hyperlink, que geralmente declaram o conteúdo de um elemento de exibição de texto, não são derivados de FrameworkElement.)
- A classe base Panel : Panel é a classe pai para os painéis comuns, como Grid, StackPanel e assim por diante.
- A classe base Shape : Shape é a classe pai de Path, Rectangle e assim por diante.
- A classe base IconElement : classe pai para FontIcon, SymbolIcon e assim por diante.
- Diversos elementos da interface do usuário: Popup, TickBar, Viewbox.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1607 | 14393 | AllowFocusOnInteraction |
| 1607 | 14393 | AllowFocusWhenDisabled |
| 1607 | 14393 | FocusVisualMargin |
| 1607 | 14393 | FocusVisualPrimaryBrush |
| 1607 | 14393 | FocusVisualPrimaryThickness |
| 1607 | 14393 | FocusVisualSecondaryBrush |
| 1607 | 14393 | FocusVisualSecondaryThickness |
| 1703 | 15063 | DeferTree |
| 1.709 | 16299 | ActualTheme |
| 1.709 | 16299 | ActualThemeChanged |
| 1809 | 17763 | EffectiveViewportChanged |
| 1809 | 17763 | InvalidateViewport |
| 1809 | 17763 | Isloaded |
Construtores
| FrameworkElement() |
Fornece o comportamento de inicialização de classe base para classes derivadas de FrameworkElement. |
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 um FrameworkElement. Consulte Observações. |
| ActualHeightProperty |
Identifica a propriedade de dependência ActualHeight . Consulte Observações. |
| ActualOffset |
Obtém a posição desse UIElement, em relação ao pai, computada durante a passagem de organização do processo de layout. (Herdado de UIElement) |
| ActualSize |
Obtém o tamanho que esse UIElement calculou 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 de RequestedTheme. |
| ActualThemeProperty |
Identifica a propriedade de dependência ActualTheme. |
| ActualWidth |
Obtém a largura renderizada de um FrameworkElement. Consulte Observações. |
| ActualWidthProperty |
Identifica a propriedade de dependência ActualWidth . Consulte Observações. |
| 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. |
| AllowFocusOnInteractionProperty |
Identifica a propriedade de dependência AllowFocusOnInteraction . |
| AllowFocusWhenDisabled |
Obtém ou define se um controle desabilitado pode receber foco. |
| AllowFocusWhenDisabledProperty |
Identifica a propriedade de dependência AllowFocusWhenDisabled . |
| BaseUri |
Obtém um URI (Uniform Resource Identifier) que representa o URI (Uniform Resource Identifier) base para um objeto construído por XAML no tempo de carregamento XAML. Essa propriedade é útil para resolução de URI (Uniform Resource Identifier) em tempo de execução. |
| 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 um FrameworkElement. Um uso comum de um contexto de dados é quando um FrameworkElement usa a extensão de marcação {Binding} e participa da associação de dados. |
| DataContextProperty |
Identifica a propriedade de dependência DataContext . |
| DesiredSize |
Obtém o tamanho que esse UIElement calculou durante a passagem de medida do processo de layout. (Herdado de UIElement) |
| Dispatcher |
Obtém o CoreDispatcher ao qual esse objeto está associado. O CoreDispatcher representa uma instalação que pode acessar 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) |
| 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 como RightToLeft em qualquer elemento define o alinhamento à direita, a ordem de leitura da direita para a esquerda e o layout do controle para fluir da direita para a esquerda. |
| FlowDirectionProperty |
Identifica a propriedade de dependência FlowDirection . |
| FocusVisualMargin |
Obtém ou define a margem externa do visual de foco para um FrameworkElement. |
| FocusVisualMarginProperty |
Identifica a propriedade de dependência FocusVisualMargin . |
| FocusVisualPrimaryBrush |
Obtém ou define o pincel usado para desenhar a borda externa de um |
| FocusVisualPrimaryBrushProperty |
Identifica a propriedade de dependência FocusVisualPrimaryBrush . |
| FocusVisualPrimaryThickness |
Obtém ou define a espessura da borda externa de um |
| FocusVisualPrimaryThicknessProperty |
Identifica a propriedade de dependência FocusVisualPrimaryThickness . |
| FocusVisualSecondaryBrush |
Obtém ou define o pincel usado para desenhar a borda interna de um |
| FocusVisualSecondaryBrushProperty |
Identifica a propriedade de dependência FocusVisualSecondaryBrush . |
| FocusVisualSecondaryThickness |
Obtém ou define a espessura da borda interna de um |
| FocusVisualSecondaryThicknessProperty |
Identifica a propriedade de dependência FocusVisualSecondaryThickness . |
| Height |
Obtém ou define a altura sugerida de um FrameworkElement. |
| HeightProperty |
Identifica a propriedade de dependência Height . |
| 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. |
| HorizontalAlignmentProperty |
Identifica a propriedade de dependência HorizontalAlignment . |
| 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 desse UIElement pode retornar valores verdadeiros para teste de clique. (Herdado de UIElement) |
| IsHoldingEnabled |
Obtém ou define um valor que determina se o evento Holding pode ser originado 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. |
| IsRightTapEnabled |
Obtém ou define um valor que determina se o evento RightTapped pode ser originado desse elemento. (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 a dica de ferramenta de controle exibe a combinação de teclas para seu acelerador de teclado associado. (Herdado de UIElement) |
| KeyboardAcceleratorPlacementTarget |
Obtém ou define um valor que indica a dica de ferramenta de controle que exibe a combinação de teclas aceleradoras. (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.
|
| 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 tecla 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 tecla de acesso. (Herdado de UIElement) |
| KeyTipVerticalOffset |
Obtém ou define um valor que indica até que ponto a Dica de Tecla é colocada 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. |
| LanguageProperty |
Identifica a propriedade Dependência de linguagem . |
| 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 UIElement e interação com gestos. Definir esse valor permite manipular os eventos de manipulação desse elemento no código do aplicativo. (Herdado de UIElement) |
| Margin |
Obtém ou define a margem externa de um FrameworkElement. |
| MarginProperty |
Identifica a propriedade de dependência Margin . |
| MaxHeight |
Obtém ou define a restrição de altura máxima de um FrameworkElement. |
| MaxHeightProperty |
Identifica a propriedade de dependência MaxHeight . |
| MaxWidth |
Obtém ou define a restrição de largura máxima de um FrameworkElement. |
| MaxWidthProperty |
Identifica a propriedade de dependência MaxWidth . |
| MinHeight |
Obtém ou define a restrição de altura mínima de um FrameworkElement. |
| MinHeightProperty |
Identifica a propriedade de dependência MinHeight . |
| MinWidth |
Obtém ou define a restrição de largura mínima de um FrameworkElement. |
| MinWidthProperty |
Identifica a propriedade de dependência MinWidth . |
| Name |
Obtém ou define o nome de identificação do objeto. Quando um processador XAML cria a árvore de objetos da marcação XAML, o código em tempo de execução pode se referir ao objeto declarado XAML por esse nome. |
| NameProperty |
Identifica a propriedade de dependência Name . |
| 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. |
| PointerCaptures |
Obtém o conjunto de todos os ponteiros capturados, representados como valores pointer . (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) |
| RenderSize |
Obtém o tamanho de renderização final de um UIElement. 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 um UIElement. (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 que é usado pelo UIElement (e seus elementos filho) para determinação de recursos. O tema da interface do usuário especificado com RequestedTheme pode substituir RequestedTheme no nível do aplicativo. |
| RequestedThemeProperty |
Identifica a propriedade de dependência RequestedTheme . |
| 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 |
| 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) |
| Style |
Obtém ou define um Estilo de instância que é aplicado a esse objeto durante o layout e a renderização. |
| StyleProperty |
Identifica a propriedade de dependência Style . |
| TabFocusNavigation |
Obtém ou define um valor que modifica como o tabbing e TabIndex funcionam para esse controle. (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. |
| TagProperty |
Identifica a propriedade de dependência Tag . |
| 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 que se aplicam a um UIElement. (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 um FrameworkElement. Não usado com frequência. Consulte Observações. |
| UIContext |
Obtém o identificador de contexto para o elemento . (Herdado de UIElement) |
| 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) |
| 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. |
| VerticalAlignmentProperty |
Identifica a propriedade de dependência VerticalAlignment . |
| Visibility |
Obtém ou define a visibilidade de um UIElement. Um UIElement que não está visível não é renderizado e não comunica o tamanho desejado para o layout. (Herdado de UIElement) |
| Width |
Obtém ou define a largura de um FrameworkElement. |
| WidthProperty |
Identifica a propriedade de dependência Width . |
| XamlRoot |
Obtém ou define o |
| XYFocusDownNavigationStrategy |
Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação inativa. (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) |
| 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) |
| XYFocusRightNavigationStrategy |
Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação à direita. (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) |
Métodos
| AddHandler(RoutedEvent, Object, Boolean) |
Adiciona um manipulador de eventos roteados de 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 suas implementações de substituição de layout para formar uma atualização de layout recursivo. (Herdado de UIElement) |
| ArrangeOverride(Size) |
Fornece o comportamento para a passagem de layout "Organizar". As classes podem substituir esse método para definir seu próprio comportamento de passagem "Organizar". |
| CancelDirectManipulations() |
Cancela o processamento contínuo de manipulação direta (movimento panorâmico/zoom definido pelo sistema) em qualquer pai ScrollViewer que contenha o UIElement atual. (Herdado de UIElement) |
| CapturePointer(Pointer) |
Define a captura de ponteiro para um UIElement. Depois de capturado, somente o elemento que tem captura disparará eventos relacionados ao ponteiro. (Herdado de UIElement) |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject) |
| DeferTree(DependencyObject) |
Remove o elemento especificado da árvore visual XAML de uma maneira que ele pode ser inferido posteriormente. |
| FindName(String) |
Recupera um objeto que tem o nome do identificador especificado. |
| FindSubElementsForTouchTargeting(Point, Rect) |
Permite que uma subclasse UIElement exponha elementos filho que ajudam a resolver o direcionamento de toque. (Herdado de UIElement) |
| GetAnimationBaseValue(DependencyProperty) |
Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria nos casos em que uma animação não está ativa. (Herdado de DependencyObject) |
| GetBindingExpression(DependencyProperty) |
Retorna a BindingExpression que representa a associação na propriedade especificada. |
| GetChildrenInTabFocusOrder() |
Permite que uma subclasse UIElement exponha elementos filho que participam do foco de Tab. (Herdado de UIElement) |
| GetValue(DependencyProperty) |
Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject) |
| 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 de controle. |
| InvalidateArrange() |
Invalida o estado de organização (layout) de um UIElement. 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. |
| Measure(Size) |
Atualizações o DesiredSize de um UIElement. Normalmente, objetos que implementam layout personalizado para seus filhos de layout chamam esse método de suas próprias implementações MeasureOverride para formar uma atualização de layout recursiva. (Herdado de UIElement) |
| MeasureOverride(Size) |
Fornece o comportamento para a passagem "Medida" do ciclo de layout. As classes podem substituir esse método para definir seu próprio comportamento de passagem "Medida". |
| OnApplyTemplate() |
Invocado sempre que o código do aplicativo ou processos internos (como uma passagem de layout de recompilação) chamam 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. |
| 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 forma como seu aplicativo responde quando um acelerador de teclado é invocado. (Herdado de UIElement) |
| OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Chamado pouco antes de um atalho de teclado (ou acelerador) ser 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 escutar alterações em uma DependencyProperty específica nesta instância dependencyObject . (Herdado de DependencyObject) |
| ReleasePointerCapture(Pointer) |
Libera capturas de ponteiro para captura de um ponteiro específico por esse 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 desse UIElement. Normalmente, o manipulador em questão foi adicionado por AddHandler. (Herdado de UIElement) |
| SetBinding(DependencyProperty, BindingBase) |
Anexa uma associação a um FrameworkElement, usando o objeto de associação fornecido. |
| 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 todas as regiões roláveis 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(PointerPoint) |
Inicia uma operação do tipo "arrastar e soltar". (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 em toda a árvore visual do UIElement 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 foi alterado. |
| BringIntoViewRequested |
Ocorre quando StartBringIntoView é chamado nesse elemento ou 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 conclui 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. |
| DoubleTapped |
Ocorre quando ocorre uma interação DoubleTap sem tratamento 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 o 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 do tipo "arrastar" subjacente com esse elemento como a reprodução automática 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 soltar subjacente com esse elemento sendo uma reprodução automática. (Herdado de UIElement) |
| DropCompleted |
Ocorre quando uma operação de arrastar e soltar com esse elemento quando a origem é encerrada. (Herdado de UIElement) |
| EffectiveViewportChanged |
Ocorre quando o visor efetivo do FrameworkElement é alterado. |
| 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 é liberada 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. |
| Loaded |
Ocorre quando um FrameworkElement foi construído e adicionado à árvore de objetos e está pronto para interação. |
| Loading |
Ocorre quando um FrameworkElement começa a ser carregado. |
| 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 muda de posição durante uma manipulação. (Herdado de UIElement) |
| ManipulationInertiaStarting |
Ocorre quando o dispositivo de entrada perde contato com o objeto UIElement durante a manipulação e a inércia começa. (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. (Herdado de UIElement) |
| NoFocusCandidateFound |
Ocorre quando um usuário tenta mover o foco (por meio de setas guia ou direcionais), 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 clique desse elemento. (Herdado de UIElement) |
| PointerExited |
Ocorre quando um ponteiro sai da área de teste de clique desse elemento. (Herdado de UIElement) |
| PointerMoved |
Ocorre quando um ponteiro se move enquanto o ponteiro permanece dentro da área de teste de clique desse elemento. (Herdado de UIElement) |
| PointerPressed |
Ocorre quando o dispositivo de ponteiro inicia uma ação Pressionar dentro desse elemento. (Herdado de UIElement) |
| PointerReleased |
Ocorre quando o dispositivo de ponteiro que iniciou anteriormente uma ação Press é liberado, enquanto está dentro desse elemento. Observe que não há garantia de que o fim de uma ação De imprensa dispare um evento PointerReleased; 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 é liberada 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 direito enquanto o ponteiro está sobre o elemento . (Herdado de UIElement) |
| SizeChanged |
Ocorre quando a propriedade ActualHeight ou ActualWidth altera o valor em um FrameworkElement. |
| Tapped |
Ocorre quando uma interação tap sem tratamento ocorre na área de teste de clique desse elemento. (Herdado de UIElement) |
| Unloaded |
Ocorre quando esse objeto não está mais conectado à árvore de objetos main. |
Aplica-se a
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de