Microsoft.UI.Xaml Namespace
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 APIs de estrutura geral para o Biblioteca de interface do usuário do Windows (WinUI).
Classes
| Nome | Description |
|---|---|
| AdaptiveTrigger |
Representa uma regra declarativa que aplica estados visuais com base nas propriedades da janela. |
| Application |
Representa o aplicativo atual e seus serviços disponíveis. |
| ApplicationInitializationCallbackParams |
Representa um objeto para passar informações para uma sequência de inicialização personalizada. (Obsoleto) |
| BindingFailedEventArgs |
Fornece dados de evento para o evento DebugSettings.BindingFailed . |
| BringIntoViewOptions |
Representa as opções que podem ser aplicadas quando um elemento é colocado em exibição. |
| BringIntoViewRequestedEventArgs |
Fornece dados para o evento UIElement.BringIntoViewRequested . |
| BrushTransition |
Fornece o comportamento de transição animado quando o pincel de um elemento é alterado. Atualmente limitado a alterações entre |
| ColorPaletteResources |
Representa um dicionário de recursos especializado que contém recursos de cores usados por elementos XAML. |
| CornerRadiusHelper |
Fornece métodos utilitários básicos para processar valores de CornerRadius . Em vez disso, o código C# deve usar métodos de CornerRadius . |
| DataContextChangedEventArgs |
Fornece dados para o evento DataContextChanged . |
| DataTemplate |
Descreve a estrutura visual de um objeto de dados. Use a associação de dados para elementos específicos no modelo que exibem os valores de dados. |
| DataTemplateKey |
Representa a chave de recurso da classe DataTemplate . |
| DebugSettings |
Declara como determinados aspectos do aplicativo se comportam quando ele é executado em um ambiente de depuração |
| DependencyObject |
Representa um objeto que participa do sistema de propriedades de dependência. |
| DependencyObjectCollection |
Implementa uma classe de coleção prática que pode conter itens DependencyObject . |
| DependencyProperty |
Representa uma propriedade de dependência registrada com o sistema de propriedades de dependência. As propriedades de dependência fornecem suporte para expressões de valor, associação de dados, animação e notificação de alteração de propriedade. Para obter mais informações sobre como os valores dependencyProperty servem como identificadores para propriedades de dependência, consulte a visão geral das propriedades de dependência. |
| DependencyPropertyChangedEventArgs |
Fornece dados para uma implementação PropertyChangedCallback que é invocada quando uma propriedade de dependência altera seu valor. Também fornece dados de evento para o evento Control.IsEnabledChanged e qualquer outro evento que use o delegado DependencyPropertyChangedEventHandler . |
| DispatcherTimer |
Fornece um temporizador integrado à fila do Dispatcher , que é processado em um intervalo de tempo especificado e em uma prioridade especificada. |
| DragEventArgs |
Fornece dados para eventos de arrastar e soltar. |
| DragOperationDeferral |
Permite arrastar e soltar conteúdo com um aplicativo de destino de forma assíncrona. |
| DragStartingEventArgs |
Fornece dados de evento para o evento DragStarting . |
| DragUI |
Fornece a representação visual dos dados que estão sendo arrastados no início de uma operação de arrastar e soltar. |
| DragUIOverride |
Fornece a representação visual dos dados que estão sendo arrastados durante uma operação de arrastar e soltar, incluindo comentários do destino suspenso. |
| DropCompletedEventArgs |
Fornece dados de evento para o evento DropCompleted . |
| DurationHelper |
Fornece métodos utilitários básicos para processar valores de duração . Em vez disso, o código C# deve usar métodos de Duração . |
| EffectiveViewportChangedEventArgs |
Fornece dados para o evento FrameworkElement.EffectiveViewportChanged . |
| ElementFactoryGetArgs |
Representa os argumentos opcionais a serem usados ao chamar uma implementação do método GetElement do IElementFactory. |
| ElementFactoryRecycleArgs |
Representa os argumentos opcionais a serem usados ao chamar uma implementação do método RecycleElement do IElementFactory. |
| ElementSoundPlayer |
Representa um player para sons de controle XAML. |
| EventTrigger |
Representa um gatilho que aplica um conjunto de ações (storyboards de animação) em resposta a um evento. Não usado com frequência. Consulte Comentários. |
| ExceptionRoutedEventArgs |
Fornece dados de evento para exceções que são geradas como eventos por operações assíncronas, como ImageFailed. |
| FrameworkElement |
Fornece uma classe de elemento base para Windows Runtime objetos de interface do usuário.
|
| FrameworkTemplate |
Cria uma árvore de elementos. FrameworkTemplate é uma classe base para classes que têm um comportamento específico de modelagem, incluindo ControlTemplate e DataTemplate. |
| FrameworkView |
Representa a janela da interface do usuário de um aplicativo. |
| FrameworkViewSource |
Cria exibições, especificamente instâncias do FrameworkView . Essa é a infraestrutura e não precisa ser acessada na maioria dos cenários de aplicativo. |
| GridLengthHelper |
Fornece métodos auxiliares para avaliar ou definir valores gridLength . Em vez disso, o código C# deve usar métodos de GridLength . |
| LaunchActivatedEventArgs |
Fornece informações de evento para o evento Application.OnLaunched . |
| MediaFailedRoutedEventArgs |
Fornece dados de evento para o evento MediaElement.MediaFailed . |
| PointHelper |
Fornece métodos auxiliares para definir valores de ponto. Em vez disso, o código C# deve usar métodos de Ponto . |
| PropertyMetadata |
Define aspectos de comportamento de uma propriedade de dependência, incluindo condições com as quais ela foi registrada. Para obter mais informações sobre como |
| PropertyPath |
Implementa uma estrutura de dados para descrever uma propriedade como um caminho abaixo de outra propriedade ou abaixo de um tipo proprietário. Os caminhos de propriedade são usados na associação de dados a objetos. |
| RectHelper |
Fornece métodos auxiliares para avaliar ou definir valores de Rect . Em vez disso, o código C# deve usar membros do Rect . |
| ResourceDictionary |
Define um repositório para recursos XAML, como estilos, que seu aplicativo usa. Você define os recursos em XAML e pode recuperá-los em XAML usando a extensão de marcação {StaticResource} e a extensão de marcação {ThemeResource}. Você também pode acessar recursos com código, mas isso é menos comum. |
| ResourceManagerRequestedEventArgs |
Fornece dados de evento para o |
| RoutedEvent |
Representa um evento roteado para o sistema de eventos Windows Runtime. |
| RoutedEventArgs |
Contém informações de estado e dados de evento associados a um evento roteado. |
| ScalarTransition |
Fornece o comportamento de transição animado quando as propriedades Opacity ou Rotation de um elemento são alteradas. |
| Setter |
Aplica um valor a uma propriedade em um Style ou um VisualState. |
| SetterBase |
Representa a classe base para setters de valor. |
| SetterBaseCollection |
Representa uma coleção de objetos que herdam do SetterBase. |
| SizeChangedEventArgs |
Fornece dados relacionados ao evento FrameworkElement.SizeChanged . |
| SizeHelper |
Fornece métodos auxiliares para avaliar ou definir valores de tamanho . Em vez disso, o código C# deve usar membros do Tamanho . |
| StateTrigger |
Representa um gatilho que aplica estados visuais condicionalmente. |
| StateTriggerBase |
Representa a classe base para gatilhos de estado. |
| Style |
Contém setters de propriedade que podem ser compartilhados entre instâncias de um tipo. Um |
| StyleTypedPropertyAttribute |
Representa um atributo que é aplicado à definição de classe e determina os TargetTypes das propriedades que são do tipo Style. |
| TargetPropertyPath |
Representa o caminho para uma propriedade em um elemento de destino. |
| TemplatePartAttribute |
Representa um atributo que é aplicado à definição de classe para identificar os tipos de partes nomeadas que são usadas para modelagem. |
| TemplateVisualStateAttribute |
Especifica que um controle pode estar em um determinado estado e que um VisualState é esperado no ControlTemplate do controle. |
| ThicknessHelper |
Fornece métodos auxiliares para avaliar ou definir valores de espessura . Em vez disso, o código C# deve usar membros de Espessura . |
| TriggerAction |
Serve como a classe base para BeginStoryboard. Não usado com frequência. Consulte Comentários. |
| TriggerActionCollection |
Representa uma coleção de objetos BeginStoryboard . |
| TriggerBase |
Serve como a classe base para EventTrigger. Não usado com frequência. Consulte Comentários. |
| TriggerCollection |
Representa uma coleção de objetos EventTrigger . |
| UIElement |
|
| UIElementWeakCollection |
Representa uma coleção de referências fracas para objetos UIElement. |
| UnhandledExceptionEventArgs |
Fornece dados para o evento UnhandledException . |
| Vector3Transition |
Fornece o comportamento de transição animado quando as propriedades De Tradução ou Escala de um elemento são alteradas. |
| VisualState |
Representa a aparência visual de um elemento de interface do usuário quando ele está em um estado específico. Os estados visuais usam Setters ou um Storyboard para definir propriedades de interface do usuário dentro de páginas ou modelos de controle em que a |
| VisualStateChangedEventArgs |
Fornece dados para os eventos CurrentStateChanging e CurrentStateChanged . |
| VisualStateGroup |
Contém objetos VisualState mutuamente exclusivos e objetos VisualTransition que são usados para ir de um estado para outro. |
| VisualStateManager |
Gerencia estados visuais e a lógica de transições entre estados visuais para controles. Também fornece o suporte à propriedade anexada para |
| VisualTransition |
Representa o comportamento visual que ocorre quando o controle faz a transição de um estado visual para outro. |
| Window |
Representa uma janela do aplicativo atual. |
| WindowActivatedEventArgs |
Contém as informações de estado de ativação da janela retornadas pelo Microsoft. UI. Evento Xaml.Window.Activated. |
| WindowEventArgs |
Contém as informações de estado da janela retornadas pelo evento Window.Closed . |
| WindowSizeChangedEventArgs |
Contém as informações de estado de tamanho da janela retornadas pelo evento Window.SizeChanged . |
| WindowVisibilityChangedEventArgs |
Contém as informações de estado de visibilidade da janela retornadas pelo evento Window.VisibilityChanged . |
| XamlIsland |
Define um objeto que permite que um aplicativo hospede fragmentos de conteúdo XAML. |
| XamlResourceReferenceFailedEventArgs |
Fornece dados de evento para o |
| XamlRoot |
Representa uma árvore de conteúdo XAML e informações sobre o contexto no qual ele está hospedado. |
| XamlRootChangedEventArgs |
Fornece dados para o evento XamlRoot.Changed. |
Estruturas
| Nome | Description |
|---|---|
| CornerRadius |
Descreve as características de um canto arredondado, como pode ser aplicado a uma borda. |
| Duration |
Representa a duração do tempo em que uma Linha do Tempo está ativa ou, em geral, representa uma duração de tempo que também dá suporte a dois valores |
| GridLength |
Representa uma medida para a lógica de controle que dá suporte explicitamente ao dimensionamento star (* ) e ao dimensionamento automático. |
| Thickness |
Descreve a espessura de um quadro em torno de um retângulo. Quatro valores duplos descrevem os lados Esquerdo, Superior, Direito e Inferior do retângulo, respectivamente. |
Interfaces
| Nome | Description |
|---|---|
| IDataTemplateExtension |
Define métodos auxiliares para renderização em fases de um modelo de dados. |
| IElementFactory |
Dá suporte à criação e à reciclagem de objetos UIElement . |
| IXamlServiceProvider |
Define um mecanismo para recuperar um objeto de serviço; ou seja, um objeto que fornece suporte personalizado a outros objetos. |
Enumerações
| Nome | Description |
|---|---|
| ApplicationHighContrastAdjustment |
Define constantes que especificam se a estrutura ajusta automaticamente as propriedades visuais do aplicativo quando os temas de alto contraste estão habilitados. |
| ApplicationRequiresPointerMode |
Important Não use. Não há suporte para ApplicationRequiresPointerMode no SDK do Aplicativo Windows. Especifica as experiências de interação para dispositivos sem ponteiro, como um teclado ou controlador de jogo. |
| ApplicationTheme |
Declara a preferência de tema para um aplicativo. |
| AutomationTextAttributesEnum |
Define constantes que identificam atributos de texto de um intervalo de texto Microsoft Automação da Interface do Usuário. |
| DispatcherShutdownMode |
Define constantes que especificam como um aplicativo será desligado. |
| DurationType |
Declara se uma Duração tem um valor especial de Automático ou Para Sempre ou tem informações válidas em seu |
| ElementHighContrastAdjustment |
Define constantes que especificam se a estrutura ajusta automaticamente as propriedades visuais de um elemento quando os temas de alto contraste estão habilitados. |
| ElementSoundKind |
Define constantes que especificam o som reproduzido pelo método ElementSoundPlayer.Play . |
| ElementSoundMode |
Define constantes que especificam a preferência de um controle para se os sons são reproduzidos. |
| ElementSoundPlayerState |
Define constantes que especificam se os controles XAML reproduzem sons. |
| ElementSpatialAudioMode |
Define constantes que indicam se o som espacial está ativado, desativado ou manipulado automaticamente. |
| ElementTheme |
Especifica um tema de interface do usuário que deve ser usado para partes de UIElement individuais de uma interface do usuário do aplicativo. |
| FlowDirection |
Define constantes que especificam a direção do fluxo de conteúdo para elementos de texto e interface do usuário. |
| FocusState |
Descreve como um elemento obteve o foco. |
| FocusVisualKind |
Especifica os comentários visuais usados para indicar o elemento de interface do usuário com foco ao navegar com um teclado ou controlador de jogo. |
| FontCapitals |
Descreve o valor de estilo de letra maiúscula para a propriedade anexada Typography.Capitals . |
| FontEastAsianLanguage |
Fornece um mecanismo para selecionar versões específicas de fonte de glifos para um sistema de escrita ou idioma especificado do Leste Asiático. |
| FontEastAsianWidths |
Fornece um mecanismo para selecionar glifos de estilos de largura diferentes. |
| FontFraction |
Descreve um valor de estilo de fração para a propriedade anexada Typography.Fraction . |
| FontNumeralAlignment |
Descreve o valor de alinhamento numeral da propriedade anexada Typography.NumeralAlignment . |
| FontNumeralStyle |
Descreve um valor de estilo numeral para a propriedade anexada Typography.NumeralStyle . |
| FontVariants |
Descreve um valor de variante de fonte para a propriedade anexada Typography.Variants . |
| GridUnitType |
Descreve o tipo de valor que um objeto GridLength está segurando. |
| HorizontalAlignment |
Indica onde um elemento deve ser exibido no eixo horizontal em relação ao slot de layout alocado do elemento pai. |
| LayoutCycleDebugBreakLevel |
Define constantes que especificam qual nível de eventos de rastreamento de ciclo de layout devem disparar um ponto de interrupção do depurador quando uma falha de ciclo de layout parece iminente. |
| LayoutCycleTracingLevel |
Define constantes que especificam se as informações de rastreamento do ciclo de layout são gravadas no depurador nativo e no nível de detalhes que é registrado. |
| LineStackingStrategy |
Descreve o mecanismo pelo qual uma caixa de linha é determinada para cada linha. |
| OpticalMarginAlignment |
Especifica como os valores de rolagem lateral na tipografia por caractere são tratados ao se alinharem a um limite de contêiner de texto. |
| TextAlignment |
Especifica se o texto está centralizado, alinhado à esquerda ou alinhado à direita. |
| TextLineBounds |
Influencia como a altura de uma caixa de linha é calculada |
| TextReadingOrder |
Fornece um valor para |
| TextTrimming |
Descreve como o texto é cortado quando ultrapassa a borda de sua caixa de contenção. |
| TextWrapping |
Especifica se o texto encapsula quando atinge a borda de seu contêiner. |
| Vector3TransitionComponents |
Define constantes que especificam quais eixos animar durante a animação Vector3Transition. |
| VerticalAlignment |
Descreve como um elemento filho é posicionado verticalmente ou estendido dentro do slot de layout de um pai. |
| Visibility |
Especifica o estado de exibição de um elemento. |
| WindowActivationState |
Especifica os motivos para um evento ativado ser gerado em uma janela. |
Delegados
| Nome | Description |
|---|---|
| ApplicationInitializationCallback |
Representa o retorno de chamada que deve ser invocado durante a sequência de inicialização. |
| BindingFailedEventHandler |
Representa o método que manipulará o evento DebugSettings.BindingFailed . |
| CreateDefaultValueCallback |
Representa o método que pode ser invocado como parte de um construtor PropertyMetadata para adiar a definição de um valor padrão da propriedade de dependência. |
| DependencyPropertyChangedCallback |
Representa o retorno de chamada que é invocado quando um valor de propriedade é alterado para notificações de alteração de propriedade que são registradas com a técnica RegisterPropertyChangedCallback . |
| DependencyPropertyChangedEventHandler |
Representa o método que manipulará eventos que ocorrem quando um DependencyProperty é alterado em uma implementação de DependencyObject específica. |
| DragEventHandler |
Representa o método que manipulará os eventos DragEnter, DragLeave, DragOver e Drop de um UIElement. |
| EnteredBackgroundEventHandler |
O manipulador do evento Application.EnteredBackground. |
| ExceptionRoutedEventHandler |
Representa o método que manipulará determinados eventos que relatam exceções. Essas exceções geralmente vêm de operações assíncronas. |
| LeavingBackgroundEventHandler |
O manipulador do evento Application.LeavingBackground. |
| PropertyChangedCallback |
Representa o retorno de chamada que é invocado quando o valor efetivo da propriedade de uma propriedade de dependência é alterado. |
| RoutedEventHandler |
Representa o método que manipulará eventos roteado. |
| SizeChangedEventHandler |
Representa o método que manipulará o evento SizeChanged . |
| SuspendingEventHandler |
O manipulador do evento Application.Suspending. |
| UnhandledExceptionEventHandler |
Representa o método que manipulará o evento UnhandledException . |
| VisualStateChangedEventHandler |
Representa o método que manipulará os eventos CurrentStateChanging e CurrentStateChanged . |
Exemplos
O aplicativo Galeria da WinUI 3 inclui exemplos interativos da maioria dos controles, recursos e funcionalidades da WinUI 3. Obtenha o aplicativo na Microsoft Store ou obtenha o código-fonte no GitHub.