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 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 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 Windows Runtime.
Embora UIElement defina os eventos para relatórios de foco (GotFocus, LostFocus), UIElement não define uma API para definir programaticamente o foco. Essa funcionalidade é definida pela classe Control .
UIElement não expõe um construtor público. Normalmente, você não deriva classes de UIElement ou FrameworkElement diretamente. As classes base mais usadas normalmente para classes personalizadas derivadas são estas classes:
- Controles específicos que não estão selados (por exemplo, TextBox)
- Classes base de controle (Control, ContentControl, UserControl)
- Elementos de navegação (Page, Frame)
- Classes de painel (o Painel de classe base ou implementações não lacradas específicas, como Grade)
A classe UIElement é usada como o parâmetro de tipo de muitas propriedades e métodos na API de Windows Runtime. Por exemplo, a propriedade Child de Border usa um único UIElement, que representa o elemento ao qual a Borda é desenhada. 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 .
Uielement API e recursos
UIElement estende DependencyObject, que é outro elemento base, e adiciona suporte para várias áreas de recursos 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 interações de teclado, mouse, toque, arrastar e foco. Para obter mais informações, consulte Entrada de ponteiro de identificador, Interações de teclado e Interações personalizadas do usuário.
API proeminente de UIElement que dá suporte à entrada e à interação do usuário:
- Eventos de ponteiro:PointerPressed, PointerReleased, PointerMoved, PointerEntered, PointerExited
- Eventos de manipulaçãode chave:KeyDown, KeyUp
- Focus: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 por 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 de 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 Visibility e Opacity são frequentemente usadas para ajustar a aparência de um elemento em sua interface do usuário, especialmente em estilos, modelos e estados visuais. As propriedades Clip, RenderTransform e Transitions são úteis para produzir interações e diferentes aparências para os elementos da interface do usuário.
Layout básico
A classe UIElement fornece um ponto de partida para características de layout com propriedades como DesiredSize e os métodos Arrange e Measure . FrameworkElement adiciona mais recursos de layout. Para obter mais informações, consulte Definir layouts com XAML e FrameworkElement.
Eventos roteados
A maioria dos eventos de entrada de UIElement são eventos roteado. Um evento roteado habilita um sistema de notificação de manipulação de eventos interno, para que um objeto pai possa manipular 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 saber mais, confira Visão geral de eventos e eventos roteados.
API proeminente de UIElement que dá suporte a eventos roteado: AddHandler, RemoveHandler, *Propriedades do evento .
Suporte a outra plataforma
- OnCreateAutomationPeer permite que uma classe use um AutomationPeer 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 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 UIElement
O único Windows Runtime classe que deriva diretamente de UIElement é FrameworkElement. Para obter uma lista das classes derivadas de FrameworkElement, consulte a seção "Classes derivadas de FrameworkElement " do tópico de referência FrameworkElement .
Histórico de versão
Versão do Windows | Versão do SDK | Valor adicionado |
---|---|---|
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 |
1.709 | 16299 | CharacterReceived |
1.709 | 16299 | CharacterReceivedEvent |
1.709 | 16299 | GetChildrenInTabFocusOrder |
1.709 | 16299 | KeyboardAccelerators |
1.709 | 16299 | OnProcessKeyboardAccelerators |
1.709 | 16299 | Previewkeydown |
1.709 | 16299 | PreviewKeyDownEvent |
1.709 | 16299 | Previewkeyup |
1.709 | 16299 | PreviewKeyUpEvent |
1.709 | 16299 | ProcessKeyboardAccelerators |
1.709 | 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 | Shadow |
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 AccessKey . |
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 calculou 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 AllowDrop . |
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 CacheMode . |
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 CanDrag . |
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 CharacterReceived . |
Clip |
Obtém ou define o RectangleGeometry usado para definir a estrutura de tópicos do conteúdo de um UIElement. |
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 que estão envolvidos em uma interface do usuário XAML/Microsoft DirectX mista. |
CompositeModeProperty |
Identifica a propriedade de dependência CompositeMode . |
ContextFlyout |
Obtém ou define o submenu associado a esse elemento. |
ContextFlyoutProperty |
Identifica a propriedade de dependência ContextFlyout . |
ContextRequestedEvent |
Obtém o identificador do evento roteado ContextRequested. |
DesiredSize |
Obtém o tamanho que esse UIElement calculou durante a passagem de 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 DoubleTapped . |
DragEnterEvent |
Obtém o identificador do evento roteado DragEnter . |
DragLeaveEvent |
Obtém o identificador do evento roteado DragLeave . |
DragOverEvent |
Obtém o identificador do evento roteado DragOver . |
DropEvent |
Obtém o identificador do evento roteado Drop . |
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 GettingFocus . |
HighContrastAdjustment |
Obtém ou define um valor que indica se a estrutura ajusta automaticamente as propriedades visuais do elemento quando temas de alto contraste estão habilitados. |
HighContrastAdjustmentProperty |
Identifica a propriedade de dependência HighContrastAdjustment . |
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 IsAccessKeyScope . |
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 desse UIElement pode retornar valores verdadeiros para teste de clique. |
IsHitTestVisibleProperty |
Identifica a propriedade de dependência IsHitTestVisible . |
IsHoldingEnabled |
Obtém ou define um valor que determina se o evento Holding pode ser originado desse elemento. |
IsHoldingEnabledProperty |
Identifica a propriedade de dependência IsHoldingEnabled . |
IsRightTapEnabled |
Obtém ou define um valor que determina se o evento RightTapped pode ser originado desse elemento. |
IsRightTapEnabledProperty |
Identifica a propriedade de dependência IsRightTapEnabled . |
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 IsTapEnabled . |
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. |
KeyboardAcceleratorPlacementModeProperty |
Identifica a propriedade de dependência KeyboardAcceleratorPlacementMode . |
KeyboardAcceleratorPlacementTarget |
Obtém ou define um valor que indica a dica de ferramenta de controle que exibe a combinação de teclas aceleradoras. |
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 KeyDown . |
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 tecla 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 tecla de acesso. |
KeyTipTargetProperty |
Identifica a propriedade de dependência KeyTipTarget . |
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. |
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 anexados a esse elemento. |
LightsProperty |
Identifica a propriedade de dependência Lights . |
LosingFocusEvent |
Obtém o identificador do evento roteado LosingFocus . |
ManipulationCompletedEvent |
Obtém o identificador do evento roteado ManipulationCompleted . |
ManipulationDeltaEvent |
Obtém o identificador do evento roteado ManipulationDelta . |
ManipulationInertiaStartingEvent |
Obtém o identificador do evento roteado ManipulationInertiaStarting . |
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. |
ManipulationModeProperty |
Identifica a propriedade de dependência ManipulationMode . |
ManipulationStartedEvent |
Obtém o identificador do evento roteado ManipulationStarted . |
ManipulationStartingEvent |
Obtém o identificador do evento roteado ManipulationStarting . |
NoFocusCandidateFoundEvent |
Obtém o identificador do evento roteado NoFocusCandidateFound . |
Opacity |
Obtém ou define o grau de opacidade do objeto. |
OpacityProperty |
Identifica a propriedade de dependência IsHitTestVisible . |
OpacityTransition |
Obtém ou define o ScalarTransition que anima as alterações na propriedade Opacity. |
PointerCanceledEvent |
Obtém o identificador do evento roteado PointerCanceled . |
PointerCaptureLostEvent |
Obtém o identificador do evento roteado PointerCaptureLost . |
PointerCaptures |
Obtém o conjunto de todos os ponteiros capturados, representados como valores pointer . |
PointerCapturesProperty |
Identifica a propriedade de dependência PointerCaptures . |
PointerEnteredEvent |
Obtém o identificador do evento roteado PointerEntered . |
PointerExitedEvent |
Obtém o identificador do evento roteado PointerExited . |
PointerMovedEvent |
Obtém o identificador do evento roteado PointerMoved . |
PointerPressedEvent |
Obtém o identificador do evento roteado PointerPressed . |
PointerReleasedEvent |
Obtém o identificador do evento roteado PointerReleased . |
PointerWheelChangedEvent |
Obtém o identificador do evento roteado PointerWheelChanged . |
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 Projeção . |
RenderSize |
Obtém o tamanho de renderização final de um UIElement. O uso não é recomendado, consulte Comentários. |
RenderTransform |
Obtém ou define informações de transformação que afetam a posição de renderização de um 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. |
RenderTransformOriginProperty |
Identifica a propriedade de dependência RenderTransformOrigin . |
RenderTransformProperty |
Identifica a propriedade de dependência RenderTransform . |
RightTappedEvent |
Obtém o identificador do evento roteado RightTapped . |
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 Shadow . |
TabFocusNavigation |
Obtém ou define um valor que modifica como o tabbing e o TabIndex funcionam para esse controle. |
TabFocusNavigationProperty |
Identifica a propriedade de dependência TabFocusNavigation . |
TappedEvent |
Obtém o identificador para o evento roteado tocado . |
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 Transform3D . |
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 que se aplicam a um UIElement. |
TransitionsProperty |
Identifica a propriedade de dependência Transições . |
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 UseLayoutRounding . |
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. |
VisibilityProperty |
Identifica a propriedade de dependência Visibility . |
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 XYFocusLeftNavigationStrategy . |
XYFocusRightNavigationStrategy |
Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação à direita. |
XYFocusRightNavigationStrategyProperty |
Identifica a propriedade de dependência XYFocusRightNavigationStrategy . |
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 XYFocusUpNavigationStrategy . |
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. |
Arrange(Rect) |
Posiciona objetos filho e determina um tamanho para um UIElement. Objetos pai que implementam 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. |
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. |
CapturePointer(Pointer) |
Define a captura de ponteiro para um UIElement. Depois de capturado, somente o elemento que tem captura disparará eventos relacionados ao ponteiro. |
ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject) |
FindSubElementsForTouchTargeting(Point, Rect) |
Permite que uma subclasse UIElement exponha 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 nos casos em que uma animação não está ativa. (Herdado de DependencyObject) |
GetChildrenInTabFocusOrder() |
Permite que uma subclasse UIElement exponha 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 um UIElement. Após a invalidação, o UIElement terá seu layout atualizado, o que ocorrerá de forma assíncrona. |
InvalidateMeasure() |
Invalida o estado de medida (layout) de um UIElement. |
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. |
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Chamado antes que o evento BringIntoViewRequested ocorra. |
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 forma como seu aplicativo responde quando um acelerador de teclado é invocado. |
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. |
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 escutar alterações em uma DependencyProperty específica nessa instância dependencyObject . (Herdado de DependencyObject) |
ReleasePointerCapture(Pointer) |
Libera capturas de ponteiro para captura de um ponteiro específico por esse UIElement. |
ReleasePointerCaptures() |
Libera todas as capturas de ponteiro mantidas por esse elemento. |
RemoveHandler(RoutedEvent, Object) |
Remove o manipulador de eventos roteado especificado desse 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 todas as regiões roláveis 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 do tipo "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 para o objeto especificado. |
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 pai ScrollViewer que contenha o UIElement atual. |
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 clique desse elemento. |
DragEnter |
Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com esse elemento como o 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 do tipo "arrastar" subjacente com esse elemento como a reprodução automática potencial. |
DragStarting |
Ocorre quando uma operação de arrastar é iniciada. |
Drop |
Ocorre quando o sistema de entrada relata um evento soltar subjacente com esse elemento sendo uma reprodução automática. |
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 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. |
Holding |
Ocorre quando uma interação hold sem tratamento ocorre na área de teste de clique desse elemento. |
KeyDown |
Ocorre quando uma tecla de teclado é pressionada enquanto o UIElement tem foco. |
KeyUp |
Ocorre quando uma tecla de teclado é liberada 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 UIElement é concluída. |
ManipulationDelta |
Ocorre quando o dispositivo de entrada muda de posição durante uma manipulação. |
ManipulationInertiaStarting |
Ocorre quando o dispositivo de entrada perde contato com o objeto UIElement durante a manipulação e a inércia começa. |
ManipulationStarted |
Ocorre quando um dispositivo de entrada inicia uma manipulação no UIElement. |
ManipulationStarting |
Ocorre quando o processador de manipulação é criado. |
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. |
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 clique desse elemento. |
PointerExited |
Ocorre quando um ponteiro sai da área de teste de clique desse elemento. |
PointerMoved |
Ocorre quando um ponteiro se move enquanto o ponteiro permanece dentro da área de teste de clique desse elemento. |
PointerPressed |
Ocorre quando o dispositivo de ponteiro inicia uma ação Pressionar dentro desse elemento. |
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. |
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 é liberada 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 direito enquanto o ponteiro está sobre o elemento . |
Tapped |
Ocorre quando ocorre uma interação de toque sem tratamento na área de teste de ocorrência desse elemento. |
Aplica-se a
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários