ContentDialog Classe

Referência

Definição

Namespace:: Microsoft.UI.Xaml.Controls

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.

Editar

Representa uma caixa de diálogo que pode ser personalizada para conter caixas de seleção, hiperlinks, botões e qualquer outro conteúdo XAML.

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ContentDialog : ContentControl

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ContentDialog : ContentControl

Public Class ContentDialog
Inherits ContentControl

<ContentDialog .../>
-or-
<ContentDialog>
    singleObject
</ContentDialog>
-or-
<ContentDialog>stringContent</ContentDialog>

Herança: Object IInspectable DependencyObject UIElement FrameworkElement Control ContentControl ContentDialog

Atributos: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemplos

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte Controles de caixa de diálogo.

Abra o aplicativo Galeria do WinUI 3 e veja o ContentDialog em ação.

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 o código-fonte no GitHub.

Este exemplo mostra como criar e mostrar um ContentDialog simples no código.

Importante

Este exemplo pressupõe que a caixa de diálogo seja mostrada de uma Página. Para mostrar a caixa de diálogo de uma Janela, consulte a seção Definir o XamlRoot dos Comentários.

private async void DisplayNoWifiDialog()
{
    ContentDialog noWifiDialog = new ContentDialog()
    {
        XamlRoot = this.XamlRoot,
        Title = "No wifi connection",
        Content = "Check connection and try again.",
        CloseButtonText = "Ok"
    };

    await noWifiDialog.ShowAsync();
}

Este exemplo mostra como criar um ContentDialog no XAML de uma página de aplicativo. Embora a caixa de diálogo seja definida na página do aplicativo, ela não será mostrada até que você chame ShowAsync em seu código.

Aqui, a propriedade IsPrimaryButtonEnabled é definida falsecomo . O botão primário é habilitado no código quando o usuário verifica a CheckBox para confirmar sua idade.

A propriedade TitleTemplate é usada para criar um título que inclui um logotipo e um texto.

<ContentDialog x:Name="termsOfUseContentDialog"
           PrimaryButtonText="Accept" IsPrimaryButtonEnabled="False"
           CloseButtonText="Cancel"
           Opened="TermsOfUseContentDialog_Opened">
    <ContentDialog.TitleTemplate>
        <DataTemplate>
            <StackPanel Orientation="Horizontal">
                <Image Source="ms-appx:///Assets/SmallLogo.png" Width="40" Height="40" Margin="10,0"/>
                <TextBlock Text="Terms of use"/>
            </StackPanel>
        </DataTemplate>
    </ContentDialog.TitleTemplate>
    <StackPanel>
        <TextBlock TextWrapping="WrapWholeWords">
        <Run>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Maecenas porttitor
             congue massa. Fusce posuere, magna sed pulvinar ultricies, purus lectus
             malesuada libero, sit amet commodo magna eros quis urna.</Run><LineBreak/>
        <Run>Nunc viverra imperdiet enim. Fusce est. Vivamus a tellus.</Run><LineBreak/>
        <Run>Pellentesque habitant morbi tristique senectus et netus et malesuada fames
             ac turpis egestas. Proin pharetra nonummy pede. Mauris et orci.</Run><LineBreak/>
        <Run>Suspendisse dui purus, scelerisque at, vulputate vitae, pretium mattis, nunc.
             Mauris eget neque at sem venenatis eleifend. Ut nonummy.</Run>
        </TextBlock>
        <CheckBox x:Name="ConfirmAgeCheckBox" Content="I am over 13 years of age."
              Checked="ConfirmAgeCheckBox_Checked" Unchecked="ConfirmAgeCheckBox_Unchecked"/>
    </StackPanel>
</ContentDialog>

private async void ShowTermsOfUseContentDialogButton_Click(object sender, RoutedEventArgs e)
{
    termsOfUseContentDialog.XamlRoot = this.XamlRoot;
    ContentDialogResult result = await termsOfUseContentDialog.ShowAsync();
    if (result == ContentDialogResult.Primary)
    {
        // Terms of use were accepted.
    }
    else
    {
        // User pressed Cancel, ESC, or the back arrow.
        // Terms of use were not accepted.
    }
}

private void TermsOfUseContentDialog_Opened(ContentDialog sender, ContentDialogOpenedEventArgs args)
{
    // Ensure that the check box is unchecked each time the dialog opens.
    ConfirmAgeCheckBox.IsChecked = false;
}

private void ConfirmAgeCheckBox_Checked(object sender, RoutedEventArgs e)
{
    termsOfUseContentDialog.IsPrimaryButtonEnabled = true;
}

private void ConfirmAgeCheckBox_Unchecked(object sender, RoutedEventArgs e)
{
    termsOfUseContentDialog.IsPrimaryButtonEnabled = false;
}

Este exemplo mostra como criar e usar uma caixa de diálogo personalizada mais complexa (SignInContentDialog) derivada de ContentDialog. Consulte também a seção Controles derivados com estilos WinUI deste artigo.

<ContentDialog
    x:Class="ContentDialog_WinUI3.SignInContentDialog"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:ContentDialog_WinUI3"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d"
    Title="SIGN IN"
    PrimaryButtonText="Sign In"  
    CloseButtonText="Cancel"
    PrimaryButtonClick="ContentDialog_PrimaryButtonClick"
    CloseButtonClick="ContentDialog_CloseButtonClick">

    <ContentDialog.Resources>
        <Style TargetType="local:SignInContentDialog" BasedOn="{StaticResource DefaultContentDialogStyle}"/>
    </ContentDialog.Resources>

    <StackPanel VerticalAlignment="Stretch" HorizontalAlignment="Stretch">
        <TextBox Name="userNameTextBox" Header="User name"
                 TextChanged="UserNameTextBox_TextChanged"/>
        <PasswordBox Name="passwordTextBox" Header="Password" IsPasswordRevealButtonEnabled="True"
                     PasswordChanged="PasswordTextBox_PasswordChanged"/>
        <CheckBox Name="saveUserNameCheckBox" Content="Save user name"/>
        <InfoBar x:Name="errorInfoBar" Severity="Error" IsOpen="False" IsClosable="False"/>

        <!-- Content body -->
        <TextBlock Name="body" Style="{StaticResource BodyTextBlockStyle}" TextWrapping="Wrap">
            <TextBlock.Text>
                Lorem ipsum dolor sit amet, consectetur adipisicing elit,
                    sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
            </TextBlock.Text>
        </TextBlock>
    </StackPanel>
</ContentDialog>

using Microsoft.UI.Xaml;
using Microsoft.UI.Xaml.Controls;
using System.Threading.Tasks;

namespace ContentDialog_WinUI3
{
    public enum SignInResult
    {
        SignInOK,
        SignInFail,
        SignInCancel,
        Nothing
    }

    public sealed partial class SignInContentDialog : ContentDialog
    {
        public SignInResult Result { get; private set; }

        public SignInContentDialog()
        {
            this.InitializeComponent();
            this.Opened += SignInContentDialog_Opened;
            this.Closing += SignInContentDialog_Closing;
        }

        private async void ContentDialog_PrimaryButtonClick(ContentDialog sender, ContentDialogButtonClickEventArgs args)
        {
            // Ensure the user name and password fields aren't empty. If a required
            // field is empty, set args.Cancel = true to keep the dialog open.
              if (string.IsNullOrEmpty(userNameTextBox.Text))
            {
                errorInfoBar.Message = "User name is required.";
                errorInfoBar.IsOpen = true;
            }
            else if (string.IsNullOrEmpty(passwordTextBox.Password))
            {
                errorInfoBar.Message = "Password is required.";
                errorInfoBar.IsOpen = true;
            }
            args.Cancel = errorInfoBar.IsOpen;

            // If you're performing async operations in the button click handler,
            // get a deferral before you await the operation. Then, complete the
            // deferral when the async operation is complete.
            if (args.Cancel == false) 
            {
                ContentDialogButtonClickDeferral deferral = args.GetDeferral();
                if (await SimulateAsyncSignInOperation())
                {
                    this.Result = SignInResult.SignInOK;
                }
                else
                {
                    this.Result = SignInResult.SignInFail;
                }
                deferral.Complete();
            }
        }

        private async Task<bool> SimulateAsyncSignInOperation()
        {
            // return true to simulate sign-in success.
            return true;
            // return false to simulate sign-in failure.
            /// return false;
        }

        private void ContentDialog_CloseButtonClick(ContentDialog sender, ContentDialogButtonClickEventArgs args)
        {
            // User clicked Cancel, ESC, or the system back button.
            this.Result = SignInResult.SignInCancel;
        }

        void SignInContentDialog_Opened(ContentDialog sender, ContentDialogOpenedEventArgs args)
        {
            this.Result = SignInResult.Nothing;

            // If the user name is saved, get it and populate the user name field.
            Windows.Storage.ApplicationDataContainer localSettings = Windows.Storage.ApplicationData.Current.LocalSettings;
            if (localSettings.Values.ContainsKey("userName"))
            {
                userNameTextBox.Text = localSettings.Values["userName"].ToString();
                saveUserNameCheckBox.IsChecked = true;
            }
        }

        void SignInContentDialog_Closing(ContentDialog sender, ContentDialogClosingEventArgs args)
        {
            // If sign in was successful, save or clear the user name based on the user choice.
            if (this.Result == SignInResult.SignInOK)
            {
                if (saveUserNameCheckBox.IsChecked == true)
                {
                    SaveUserName();
                }
                else
                {
                    ClearUserName();
                }
            }
        }

        private void SaveUserName()
        {
            Windows.Storage.ApplicationDataContainer localSettings = Windows.Storage.ApplicationData.Current.LocalSettings;
            localSettings.Values["userName"] = userNameTextBox.Text;
        }

        private void ClearUserName()
        {
            Windows.Storage.ApplicationDataContainer localSettings = Windows.Storage.ApplicationData.Current.LocalSettings;
            localSettings.Values["userName"] = null;
            userNameTextBox.Text = string.Empty;
        }

        private void UserNameTextBox_TextChanged(object sender, TextChangedEventArgs e)
        {
            // Clear the error if the user name field isn't empty.
            if (!string.IsNullOrEmpty(userNameTextBox.Text))
            {
                errorInfoBar.Message = string.Empty;
                errorInfoBar.IsOpen = false;
            }
        }

        private void PasswordTextBox_PasswordChanged(object sender, RoutedEventArgs e)
        {
            // Clear the error if the password field isn't empty.
            if (!string.IsNullOrEmpty(passwordTextBox.Password))
            {
                errorInfoBar.Message = string.Empty;
                errorInfoBar.IsOpen = false;
            }
        }
    }
}

Aqui está o código que mostra o SignInContentDialog e usa seu personalizado SignInResult.

private async void ShowSignInDialogButton_Click(object sender, RoutedEventArgs e)
{
    SignInContentDialog signInDialog = new SignInContentDialog()
    {
        XamlRoot = rootPanel.XamlRoot
    };
    await signInDialog.ShowAsync();

    if (signInDialog.Result == SignInResult.SignInOK)
    {
        // Sign in was successful.
    }
    else if (signInDialog.Result == SignInResult.SignInFail)
    {
        // Sign in failed.
    }
    else if (signInDialog.Result == SignInResult.SignInCancel)
    {
        // Sign in was cancelled by the user. 
    }
}

Comentários

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte Controles de caixa de diálogo.

Use um ContentDialog para solicitar a entrada do usuário ou para mostrar informações em uma caixa de diálogo modal. Você pode adicionar um ContentDialog a uma página de aplicativo usando código ou XAML ou criar uma classe de caixa de diálogo personalizada derivada de ContentDialog. As duas maneiras são mostradas na seção de exemplos deste tópico.

Título

Use a propriedade Title para colocar um título na caixa de diálogo. Para adicionar um elemento de título complexo com texto mais do que simples, você pode usar a propriedade TitleTemplate .

Botões de comando

O ContentDialog tem três botões internos que descrevem as ações que o usuário pode tomar em resposta ao prompt da caixa de diálogo. Todas as caixas de diálogo devem ter uma ação segura e não destrutiva. As caixas de diálogo também podem, opcionalmente, conter uma ou duas ações específicas de "fazê-lo" em resposta ao prompt.

Use as propriedades PrimaryButtonText e SecondaryButtonText para exibir respostas ao main pergunta ou ação colocada pela caixa de diálogo.

Use a propriedade CloseButtonText para definir o texto de exibição para o botão seguro e não destrutivo. O botão fechar da caixa de diálogo também é invocado quando o usuário executa uma ação Cancelar , como pressionar a tecla ESC ou pressionar o botão voltar do sistema.

Como opção, você pode optar por diferenciar um dos três botões como botão padrão da caixa de diálogo. Use a propriedade DefaultButton para diferenciar um dos botões. Esse botão receberá o tratamento visual do Botão de Ênfase, responderá à tecla ENTER automaticamente e receberá o foco quando a caixa de diálogo for aberta, a menos que o conteúdo da caixa de diálogo contenha elementos focalizáveis.

Mostrar a caixa de diálogo e usá-la como resultado

Para mostrar a caixa de diálogo, chame o método ShowAsync . Use o ContentDialogResult retornado por esse método para determinar quais dos botões foram clicados, se houver. Se o usuário pressionar ESC, a seta para trás do sistema ou o Gamepad B, o resultado desse método será None.

Definir o XamlRoot

Ao mostrar um ContentDialog, você precisa definir manualmente o XamlRoot da caixa de diálogo para a raiz do host XAML. Para fazer isso, defina a propriedade XamlRoot do ContentDialog como o mesmo XamlRoot que um elemento já na árvore XAML.

Se ContentDialog for mostrado de uma Página, você poderá definir a propriedade XamlRoot do ContentDialog como o XamlRoot da Página ( XamlRoot = this.XamlRoot).

Window não tem uma propriedade XamlRoot, portanto, se a caixa de diálogo for mostrada de uma Janela, defina a propriedade XamlRoot da caixa de diálogo como a do elemento de conteúdo raiz do Window, conforme mostrado aqui.

<Window
    ... >
    <Grid x:Name="rootPanel">

    </Grid>
</Window>

private async void DisplayNoWifiDialog()
{
    ContentDialog noWifiDialog = new ContentDialog
    {
        XamlRoot = rootPanel.XamlRoot,
        Title = "No wifi connection",
        Content = "Check your connection and try again.",
        CloseButtonText = "Ok"
    };

    ContentDialogResult result = await noWifiDialog.ShowAsync();
}

Fechar a caixa de diálogo

Talvez você queira fazer algum trabalho antes do fechamento da caixa de diálogo (por exemplo, para verificar se o usuário inseriu dados em campos de formulário antes de enviar uma solicitação). Você tem duas maneiras de trabalhar antes do fechamento da caixa de diálogo. Você pode manipular os eventos PrimaryButtonClick, SecondaryButtonClick ou CloseButtonClick para obter a resposta do usuário quando o usuário pressionar um botão e verificar o estado da caixa de diálogo antes de fechar. Você também pode manipular o evento Closing para trabalhar antes que a caixa de diálogo seja fechada.

Somente um ContentDialog pode ser mostrado por vez. Para encadear mais de um ContentDialog, manipule o evento Closing do primeiro ContentDialog. No manipulador de eventos Closing , chame ShowAsync na segunda caixa de diálogo para mostrá-lo.

Aviso

Só pode haver uma ContentDialog aberta por thread de cada vez. A tentativa de abrir dois ContentDialogs gerará uma exceção, mesmo que eles estejam tentando abrir em janelas de aplicativo separadas.

Controles derivados com estilos WinUI

Se você derivar um controle personalizado de um controle XAML existente, ele não obterá os estilos de WinUI por padrão. Para aplicar os estilos de WinUI:

Crie um novo Style com seu TargetType definido como seu controle personalizado.
Baseie o Estilo no estilo padrão do controle do qual você derivava.

Um cenário comum para isso é derivar um novo controle de ContentDialog. Este exemplo mostra como criar um novo Estilo que se aplica DefaultContentDialogStyle à caixa de diálogo personalizada.

<ContentDialog
    x:Class="ExampleApp.SignInContentDialog"
    ... >
    <ContentDialog.Resources>
        <Style TargetType="local:SignInContentDialog" 
               BasedOn="{StaticResource DefaultContentDialogStyle}"/>
    </ContentDialog.Resources> 
    <!-- CONTENT -->
</ContentDialog>

Estilo e modelo de controle

Você pode modificar o Estilo e ControlTemplate padrão para dar ao controle uma aparência exclusiva. Para obter informações sobre como modificar o estilo e o modelo de um controle, consulte Estilos XAML. O estilo, o modelo e os recursos padrão que definem a aparência do controle são incluídos no generic.xaml arquivo. Para fins de design, generic.xaml é instalado com o pacote NuGet SDK do Aplicativo Windows. Por padrão, esse local é \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml. Estilos e recursos de diferentes versões do SDK podem ter valores diferentes.

O XAML também inclui recursos que você pode usar para modificar as cores de um controle em diferentes estados visuais sem modificar o modelo de controle. É preferível modificar esses recursos para definir propriedades como Plano de Fundo e Primeiro Plano. Para obter mais informações, consulte a seção Estilo leve do artigo Estilos XAML .

Construtores

ContentDialog()

