UIElement 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.
UIElement é uma classe base para a maioria dos objetos de interface do usuário do Windows Runtime que têm aparência visual e podem processar a entrada básica como parte da interface do usuário do aplicativo.
public ref class UIElement : DependencyObject
public ref class UIElement : DependencyObject, IAnimationObject
public ref class UIElement : DependencyObject, IAnimationObject, IVisualElement
/// [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 UIElement : DependencyObject
/// [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 UIElement : DependencyObject, IAnimationObject
/// [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 UIElement : DependencyObject, IAnimationObject, IVisualElement
[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 UIElement : DependencyObject
[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 UIElement : DependencyObject, IAnimationObject
[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 UIElement : DependencyObject, IAnimationObject, IVisualElement
Public Class UIElement
Inherits DependencyObject
Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject
Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject, IVisualElement
- Herança
- Derivado
- Atributos
- Implementações
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
UIElement é um elemento base: é uma classe da qual muitas outras classes do Windows Runtime herdam para dar suporte ao modelo de elemento de interface do usuário XAML. Propriedades, métodos e eventos definidos por UIElement são herdados por centenas de outras classes do Windows Runtime.
Embora o UIElement defina os eventos para relatórios de foco (GotFocus, LostFocus), o UIElement não define uma API para definir programaticamente o foco. Essa funcionalidade é definida pela classe controle de
UIElement não expõe um construtor público. Normalmente, você não deriva classes de UIElement ou FrameworkElement diretamente. Classes base mais usadas normalmente para classes personalizadas derivadas são estas classes:
- Controles específicos que não estão lacrados (por exemplo, TextBox)
- Classes base de controle (Control, ContentControl, UserControl)
- Elementos de navegação (de página
, frame ) - Classes de painel (a classe base Panelou implementações não lacradas específicas, como Grid)
A classe UIElement é usada como o parâmetro de tipo de muitas propriedades e métodos na API do Windows Runtime. Por exemplo, a propriedade Child de Border usa um único UIElement, que representa o elemento que o Border é desenhado. Você pode fornecer qualquer elemento derivado de UIElement para essa propriedade, incluindo controles personalizados que você definir.
A classe UIElementCollection fornece uma coleção fortemente tipada de itens UIElement. UIElementCollection é usado como um tipo para propriedades de objetos que contêm vários elementos filho, por exemplo, para a propriedade Children de qualquer classe Panel.
API e recursos do UIElement
O UIElement estende DependencyObject, que é outro elemento base, e adiciona suporte para várias áreas de recursos do Windows Runtime.
Entrada e eventos para responder à interação do usuário
Grande parte do comportamento de entrada para elementos visíveis em uma interface do usuário é definida na classe UIElement. Isso inclui os eventos para as interações de teclado, mouse, toque, arrastar-soltar e foco. Para obter mais informações, consulte
API proeminente do UIElement que dá suporte à entrada e à interação do usuário:
- eventos de ponteiro :PointerPressed, PointerReleased, PointerMoved, PointerEntered, PointerExited
- Principais eventos de tratamento:keydown, keyup
- foco :GotFocus, LostFocus
- captura de ponteiro :CapturePointer, PointerCanceled, PointerCaptureLost, ReleasePointerCapture, PointerCaptures
- Drag-drop:DragOver, Drop, DragEnter, DragLeave, AllowDrop
- Propriedades que influenciam como a entrada básica é processada:IsHitTestVisible, AllowDrop
Gestos e manipulações
Gestos e manipulações também são uma maneira de lidar com a entrada e a interação do usuário. A API é listada separadamente aqui porque esses eventos representam como o sistema interage com ações de entrada no nível do dispositivo e as interpreta como uma interação do usuário. As manipulações são uma maneira de lidar com interações dinâmicas de vários toques, como pinçamento e alongamento. Juntos, os gestos e as manipulações fornecem os padrões de toque para interação de toque com o aplicativo UWP. Para obter mais informações, consulte Interações personalizadas do usuário e design de interação por toque.
API proeminente do UIElement que dá suporte a gestos e manipulações:
- eventos de gesto :DoubleTapped, Holding, RightTapped, Tapped
- eventos de Manipulação :ManipulationCompleted, ManipulationDelta, ManipulationInertiaStarting, ManipulationStarted, ManipulationStarting
- Propriedades que influenciam como gestos e manipulações são processados:IsHoldingEnabled e outros Is*Enabled, ManipulationMode
Aparência básica
As propriedades de Visibilidade
Layout básico
A classe UIElement fornece um ponto de partida para características de layout com propriedades como
Eventos roteado
A maioria dos eventos de entrada de UIElement são eventos roteado. Um evento roteado habilita um sistema de notificação de tratamento de eventos interno, de modo que um objeto pai possa lidar com eventos de entrada de objetos filho na árvore de objetos se o evento permanecer sem tratamento. Esse comportamento de evento de entrada é útil para agrupamento de área de entrada e para composição de controle. Para obter mais informações, consulte Visão geral de eventos roteado e eventos roteado.
API proeminente de UIElement que dá suporte a eventos roteado: addhandler, removeHandler, *propriedades de de evento.
Suporte a outras plataformas
OnCreateAutomationPeer permite que uma classe use umAutomationPeer personalizado para seu suporte à Automação da Interface do Usuário da Microsoft. - RenderTransform, TransformToVisual, Projection, CompositeMode, CacheMode e FindSubElementsForTouchTargeting são úteis para cenários avançados de layout de interface do usuário.
Propriedades de dependência UIElement
Muitas das propriedades de leitura/gravação da classe de elemento base UIElement 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 recurso XAML e lógica alterada pela propriedade. Para obter mais informações sobre as propriedades de dependência e os recursos compatíveis, consulte Visão geral das propriedades de dependência.
Classes derivadas de UIElement
A única classe do Windows Runtime que deriva diretamente do UIElement é FrameworkElement. Para obter uma lista das classes derivadas de FrameworkElement, consulte a seção "FrameworkElement classes derivadas" do tópico de referência FrameworkElement.
Histórico de versões
Versão do Windows | Versão do SDK | Valor acrescentado |
---|---|---|
1607 | 14393 | AccessKey |
1607 | 14393 | AccessKeyDisplayDismissed |
1607 | 14393 | AccessKeyDisplayRequested |
1607 | 14393 | AccessKeyInvoked |
1607 | 14393 | AccessKeyScopeOwner |
1607 | 14393 | ContextCanceled |
1607 | 14393 | ContextFlyout |
1607 | 14393 | ContextRequested |
1607 | 14393 | ExitDisplayModeOnAccessKeyInvoked |
1607 | 14393 | IsAccessKeyScope |
1703 | 15063 | GettingFocus |
1703 | 15063 | GettingFocusEvent |
1703 | 15063 | HighContrastAdjustment |
1703 | 15063 | KeyTipHorizontalOffset |
1703 | 15063 | KeyTipPlacementMode |
1703 | 15063 | KeyTipVerticalOffset |
1703 | 15063 | Luzes |
1703 | 15063 | LosingFocus |
1703 | 15063 | LosingFocusEvent |
1703 | 15063 | NoFocusCandidateFound |
1703 | 15063 | NoFocusCandidateFoundEvent |
1703 | 15063 | StartBringIntoView |
1703 | 15063 | StartBringIntoView(BringIntoViewOptions) |
1703 | 15063 | TabFocusNavigation |
1703 | 15063 | XYFocusDownNavigationStrategy |
1703 | 15063 | XYFocusKeyboardNavigation |
1703 | 15063 | XYFocusLeftNavigationStrategy |
1703 | 15063 | XYFocusRightNavigationStrategy |
1703 | 15063 | XYFocusUpNavigationStrategy |
1709 | 16299 | CharacterReceived |
1709 | 16299 | CharacterReceivedEvent |
1709 | 16299 | GetChildrenInTabFocusOrder |
1709 | 16299 | KeyboardAccelerators |
1709 | 16299 | OnProcessKeyboardAccelerators |
1709 | 16299 | PreviewKeyDown |
1709 | 16299 | PreviewKeyDownEvent |
1709 | 16299 | PreviewKeyUp |
1709 | 16299 | PreviewKeyUpEvent |
1709 | 16299 | ProcessKeyboardAccelerators |
1709 | 16299 | TryInvokeKeyboardAccelerator |
1803 | 17134 | BringIntoViewRequested |
1803 | 17134 | BringIntoViewRequestedEvent |
1803 | 17134 | ContextRequestedEvent |
1803 | 17134 | KeyboardAcceleratorPlacementMode |
1803 | 17134 | KeyboardAcceleratorPlacementTarget |
1803 | 17134 | KeyTipTarget |
1803 | 17134 | OnBringIntoViewRequested |
1803 | 17134 | OnKeyboardAcceleratorInvoked |
1803 | 17134 | RegisterAsScrollPort |
1809 | 17763 | CanBeScrollAnchor |
1809 | 17763 | CenterPoint |
1809 | 17763 | OpacityTransition |
1809 | 17763 | PopulatePropertyInfo |
1809 | 17763 | PopulatePropertyInfoOverride |
1809 | 17763 | Rotação |
1809 | 17763 | RotationAxis |
1809 | 17763 | RotationTransition |
1809 | 17763 | Escala |
1809 | 17763 | ScaleTransition |
1809 | 17763 | StartAnimation |
1809 | 17763 | StopAnimation |
1809 | 17763 | TransformMatrix |
1809 | 17763 | Tradução |
1809 | 17763 | TranslationTransition |
1903 | 18362 | ActualOffset |
1903 | 18362 | ActualSize |
1903 | 18362 | Sombra |
1903 | 18362 | UIContext |
1903 | 18362 | XamlRoot |
Propriedades
AccessKey |
Obtém ou define a chave de acesso (mnemônica) para esse elemento. |
AccessKeyProperty |
Identifica a propriedade de dependência |
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. |
AccessKeyScopeOwnerProperty |
Identifica a propriedade de dependência AccessKeyScopeOwner. |
ActualOffset |
Obtém a posição desse UIElement, em relação ao pai, computado durante a passagem de organização do processo de layout. |
ActualSize |
Obtém o tamanho que esse UIElement computou durante a passagem de organização do processo de layout. |
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. |
AllowDropProperty |
Identifica a propriedade de dependência |
BringIntoViewRequestedEvent |
Obtém o identificador do evento roteado BringIntoViewRequested. |
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. |
CacheModeProperty |
Identifica a propriedade de dependência |
CanBeScrollAnchor |
Obtém ou define um valor que indica se o UIElement pode ser um candidato para ancoragem de rolagem. |
CanBeScrollAnchorProperty |
Identifica a propriedade de dependência CanBeScrollAnchor. |
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. |
CanDragProperty |
Identifica a propriedade de dependência |
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. |
CharacterReceivedEvent |
Obtém o identificador do evento roteado |
Clip |
Obtém ou define o RectangleGeometry |
ClipProperty |
Identifica a propriedade de dependência Clip. |
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. |
CompositeModeProperty |
Identifica a propriedade de dependência |
ContextFlyout |
Obtém ou define o submenu associado a esse elemento. |
ContextFlyoutProperty |
Identifica a propriedade de dependência |
ContextRequestedEvent |
Obtém o identificador do evento roteado ContextRequested. |
DesiredSize |
Obtém o tamanho que esse UIElement computado durante a aprovação da medida do processo de layout. |
Dispatcher |
Obtém o CoreDispatcher ao qual esse objeto está associado. O CoreDispatcher 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) |
DoubleTappedEvent |
Obtém o identificador do evento roteado |
DragEnterEvent |
Obtém o identificador do evento roteado |
DragLeaveEvent |
Obtém o identificador do evento roteado |
DragOverEvent |
Obtém o identificador do evento roteado |
DropEvent |
Obtém o identificador do evento roteado |
ExitDisplayModeOnAccessKeyInvoked |
Obtém ou define um valor que especifica se a exibição da chave de acesso é ignorada quando uma chave de acesso é invocada. |
ExitDisplayModeOnAccessKeyInvokedProperty |
Identifica a propriedade de dependência ExitDisplayModeOnAccessKeyInvoked. |
GettingFocusEvent |
Obtém o identificador do evento roteado |
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. |
HighContrastAdjustmentProperty |
Identifica a propriedade de dependência |
HoldingEvent |
Obtém o identificador do evento roteado Holding. |
IsAccessKeyScope |
Obtém ou define um valor que indica se um elemento define seu próprio escopo de chave de acesso. |
IsAccessKeyScopeProperty |
Identifica a propriedade de dependência |
IsDoubleTapEnabled |
Obtém ou define um valor que determina se o evento DoubleTapped pode se originar desse elemento. |
IsDoubleTapEnabledProperty |
Identifica a propriedade de dependência IsDoubleTapEnabled. |
IsHitTestVisible |
Obtém ou define se a área contida deste UIElement pode retornar valores verdadeiros para teste de ocorrência. |
IsHitTestVisibleProperty |
Identifica a propriedade de dependência |
IsHoldingEnabled |
Obtém ou define um valor que determina se o evento Holding pode se originar desse elemento. |
IsHoldingEnabledProperty |
Identifica a propriedade de dependência |
IsRightTapEnabled |
Obtém ou define um valor que determina se o evento RightTapped pode se originar desse elemento. |
IsRightTapEnabledProperty |
Identifica a propriedade de dependência |
IsTapEnabled |
Obtém ou define um valor que determina se o evento Tapped pode se originar desse elemento. |
IsTapEnabledProperty |
Identifica a propriedade de dependência |
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. |
KeyboardAcceleratorPlacementModeProperty |
Identifica a propriedade de dependência |
KeyboardAcceleratorPlacementTarget |
Obtém ou define um valor que indica o controle dica de ferramenta que exibe a combinação de teclas de acelerador. |
KeyboardAcceleratorPlacementTargetProperty |
Identifica a propriedade de dependência KeyboardAcceleratorPlacementTarget. |
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.
|
KeyDownEvent |
Obtém o identificador do evento roteado |
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. |
KeyTipHorizontalOffsetProperty |
Identifica a propriedade de dependência KeyTipHorizontalOffset. |
KeyTipPlacementMode |
Obtém ou define um valor que indica onde a dica de chave de acesso é colocada em relação ao limite do UIElement. |
KeyTipPlacementModeProperty |
Identifica a propriedade de dependência KeyTipPlacementMode. |
KeyTipTarget |
Obtém ou define um valor que indica o elemento direcionado pela dica de chave de acesso. |
KeyTipTargetProperty |
Identifica a propriedade de dependência KeyTipTarget. |
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. |
KeyTipVerticalOffsetProperty |
Identifica a propriedade de dependência KeyTipVerticalOffset. |
KeyUpEvent |
Obtém o identificador do evento roteado KeyUp. |
Lights |
Obtém a coleção de objetos XamlLight |
LightsProperty |
Identifica a propriedade de dependência |
LosingFocusEvent |
Obtém o identificador do evento roteado |
ManipulationCompletedEvent |
Obtém o identificador do evento roteado |
ManipulationDeltaEvent |
Obtém o identificador do evento roteado |
ManipulationInertiaStartingEvent |
Obtém o identificador do evento roteado ManipulationInertiaStarting. |
ManipulationMode |
Obtém ou define o valor |
ManipulationModeProperty |
Identifica a propriedade de dependência ManipulationMode. |
ManipulationStartedEvent |
Obtém o identificador do evento roteado |
ManipulationStartingEvent |
Obtém o identificador do evento roteado ManipulationStarting. |
NoFocusCandidateFoundEvent |
Obtém o identificador do evento roteado |
Opacity |
Obtém ou define o grau de opacidade do objeto. |
OpacityProperty |
Identifica a propriedade de dependência |
OpacityTransition |
Obtém ou define o ScalarTransition que anima as alterações na propriedade Opacity. |
PointerCanceledEvent |
Obtém o identificador do pointerCanceled evento roteado. |
PointerCaptureLostEvent |
Obtém o identificador do pointerCaptureLost evento roteado. |
PointerCaptures |
Obtém o conjunto de todos os ponteiros capturados, representados como valores de ponteiro |
PointerCapturesProperty |
Identifica a propriedade de dependência |
PointerEnteredEvent |
Obtém o identificador do pointerEntered evento roteado. |
PointerExitedEvent |
Obtém o identificador do PointerExited evento roteado. |
PointerMovedEvent |
Obtém o identificador do pointerMoved evento roteado. |
PointerPressedEvent |
Obtém o identificador do evento roteado |
PointerReleasedEvent |
Obtém o identificador do PointerReleased evento roteado. |
PointerWheelChangedEvent |
Obtém o identificador do evento roteado |
PreviewKeyDownEvent |
Obtém o identificador do evento roteado PreviewKeyDown. |
PreviewKeyUpEvent |
Obtém o identificador do evento roteado PreviewKeyUp. |
Projection |
Obtém ou define a projeção de perspectiva (efeito 3D) a ser aplicada ao renderizar esse elemento. |
ProjectionProperty |
Identifica a propriedade de dependência do Projection. |
RenderSize |
Obtém o tamanho final de renderização de umUIElement |
RenderTransform |
Obtém ou define informações de transformação que afetam a posição de renderização de umUIElement |
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. |
RenderTransformOriginProperty |
Identifica a propriedade de dependência |
RenderTransformProperty |
Identifica a propriedade de dependência |
RightTappedEvent |
Obtém o identificador do evento roteado |
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. |
RotationAxis |
Obtém ou define o eixo para girar o elemento ao redor. |
RotationTransition |
Obtém ou define o ScalarTransition que anima as alterações na propriedade Rotation. |
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. |
ScaleTransition |
Obtém ou define o Vector3Transition que anima as alterações na propriedade Scale. |
Shadow |
Obtém ou define o efeito de sombra convertido pelo elemento. |
ShadowProperty |
Identifica a propriedade de dependência |
TabFocusNavigation |
Obtém ou define um valor que modifica como o tabbing e TabIndex funcionam para esse controle. |
TabFocusNavigationProperty |
Identifica a propriedade de dependência |
TappedEvent |
Obtém o identificador do evento roteado |
Transform3D |
Obtém ou define o efeito de transformação 3D a ser aplicado ao renderizar esse elemento. |
Transform3DProperty |
Identifica a propriedade de dependência |
TransformMatrix |
Obtém ou define a matriz de transformação a ser aplicada ao elemento. |
Transitions |
Obtém ou define a coleção de elementos de estilo de Transição de |
TransitionsProperty |
Identifica a propriedade de dependência transições de |
Translation |
Obtém ou define a posição de renderização x, y e z do elemento. |
TranslationTransition |
Obtém ou define o Vector3Transition que anima as alterações na propriedade Translation. |
UIContext |
Obtém o identificador de contexto para o elemento. |
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. |
UseLayoutRoundingProperty |
Identifica a propriedade de dependência |
Visibility |
Obtém ou define a visibilidade de umUIElement |
VisibilityProperty |
Identifica a propriedade de dependência |
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 para baixo. |
XYFocusDownNavigationStrategyProperty |
Identifica a propriedade de dependência XYFocusDownNavigationStrategy. |
XYFocusKeyboardNavigation |
Obtém ou define um valor que habilita ou desabilita a navegação usando as setas direcionais do teclado. |
XYFocusKeyboardNavigationProperty |
Identifica a propriedade de dependência XYFocusKeyboardNavigation. |
XYFocusLeftNavigationStrategy |
Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação à esquerda. |
XYFocusLeftNavigationStrategyProperty |
Identifica a propriedade de dependência |
XYFocusRightNavigationStrategy |
Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação correta. |
XYFocusRightNavigationStrategyProperty |
Identifica a propriedade de dependência |
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. |
XYFocusUpNavigationStrategyProperty |
Identifica a propriedade de dependência |
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 verdadeiro para que o manipulador fornecido seja invocado mesmo se o evento for tratado em outro lugar. |
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. |
CancelDirectManipulations() |
Cancela o processamento contínuo de manipulação direta (movimento panorâmico/zoom definido pelo sistema) em qualquer |
CapturePointer(Pointer) |
Define a captura de ponteiro para umUIElement |
ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject) |
FindSubElementsForTouchTargeting(Point, Rect) |
Habilita uma subclasse UIElement para expor elementos filho que ajudam a resolver o direcionamento de toque. |
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) |
GetChildrenInTabFocusOrder() |
Habilita uma subclasse UIElement para expor elementos filho que participam do foco de Tab. |
GetValue(DependencyProperty) |
Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject) |
InvalidateArrange() |
Invalida o estado de organização (layout) para umUIElement |
InvalidateMeasure() |
Invalida o estado de medida (layout) de um UIElement. |
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. |
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Chamado antes que o evento |
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. |
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. |
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. |
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. |
PopulatePropertyInfo(String, AnimationPropertyInfo) |
Define uma propriedade que pode ser animada. |
PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
Quando substituído em uma classe derivada, define uma propriedade que pode ser animada. |
ReadLocalValue(DependencyProperty) |
Retorna o valor local de uma propriedade de dependência, se um valor local for definido. (Herdado de DependencyObject) |
RegisterAsScrollPort(UIElement) |
Registra um elemento como representando um visor rolável. |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registra uma função de notificação para ouvir alterações em um dependencyProperty |
ReleasePointerCapture(Pointer) |
Libera capturas de ponteiro para captura de um ponteiro específico por este UIElement . |
ReleasePointerCaptures() |
Libera todas as capturas de ponteiro mantidas por esse elemento. |
RemoveHandler(RoutedEvent, Object) |
Remove o manipulador de eventos roteado especificado deste UIElement . Normalmente, o manipulador em questão foi adicionado por AddHandler. |
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. |
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. |
StartBringIntoView(BringIntoViewOptions) |
Inicia uma solicitação para a estrutura XAML para colocar o elemento em exibição usando as opções especificadas. |
StartDragAsync(PointerPoint) |
Inicia uma operação de arrastar e soltar. |
StopAnimation(ICompositionAnimationBase) |
Interrompe a animação especificada no elemento. |
TransformToVisual(UIElement) |
Retorna um objeto de transformação que pode ser usado para transformar coordenadas do UIElement |
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
Tenta invocar um atalho de teclado (ou acelerador) pesquisando toda a árvore visual do UIElement para obter o atalho. |
TryStartDirectManipulation(Pointer) |
Retoma o processamento de manipulação direta (movimento panorâmico/zoom definido pelo sistema) em qualquer |
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. |
Eventos
AccessKeyDisplayDismissed |
Ocorre quando as chaves de acesso não devem mais ser exibidas. |
AccessKeyDisplayRequested |
Ocorre quando o usuário solicita que as chaves de acesso sejam exibidas. |
AccessKeyInvoked |
Ocorre quando um usuário conclui uma sequência de chaves de acesso. |
BringIntoViewRequested |
Ocorre quando StartBringIntoView é chamado nesse elemento ou em um de seus descendentes. |
CharacterReceived |
Ocorre quando um único caractere composto é recebido pela fila de entrada. |
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. |
ContextRequested |
Ocorre quando o usuário concluiu um gesto de entrada de contexto, como um clique com o botão direito do mouse. |
DoubleTapped |
Ocorre quando uma interação DoubleTap sem tratamento ocorre na área de teste de ocorrência desse elemento. |
DragEnter |
Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com esse elemento como destino. |
DragLeave |
Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com esse elemento como a origem. |
DragOver |
Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com esse elemento como o destino de queda potencial. |
DragStarting |
Ocorre quando uma operação de arrastar é iniciada. |
Drop |
Ocorre quando o sistema de entrada relata um evento de queda subjacente com esse elemento como o destino de soltar. |
DropCompleted |
Ocorre quando uma operação de arrastar e soltar com esse elemento como a origem é encerrada. |
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. |
GotFocus |
Ocorre quando um UIElement |
Holding |
Ocorre quando uma interação Hold sem tratamento ocorre na área de teste de ocorrência desse elemento. |
KeyDown |
Ocorre quando uma tecla de teclado é pressionada enquanto o UIElement tem foco. |
KeyUp |
Ocorre quando uma tecla de teclado é lançada enquanto o UIElement tem foco. |
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. |
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. |
ManipulationCompleted |
Ocorre quando uma manipulação no |
ManipulationDelta |
Ocorre quando o dispositivo de entrada altera a posição durante uma manipulação. |
ManipulationInertiaStarting |
Ocorre quando o dispositivo de entrada perde contato com o objeto UIElement durante o início de uma manipulação e inércia. |
ManipulationStarted |
Ocorre quando um dispositivo de entrada inicia uma manipulação no UIElement. |
ManipulationStarting |
Ocorre quando o processador de manipulação é criado pela primeira vez. |
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. |
PointerCanceled |
Ocorre quando um ponteiro que fez contato perde contato anormalmente. |
PointerCaptureLost |
Ocorre quando a captura de ponteiro anteriormente mantida por esse elemento se move para outro elemento ou em outro lugar. |
PointerEntered |
Ocorre quando um ponteiro entra na área de teste de ocorrência desse elemento. |
PointerExited |
Ocorre quando um ponteiro deixa a área de teste de ocorrência desse elemento. |
PointerMoved |
Ocorre quando um ponteiro se move enquanto o ponteiro permanece dentro da área de teste de ocorrência desse elemento. |
PointerPressed |
Ocorre quando o dispositivo de ponteiro inicia uma ação Pressione dentro desse elemento. |
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. |
PointerWheelChanged |
Ocorre quando o valor delta de uma roda de ponteiro é alterado. |
PreviewKeyDown |
Ocorre quando uma tecla de teclado é pressionada enquanto o UIElement tem foco. |
PreviewKeyUp |
Ocorre quando uma tecla de teclado é lançada enquanto o UIElement tem foco. |
ProcessKeyboardAccelerators |
Ocorre quando um atalho de teclado (ou acelerador) é pressionado. |
RightTapped |
Ocorre quando ocorre um estímulo de entrada de toque à direita enquanto o ponteiro está sobre o elemento. |
Tapped |
Ocorre quando uma interação Toque sem tratamento ocorre na área de teste de ocorrência desse elemento. |
Aplica-se a
Confira também
- DependencyObject
- FrameworkElement
- Visão geral de Eventos e eventos roteado
- Visão geral das propriedades de dependência
- arrastar e soltar de exemplo
- de exemplo de entrada básico
- exemplo de animações Transform3D