Inicializa uma nova instância da classe ContentDialog .

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. (Herdado de FrameworkElement)
ActualOffset	Obtém a posição desse UIElement, em relação ao pai, computado durante a passagem de organização do processo de layout. (Herdado de UIElement)
ActualSize	Obtém o tamanho que esse UIElement 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 é usado atualmente pelo elemento , que pode ser diferente de RequestedTheme. (Herdado de FrameworkElement)
ActualWidth	Obtém a largura renderizada de um FrameworkElement. Consulte Observações. (Herdado de FrameworkElement)
AllowDrop	Obtém ou define um valor que determina se esse UIElement pode ser um destino de soltar para fins de operações de arrastar e soltar. (Herdado de UIElement)
AllowFocusOnInteraction	Obtém ou define um valor que indica se o elemento obtém automaticamente o foco quando o usuário interage com ele. (Herdado de FrameworkElement)
AllowFocusWhenDisabled	Obtém ou define se um controle desabilitado pode receber foco. (Herdado de FrameworkElement)
Background	Obtém ou define um pincel que fornece a tela de fundo do controle. (Herdado de Control)
BackgroundSizing	Obtém ou define um valor que indica até que ponto a tela de fundo se estende em relação à borda desse elemento. (Herdado de Control)
BaseUri	Obtém um URI (Uniform Resource Identifier) que representa o URI base de um objeto construído em XAML no tempo de carregamento XAML. Essa propriedade é útil para resolução de URI em tempo de execução. (Herdado de FrameworkElement)
BorderBrush	Obtém ou define um pincel que descreve o preenchimento de borda de um controle. (Herdado de Control)
BorderThickness	Obtém ou define a espessura da borda de um controle. (Herdado de Control)
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)
CharacterSpacing	Obtém ou define o espaçamento uniforme entre caracteres, em unidades de 1/1000 de um em. (Herdado de Control)
Clip	Obtém ou define o RectangleGeometry usado para definir a estrutura de tópicos do conteúdo de um UIElement. (Herdado de UIElement)
CloseButtonCommand	Obtém ou define o comando a ser invocado quando o botão Fechar é tocado.
CloseButtonCommandParameter	Obtém ou define o parâmetro a ser passado para o comando do botão fechar.
CloseButtonCommandParameterProperty	Obtém o identificador da propriedade de dependência CloseButtonCommandParameter.
CloseButtonCommandProperty	Obtém o identificador da propriedade de dependência CloseButtonCommand.
CloseButtonStyle	Obtém ou define o estilo a ser aplicado ao botão fechar da caixa de diálogo.
CloseButtonStyleProperty	Obtém o identificador da propriedade de dependência CloseButtonStyle.
CloseButtonText	Obtém ou define o texto a ser exibido no botão Fechar.
CloseButtonTextProperty	Obtém o identificador da propriedade de dependência CloseButtonText.
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. (Herdado de UIElement)
Content	Obtém ou define o conteúdo de um ContentControl. (Herdado de ContentControl)
ContentTemplate	Obtém ou define o modelo de dados usado para exibir o conteúdo do ContentControl. (Herdado de ContentControl)
ContentTemplateRoot	Obtém o elemento raiz do modelo de dados especificado pela propriedade ContentTemplate . (Herdado de ContentControl)
ContentTemplateSelector	Obtém ou define um objeto de seleção que altera o DataTemplate para aplicar ao conteúdo, com base no processamento de informações sobre o item de conteúdo ou seu contêiner em tempo de execução. (Herdado de ContentControl)
ContentTransitions	Obtém ou define a coleção de elementos de estilo de transição que se aplicam ao conteúdo de um ContentControl. (Herdado de ContentControl)
ContextFlyout	Obtém ou define o submenu associado a esse elemento. (Herdado de UIElement)
CornerRadius	Obtém ou define o raio para os cantos da borda do controle. (Herdado de Control)
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. (Herdado de FrameworkElement)
DefaultButton	Obtém ou define um valor que indica qual botão na caixa de diálogo é a ação padrão.
DefaultButtonProperty	Obtém o identificador da propriedade de dependência DefaultButton.
DefaultStyleKey	Obtém ou define a chave que faz referência ao estilo padrão do controle. Os autores de controles personalizados usam essa propriedade para alterar o padrão para o estilo que seu controle usa. (Herdado de Control)
DefaultStyleResourceUri	Obtém ou define o caminho para o arquivo de recurso que contém o estilo padrão para o controle. (Herdado de Control)
DesiredSize	Obtém o tamanho que esse UIElement calculou durante a passagem de medida do processo de layout. (Herdado de UIElement)
Dispatcher	Sempre retorna `null` em um aplicativo SDK do Aplicativo Windows. Em vez disso, use DispatcherQueue . (Herdado de DependencyObject)
DispatcherQueue	Obtém o ao `DispatcherQueue` qual este objeto está associado. O `DispatcherQueue` representa uma instalação que pode acessar o `DependencyObject` no thread da interface do usuário, mesmo que o código seja iniciado por um thread que não seja da interface do usuário. (Herdado de DependencyObject)
ElementSoundMode	Obtém ou define um valor que especifica a preferência de um controle para se os sons são reproduzidos. (Herdado de Control)
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 a fluir da direita para a esquerda. (Herdado de FrameworkElement)
FocusState	Obtém um valor que especifica se esse controle tem foco e o modo pelo qual o foco foi obtido. (Herdado de UIElement)
FocusVisualMargin	Obtém ou define a margem externa do visual de foco para um FrameworkElement. (Herdado de FrameworkElement)
FocusVisualPrimaryBrush	Obtém ou define o pincel usado para desenhar a borda externa de um `HighVisibility` visual de foco ou `Reveal` para um FrameworkElement. (Herdado de FrameworkElement)
FocusVisualPrimaryThickness	Obtém ou define a espessura da borda externa de um `HighVisibility` visual de foco ou `Reveal` para um FrameworkElement. (Herdado de FrameworkElement)
FocusVisualSecondaryBrush	Obtém ou define o pincel usado para desenhar a borda interna de um `HighVisibility` visual de foco ou `Reveal` para um FrameworkElement. (Herdado de FrameworkElement)
FocusVisualSecondaryThickness	Obtém ou define a espessura da borda interna de um `HighVisibility` visual de foco ou `Reveal` para um FrameworkElement. (Herdado de FrameworkElement)
FontFamily	Obtém ou define a fonte usada para exibir o texto no controle. (Herdado de Control)
FontSize	Obtém ou define o tamanho do texto nesse controle. (Herdado de Control)
FontStretch	Obtém ou define o grau de quão condensada ou expandida a fonte está na tela. (Herdado de Control)
FontStyle	Obtém ou define o estilo no qual o texto é renderizado. (Herdado de Control)
FontWeight	Obtém ou define a espessura da fonte especificada. (Herdado de Control)
Foreground	Obtém ou define um pincel que descreve a cor de primeiro plano. (Herdado de Control)
FullSizeDesired	Obtém ou define um valor que indica se uma solicitação está sendo feita para exibir o tamanho total da caixa de diálogo.
FullSizeDesiredProperty	Obtém o identificador da propriedade de dependência FullSizeDesired.
Height	Obtém ou define a altura sugerida de um FrameworkElement. (Herdado de FrameworkElement)
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. (Herdado de UIElement)
HorizontalAlignment	Obtém ou define as características de alinhamento horizontal que são aplicadas a um FrameworkElement quando ele é composto em um pai de layout, como um painel ou controle de itens. (Herdado de FrameworkElement)
HorizontalContentAlignment	Obtém ou define o alinhamento horizontal do conteúdo do controle. (Herdado de Control)
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)
IsEnabled	Obtém ou define um valor que indica se o usuário pode interagir com o controle. (Herdado de Control)
IsFocusEngaged	Obtém ou define um valor que indica se o foco é restrito ao controle quando o usuário pressiona o botão A/Select em um controlador de jogo. (Herdado de Control)
IsFocusEngagementEnabled	Obtém ou define um valor que indica se o foco pode ser restrito ao controle quando o usuário pressiona o botão A/Selecionar em um controlador de jogo. (Herdado de Control)
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. (Herdado de FrameworkElement)
IsPrimaryButtonEnabled	Obtém ou define se o botão primário da caixa de diálogo está habilitado.
IsPrimaryButtonEnabledProperty	Obtém o identificador da propriedade de dependência IsPrimaryButtonEnabled .
IsRightTapEnabled	Obtém ou define um valor que determina se o evento RightTapped pode ser originado desse elemento. (Herdado de UIElement)
IsSecondaryButtonEnabled	Obtém ou define se o botão secundário da caixa de diálogo está habilitado.
IsSecondaryButtonEnabledProperty	Obtém o identificador da propriedade de dependência IsSecondaryButtonEnabled .
IsTabStop	Obtém ou define um valor que indica se o controle está incluído na navegação pela tecla tab. (Herdado de UIElement)
IsTapEnabled	Obtém ou define um valor que determina se o evento Tapped pode se originar desse elemento. (Herdado de UIElement)
IsTextScaleFactorEnabled	Obtém ou define se a ampliação automática de texto, para refletir a configuração de tamanho do texto do sistema, está habilitada. (Herdado de Control)
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. Exemplo de um menu mostrando aceleradores de teclado para vários itens de menu (Herdado de UIElement)
KeyTipHorizontalOffset	Obtém ou define um valor que indica o quão à esquerda ou à direita a Dica de Chave é colocada em relação ao UIElement. (Herdado de UIElement)
KeyTipPlacementMode	Obtém ou define um valor que indica onde a dica de 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 idioma de localização/globalização que se aplicam a um FrameworkElement e também a todos os elementos filho do FrameworkElement atual na representação do objeto e na interface do usuário. (Herdado de FrameworkElement)
Lights	Obtém a coleção de objetos XamlLight anexados a esse elemento. (Herdado de UIElement)
ManipulationMode	Obtém ou define o valor ManipulationModes usado para comportamento 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. (Herdado de FrameworkElement)
MaxHeight	Obtém ou define a restrição de altura máxima de um FrameworkElement. (Herdado de FrameworkElement)
MaxWidth	Obtém ou define a restrição de largura máxima de um FrameworkElement. (Herdado de FrameworkElement)
MinHeight	Obtém ou define a restrição de altura mínima de um FrameworkElement. (Herdado de FrameworkElement)
MinWidth	Obtém ou define a restrição de largura mínima de um FrameworkElement. (Herdado de FrameworkElement)
Name	Obtém ou define o nome de identificação do objeto. Quando um processador XAML cria a árvore de objetos com base na marcação XAML, o código em tempo de execução pode se referir ao objeto declarado por XAML por esse nome. (Herdado de FrameworkElement)
Opacity	Obtém ou define o grau de opacidade do objeto. (Herdado de UIElement)
OpacityTransition	Obtém ou define o ScalarTransition que anima as alterações na propriedade Opacity. (Herdado de UIElement)
Padding	Obtém ou define o preenchimento em um controle. (Herdado de Control)
Parent	Obtém o objeto pai desse FrameworkElement na árvore de objetos. (Herdado de FrameworkElement)
PointerCaptures	Obtém o conjunto de todos os ponteiros capturados, representados como valores pointer . (Herdado de UIElement)
PrimaryButtonCommand	Obtém ou define o comando a ser invocado quando o botão primário é tocado.
PrimaryButtonCommandParameter	Obtém ou define o parâmetro a ser passado para o comando do botão primário.
PrimaryButtonCommandParameterProperty	Obtém o identificador da propriedade de dependência PrimaryButtonCommandParameter.
PrimaryButtonCommandProperty	Obtém o identificador da propriedade de dependência PrimaryButtonCommand.
PrimaryButtonStyle	Obtém ou define o estilo a ser aplicado ao botão principal da caixa de diálogo.
PrimaryButtonStyleProperty	Obtém o identificador da propriedade de dependência PrimaryButtonStyle.
PrimaryButtonText	Obtém ou define o texto a ser exibido no botão primário.
PrimaryButtonTextProperty	Obtém o identificador da propriedade de dependência PrimaryButtonText.
Projection	Obtém ou define a projeção de perspectiva (efeito 3D) a ser aplicada ao renderizar esse elemento. (Herdado de UIElement)
ProtectedCursor	Obtém ou define o cursor que é exibido quando o ponteiro está sobre esse elemento. O padrão é nulo, indicando nenhuma alteração no cursor. (Herdado de UIElement)
RasterizationScale	Obtém um valor que representa o número de pixels brutos (físicos) para cada pixel de exibição. (Herdado de UIElement)
RenderSize	Obtém o tamanho final de renderização de 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 usado pelo UIElement (e seus elementos filho) para determinação de recursos. O tema da interface do usuário que você especificar com `RequestedTheme` pode substituir o RequestedTheme no nível do aplicativo. (Herdado de FrameworkElement)
RequiresPointer	Obtém ou define se um elemento de interface do usuário dá suporte ao modo de mouse, que emula experiências de interação de ponteiro com dispositivos de entrada sem ponteiro, como um teclado ou controlador de jogo. (Herdado de Control)
Resources	Obtém o dicionário de recursos definido localmente. Em XAML, você pode estabelecer itens de recurso como elementos de objeto filho de um `frameworkElement.Resources` elemento de propriedade, por meio da sintaxe de coleção implícita XAML. (Herdado de FrameworkElement)
Rotation	Obtém ou define o ângulo da rotação no sentido horário, em graus. Gira em relação ao RotationAxis e ao CenterPoint. Afeta a posição de renderização do elemento . (Herdado de UIElement)
RotationAxis	Obtém ou define o eixo para girar o elemento ao redor. (Herdado de UIElement)
RotationTransition	Obtém ou define o ScalarTransition que anima as alterações na propriedade Rotation. (Herdado de UIElement)
Scale	Obtém ou define a escala do elemento . Dimensiona em relação ao CenterPoint do elemento. Afeta a posição de renderização do elemento . (Herdado de UIElement)
ScaleTransition	Obtém ou define o Vector3Transition que anima as alterações na propriedade Scale. (Herdado de UIElement)
SecondaryButtonCommand	Obtém ou define o comando a ser invocado quando o botão secundário é tocado.
SecondaryButtonCommandParameter	Obtém ou define o parâmetro a ser passado para o comando do botão secundário.
SecondaryButtonCommandParameterProperty	Obtém o identificador da propriedade de dependência SecondaryButtonCommandParameter.
SecondaryButtonCommandProperty	Obtém o identificador da propriedade de dependência SecondaryButtonCommand.
SecondaryButtonStyle	Obtém ou define o estilo a ser aplicado ao botão secundário da caixa de diálogo.
SecondaryButtonStyleProperty	Obtém o identificador da propriedade de dependência SecondaryButtonStyle.
SecondaryButtonText	Obtém ou define o texto a ser exibido no botão secundário.
SecondaryButtonTextProperty	Obtém o identificador da propriedade de dependência SecondaryButtonText.
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. (Herdado de FrameworkElement)
TabFocusNavigation	Obtém ou define um valor que modifica como o tabbing e o TabIndex funcionam para esse controle. (Herdado de UIElement)
TabIndex	Obtém ou define um valor que determina a ordem na qual os elementos recebem foco quando o usuário navega pelos controles usando a tecla Tab . (Herdado de UIElement)
TabNavigation	Obtém ou define um valor que modifica como o tabbing e UIElement.TabIndex funcionam para esse controle. Observação Para Atualização do Windows 10 para Criadores (build 10.0.15063) e mais recente, a propriedade TabFocusNavigation está disponível na classe base UIElement para incluir objetos na sequência de tabulação que não usam um ControlTemplate. (Herdado de Control)
Tag	Obtém ou define um valor de objeto arbitrário que pode ser usado para armazenar informações personalizadas sobre esse objeto. (Herdado de FrameworkElement)
Template	Obtém ou define um modelo de controle. O modelo de controle define a aparência visual de um controle na interface do usuário e é definido na marcação XAML. (Herdado de Control)
Title	Obtém ou define o título da caixa de diálogo.
TitleProperty	Obtém o identificador da propriedade de dependência Title.
TitleTemplate	Obtém ou define o modelo de título.
TitleTemplateProperty	Obtém o identificador da propriedade de dependência TitleTemplate.
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. (Herdado de FrameworkElement)
UseLayoutRounding	Obtém ou define um valor que determina se a renderização para o objeto e sua subárvore visual deve usar o comportamento de arredondamento que alinha a renderização a pixels inteiros. (Herdado de UIElement)
UseSystemFocusVisuals	Obtém ou define um valor que indica se o controle usa visuais de foco desenhados pelo sistema ou visuais de foco definidos no modelo de controle. (Herdado de UIElement)
VerticalAlignment	Obtém ou define as características de alinhamento vertical que são aplicadas a um FrameworkElement quando ele é composto em um objeto pai, como um painel ou controle de itens. (Herdado de FrameworkElement)
VerticalContentAlignment	Obtém ou define o alinhamento vertical do conteúdo do controle. (Herdado de Control)
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. (Herdado de FrameworkElement)
XamlRoot	Obtém ou define o `XamlRoot` no qual esse elemento está sendo exibido. (Herdado de UIElement)
XYFocusDown	Obtém ou define o objeto que obtém o foco quando um usuário pressiona para baixo no Teclado Direcional (D-pad) de um controlador de jogo. (Herdado de UIElement)
XYFocusDownNavigationStrategy	Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação para baixo. (Herdado de UIElement)
XYFocusKeyboardNavigation	Obtém ou define um valor que habilita ou desabilita a navegação usando as setas direcionais do teclado. (Herdado de UIElement)
XYFocusLeft	Obtém ou define o objeto que obtém o foco quando um usuário pressiona à esquerda no Teclado Direcional (D-pad) de um controlador de jogo. (Herdado de UIElement)
XYFocusLeftNavigationStrategy	Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação à esquerda. (Herdado de UIElement)
XYFocusRight	Obtém ou define o objeto que obtém o foco quando um usuário pressiona diretamente no Teclado Direcional (D-pad) de um controlador de jogo. (Herdado de UIElement)
XYFocusRightNavigationStrategy	Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação à direita. (Herdado de UIElement)
XYFocusUp	Obtém ou define o objeto que obtém o foco quando um usuário pressiona no Teclado Direcional (D-pad) de um controlador de jogo. (Herdado de UIElement)
XYFocusUpNavigationStrategy	Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação para cima. (Herdado de UIElement)

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)
ApplyTemplate()	Carrega o modelo de controle relevante para que suas partes possam ser referenciadas. (Herdado de Control)
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. (Herdado de UIElement)
ArrangeOverride(Size)	Fornece o comportamento para a passagem "Organizar" do layout. As classes podem substituir esse método para definir seu próprio comportamento de passagem "Arrange". (Herdado de FrameworkElement)
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)
FindName(String)	Recupera um objeto que tem o nome do identificador especificado. (Herdado de FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)	Permite que uma subclasse UIElement exponha elementos filho que ajudam a resolver o direcionamento de toque. (Herdado de UIElement)
Focus(FocusState)	Tenta definir o foco para esse elemento. (Herdado de UIElement)
GetAnimationBaseValue(DependencyProperty)	Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria 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. (Herdado de FrameworkElement)
GetChildrenInTabFocusOrder()	Permite que uma subclasse UIElement exponha elementos filho que participam do foco de Tab. (Herdado de UIElement)
GetTemplateChild(String)	Recupera o elemento nomeado na árvore visual ControlTemplate instanciada. (Herdado de Control)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject)
GetVisualInternal()	Recupera o para o `Visual` qual o elemento resolve. (Herdado de UIElement)
GoToElementStateCore(String, Boolean)	Quando implementado em uma classe derivada, permite a construção por estado de uma árvore visual para um modelo de controle no código, em vez de carregar XAML para todos os estados na inicialização do controle. (Herdado de FrameworkElement)
Hide()	Oculta a caixa de diálogo.
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. (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 que é usado para calcular o visor efetivo. (Herdado de FrameworkElement)
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 "Measure" do ciclo de layout. As classes podem substituir esse método para definir seu próprio comportamento de passagem de "Medida". (Herdado de FrameworkElement)
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. (Herdado de FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)	Chamado antes que o evento BringIntoViewRequested ocorra. (Herdado de UIElement)
OnCharacterReceived(CharacterReceivedRoutedEventArgs)	Chamado antes que o evento CharacterReceived ocorra. (Herdado de Control)
OnContentChanged(Object, Object)	Invocado quando o valor da propriedade Content é alterado. (Herdado de ContentControl)
OnContentTemplateChanged(DataTemplate, DataTemplate)	Invocado quando o valor da propriedade ContentTemplate é alterado. (Herdado de ContentControl)
OnContentTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)	Invocado quando o valor da propriedade ContentTemplateSelector é alterado. (Herdado de ContentControl)
OnCreateAutomationPeer()	Quando implementado em uma classe derivada, retorna implementações AutomationPeer específicas da classe para a infraestrutura do Microsoft Automação da Interface do Usuário. (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)
OnDoubleTapped(DoubleTappedRoutedEventArgs)	Chamado antes que o evento DoubleTapped ocorra. (Herdado de Control)
OnDragEnter(DragEventArgs)	Chamado antes que o evento DragEnter ocorra. (Herdado de Control)
OnDragLeave(DragEventArgs)	Chamado antes que o evento DragLeave ocorra. (Herdado de Control)
OnDragOver(DragEventArgs)	Chamado antes que o evento DragOver ocorra. (Herdado de Control)
OnDrop(DragEventArgs)	Chamado antes que o evento Drop ocorra. (Herdado de Control)
OnGotFocus(RoutedEventArgs)	Chamado antes que o evento GotFocus ocorra. (Herdado de Control)
OnHolding(HoldingRoutedEventArgs)	Chamado antes que o evento Holding ocorra. (Herdado de Control)
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)
OnKeyDown(KeyRoutedEventArgs)	Chamado antes que o evento KeyDown ocorra. (Herdado de Control)
OnKeyUp(KeyRoutedEventArgs)	Chamado antes que o evento KeyUp ocorra. (Herdado de Control)
OnLostFocus(RoutedEventArgs)	Chamado antes que o evento LostFocus ocorra. (Herdado de Control)
OnManipulationCompleted(ManipulationCompletedRoutedEventArgs)	Chamado antes que o evento ManipulationCompleted ocorra. (Herdado de Control)
OnManipulationDelta(ManipulationDeltaRoutedEventArgs)	Chamado antes que o evento ManipulationDelta ocorra. (Herdado de Control)
OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs)	Chamado antes que o evento ManipulationInertiaStarting ocorra. (Herdado de Control)
OnManipulationStarted(ManipulationStartedRoutedEventArgs)	Chamado antes que o evento ManipulationStarted ocorra. (Herdado de Control)
OnManipulationStarting(ManipulationStartingRoutedEventArgs)	Chamado antes que o evento ManipulationStarting ocorra. (Herdado de Control)
OnPointerCanceled(PointerRoutedEventArgs)	Chamado antes que o evento PointerCanceled ocorra. (Herdado de Control)
OnPointerCaptureLost(PointerRoutedEventArgs)	Chamado antes que o evento PointerCaptureLost ocorra. (Herdado de Control)
OnPointerEntered(PointerRoutedEventArgs)	Chamado antes que o evento PointerEntered ocorra. (Herdado de Control)
OnPointerExited(PointerRoutedEventArgs)	Chamado antes que o evento PointerExited ocorra. (Herdado de Control)
OnPointerMoved(PointerRoutedEventArgs)	Chamado antes que o evento PointerMoved ocorra. (Herdado de Control)
OnPointerPressed(PointerRoutedEventArgs)	Chamado antes que o evento PointerPressed ocorra. (Herdado de Control)
OnPointerReleased(PointerRoutedEventArgs)	Chamado antes que o evento PointerReleased ocorra. (Herdado de Control)
OnPointerWheelChanged(PointerRoutedEventArgs)	Chamado antes que o evento PointerWheelChanged ocorra. (Herdado de Control)
OnPreviewKeyDown(KeyRoutedEventArgs)	Chamado antes que o evento PreviewKeyDown ocorra. (Herdado de Control)
OnPreviewKeyUp(KeyRoutedEventArgs)	Chamado antes que o evento PreviewKeyUp ocorra. (Herdado de Control)
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)
OnRightTapped(RightTappedRoutedEventArgs)	Chamado antes que o evento RightTapped ocorra. (Herdado de Control)
OnTapped(TappedRoutedEventArgs)	Chamado antes que o evento Tapped ocorra. (Herdado de Control)
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 nessa instância dependencyObject . (Herdado de DependencyObject)
ReleasePointerCapture(Pointer)	Libera capturas de ponteiro para captura de um ponteiro específico por este UIElement. (Herdado de UIElement)
ReleasePointerCaptures()	Libera todas as capturas de ponteiro mantidas por esse elemento. (Herdado de UIElement)
RemoveFocusEngagement()	Libera o controle de restrições de foco que dão suporte a interações do controlador de jogo (em que IsFocusEngaged é true). (Herdado de Control)
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. (Herdado de FrameworkElement)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência em um DependencyObject. (Herdado de DependencyObject)
ShowAsync()	Inicia uma operação assíncrona para mostrar a caixa de diálogo.
ShowAsync(ContentDialogPlacement)	Inicia uma operação assíncrona para mostrar a caixa de diálogo com o posicionamento especificado.
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(ExpPointerPoint)	Representa uma caixa de diálogo que pode ser personalizada para conter caixas de seleção, hiperlinks, botões e qualquer outro conteúdo XAML. (Herdado de UIElement)
StartDragAsync(PointerPoint)	Inicia uma operação do tipo "arrastar e soltar". Importante Não há suporte se um usuário executar o aplicativo no modo elevado, como administrador. (Herdado de UIElement)
StopAnimation(ICompositionAnimationBase)	Interrompe a animação especificada no elemento . (Herdado de UIElement)
TransformToVisual(UIElement)	Retorna um objeto de transformação que pode ser usado para transformar coordenadas do UIElement para o objeto especificado. (Herdado de UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	Tenta invocar um atalho de teclado (ou acelerador) pesquisando toda a árvore visual do UIElement para obter o atalho. (Herdado de UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback. (Herdado de DependencyObject)
UpdateLayout()	Garante que todas as posições de objetos filho de um UIElement sejam atualizadas corretamente para layout. (Herdado de UIElement)

Eventos

AccessKeyDisplayDismissed	Ocorre quando as chaves de acesso não devem mais ser exibidas. (Herdado de UIElement)
AccessKeyDisplayRequested	Ocorre quando o usuário solicita que as chaves de acesso sejam exibidas. (Herdado de UIElement)
AccessKeyInvoked	Ocorre quando um usuário conclui uma sequência de chaves de acesso. (Herdado de UIElement)
ActualThemeChanged	Ocorre quando o valor da propriedade ActualTheme foi alterado. (Herdado de FrameworkElement)
BringIntoViewRequested	Ocorre quando StartBringIntoView é chamado nesse elemento ou em um de seus descendentes. (Herdado de UIElement)
CharacterReceived	Ocorre quando um único caractere composto é recebido pela fila de entrada. (Herdado de UIElement)
CloseButtonClick	Ocorre depois que o botão Fechar é tocado.
Closed	Ocorre depois que a caixa de diálogo é fechada.
Closing	Ocorre depois que a caixa de diálogo começa a ser fechada, mas antes de ser fechada e antes que o evento Closed ocorra.
ContextCanceled	Ocorre quando um gesto de entrada de contexto continua em um gesto de manipulação, para notificar o elemento de que o submenu de contexto não deve ser aberto. (Herdado de UIElement)
ContextRequested	Ocorre quando o usuário concluiu um gesto de entrada de contexto, como um clique com o botão direito do mouse. (Herdado de UIElement)
DataContextChanged	Ocorre quando o valor da propriedade FrameworkElement.DataContext é alterado. (Herdado de FrameworkElement)
DoubleTapped	Ocorre quando uma interação DoubleTap sem tratamento ocorre na área de teste de clique 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 como a origem é encerrada. (Herdado de UIElement)
EffectiveViewportChanged	Ocorre quando o visor efetivo do FrameworkElement é alterado. (Herdado de FrameworkElement)
FocusDisengaged	Ocorre quando o foco é liberado do controle quando o usuário pressiona o botão B/Voltar em um controlador de jogo. (Herdado de Control)
FocusEngaged	Ocorre quando o foco é restrito ao controle quando o usuário pressiona o botão A/Selecionar em um controlador de jogo. (Herdado de Control)
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 clique desse elemento. (Herdado de UIElement)
IsEnabledChanged	Ocorre quando a propriedade IsEnabled é alterada. (Herdado de Control)
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. (Herdado de FrameworkElement)
Loaded	Ocorre quando um FrameworkElement foi construído e adicionado à árvore de objetos e está pronto para interação. (Herdado de FrameworkElement)
Loading	Ocorre quando um FrameworkElement começa a ser carregado. (Herdado de FrameworkElement)
LosingFocus	Ocorre antes que um UIElement perca o foco. Esse evento é gerado de forma síncrona para garantir que o foco não seja movido enquanto o evento estiver borbulhando. (Herdado de UIElement)
LostFocus	Ocorre quando um UIElement perde o foco. Esse evento é gerado de forma assíncrona, para que o foco possa se mover novamente antes que o borbulhamento seja concluído. (Herdado de UIElement)
ManipulationCompleted	Ocorre quando uma manipulação no UIElement é concluída. (Herdado de UIElement)
ManipulationDelta	Ocorre quando o dispositivo de entrada 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)
Opened	Ocorre depois que a caixa de diálogo é aberta.
PointerCanceled	Ocorre quando um ponteiro que fez contato perde contato anormalmente. (Herdado de UIElement)
PointerCaptureLost	Ocorre quando a captura de ponteiro anteriormente mantida por esse elemento se move para outro elemento ou em outro lugar. (Herdado de UIElement)
PointerEntered	Ocorre quando um ponteiro entra na área de teste de ocorrência desse elemento. (Herdado de UIElement)
PointerExited	Ocorre quando um ponteiro deixa a área de teste de ocorrência desse elemento. (Herdado de UIElement)
PointerMoved	Ocorre quando um ponteiro se move enquanto o ponteiro permanece dentro da área de teste de ocorrência desse elemento. (Herdado de UIElement)
PointerPressed	Ocorre quando o dispositivo de ponteiro inicia uma ação Pressionar dentro desse elemento. (Herdado de UIElement)
PointerReleased	Ocorre quando o dispositivo de ponteiro que iniciou anteriormente uma ação press é liberado, enquanto dentro desse elemento. Observe que o fim de uma ação press não é garantido para disparar um `PointerReleased` evento; outros eventos podem ser acionados em vez disso. Para obter mais informações, consulte Comentários. (Herdado de UIElement)
PointerWheelChanged	Ocorre quando o valor delta de uma roda de ponteiro é alterado. (Herdado de UIElement)
PreviewKeyDown	Ocorre quando uma tecla de teclado é pressionada enquanto o UIElement tem foco. (Herdado de UIElement)
PreviewKeyUp	Ocorre quando uma tecla de teclado é lançada enquanto o UIElement tem foco. (Herdado de UIElement)
PrimaryButtonClick	Ocorre depois que o botão primário é tocado.
ProcessKeyboardAccelerators	Ocorre quando um atalho de teclado (ou acelerador) é pressionado. (Herdado de UIElement)
RightTapped	Ocorre quando um estímulo de entrada de toque à direita acontece enquanto o ponteiro está sobre o elemento . (Herdado de UIElement)
SecondaryButtonClick	Ocorre depois que o botão secundário é tocado.
SizeChanged	Ocorre quando a propriedade ActualHeight ou ActualWidth altera o valor em um FrameworkElement. (Herdado de FrameworkElement)
Tapped	Ocorre quando ocorre uma interação de toque sem tratamento na área de teste de ocorrência desse elemento. (Herdado de UIElement)
Unloaded	Ocorre quando esse objeto não está mais conectado à árvore de objetos main. (Herdado de FrameworkElement)

Aplica-se a

Compartilhar via

ContentDialog Classe

Definição

Exemplos

Comentários

Título

Botões de comando

Mostrar a caixa de diálogo e usá-la como resultado

Definir o XamlRoot

Fechar a caixa de diálogo

Controles derivados com estilos WinUI

Estilo e modelo de controle

Construtores

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

Comentários

Recursos adicionais