TextBox 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.
Representa um controle que pode ser usado para exibir e editar texto sem formatação (uma ou várias linhas).
/// [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 TextBox : Control[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 TextBox : ControlPublic Class TextBox
Inherits Control<TextBox .../>
- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Exemplos
Dica
Para obter mais informações, diretrizes de design e exemplos de código, consulte Caixa de texto.
Os aplicativos da Galeria do WinUI 2 incluem exemplos interativos da maioria dos controles, recursos e funcionalidades do WinUI 2. Obtenha o aplicativo na Microsoft Store ou o código-fonte no GitHub.
Este exemplo mostra um TextBox com um cabeçalho e um texto de espaço reservado. O Texto da Caixa de Texto é usado para mostrar uma saudação ao usuário.
<StackPanel>
<TextBlock Text="What's your name?"/>
<StackPanel Orientation="Horizontal" Margin="0,20,0,20">
<TextBox x:Name="nameInput"
Header="Enter your name:" PlaceholderText="Name"
Width="300" HorizontalAlignment="Left"/>
<Button Content="Hello button" Click="Button_Click"/>
</StackPanel>
<TextBlock x:Name="greetingOutput"/>
</StackPanel>
private void Button_Click(object sender, RoutedEventArgs e)
{
greetingOutput.Text = "Hello, " + nameInput.Text + "!";
}
Comentários
Dica
Para obter mais informações, diretrizes de design e exemplos de código, consulte Caixa de texto.
O controle TextBox permite que um usuário insira texto em um aplicativo. Em geral, ele é usado para capturar uma única linha de texto, mas pode ser configurado para capturar várias linhas de texto. O texto é exibido na tela em um formato simples de texto sem formatação uniforme.
O TextBox tem vários recursos que podem simplificar a entrada de texto:
- Ele dá suporte à entrada de texto de um teclado ou caneta (usando reconhecimento de tinta e manuscrito).
- Ele é fornecido com um menu de contexto familiar, integrado, com suporte para copiar e colar texto.
- Um botão "limpar tudo" permite que um usuário exclua rapidamente todo o texto inserido.
- Ele também tem recursos de verificação ortográfica integrados e habilitados por padrão.
Veja como criar uma TextBox em XAML e em código.
<TextBox Width="500" Header="Notes" PlaceholderText="Type your notes here"/>
TextBox textBox = new TextBox();
textBox.Width = 500;
textBox.Header = "Notes";
textBox.PlaceholderText = "Type your notes here";
// Add the TextBox to the visual tree.
rootGrid.Children.Add(textBox);
O TextBox resultante tem esta aparência. A borda azul indica que o TextBox tem foco.
TextBox é o controle certo a ser usado?
Você pode usar um controle TextBox para exibir e editar texto não formatado. Se você precisar de uma caixa de texto editável que aceite senhas ou outra entrada confidencial, confira PasswordBox. Se você precisar de uma caixa de texto para inserir termos de pesquisa, confira AutoSuggestBox. Se você precisar inserir ou editar texto formatado, confira RichEditBox.
Usar TextBox para entrada de dados em um formulário
É comum usar um TextBox para aceitar a entrada de dados em um formulário e usar a propriedade Text para obter a cadeia de caracteres de texto completa da TextBox. Normalmente, você usa um evento como um botão enviar Clique para acessar a propriedade Text , mas pode manipular o evento TextChanged ou TextChanging se precisar fazer algo quando o texto for alterado. Você pode adicionar um Cabeçalho (ou rótulo) e PlaceholderText (ou marca d'água) à TextBox para dar ao usuário uma indicação de para que serve a TextBox. Para personalizar a aparência do cabeçalho, você pode definir a propriedade HeaderTemplate em vez de Header. Para obter informações de design, consulte Diretrizes para rótulos.
Você pode restringir o número de caracteres que o usuário pode digitar definindo a propriedade MaxLength. No entanto, MaxLength não restringe o comprimento do texto colado. Use o evento Paste para modificar o texto colado se isso for importante para o seu aplicativo.
TextBox inclui um botão limpar tudo ("x") que aparece quando o texto é inserido na caixa. Quando um usuário clica em "x", o texto na Caixa de Texto é limpo. Ela terá a aparência a seguir.
O botão limpar tudo é mostrado apenas para caixas de texto editáveis de linha única que contêm texto e têm foco. O botão limpar tudo não é mostrado em nenhum destes casos:
- IsReadOnly é true
- AcceptsReturn é true
- TextWrapping é Wrap
Tornar uma Caixa de Texto somente leitura
Você pode tornar um TextBox somente leitura definindo a propriedade IsReadOnly como true. Por exemplo, você pode ter um TextBox para o usuário inserir comentários que seja habilitada apenas em determinadas condições. É possível tornar o TextBox somente leitura até que as condições sejam atendidas. Se você precisar apenas exibir texto, considere usar um TextBlock ou RichTextBlock .
Habilitar a entrada de várias linhas
Há duas propriedades que controlam se o TextBox exibe texto em mais de uma linha.
- Para que a caixa de texto permita e exiba os caracteres newline ou return, defina a propriedade AcceptsReturn como true.
- Para habilitar o encapsulamento de texto, defina a propriedade TextWrapping como Wrap. (TextBox não dá suporte ao valor de enumeração TextWrapping.WrapWholeWords .) Um TextBox de várias linhas continuará a crescer verticalmente conforme o texto for inserido, a menos que seja restrito por sua propriedade Height ou MaxHeight ou por um contêiner pai. Você deve testar se um TextBox de várias linhas não cresce além de sua área visível e restringir seu crescimento se isso acontecer. A rolagem usando uma roda de rolagem ou toque é habilitada automaticamente quando necessário. No entanto, as barras de rolagem verticais não são mostradas por padrão. Você pode mostrar as barras de rolagem verticais definindo ScrollViewer.VerticalScrollBarVisibility como Auto no ScrollViewer inserido, conforme mostrado aqui.
<TextBox AcceptsReturn="True" TextWrapping="Wrap"
MaxHeight="172" Width="300" Header="Description"
ScrollViewer.VerticalScrollBarVisibility="Auto"/>
TextBox textBox = new TextBox();
textBox.AcceptsReturn = true;
textBox.TextWrapping = TextWrapping.Wrap;
textBox.MaxHeight = 172;
textBox.Width = 300;
textBox.Header = "Description";
ScrollViewer.SetVerticalScrollBarVisibility(textBox, ScrollBarVisibility.Auto);
Veja a aparência da Caixa de Texto após a adição do texto.
Formatar a exibição de texto
Use a propriedade TextAlignment para alinhar o texto em um TextBox. Para alinhar o TextBox no layout da página, use as propriedades HorizontalAlignment e VerticalAlignment .
Embora o TextBox dê suporte apenas a texto não formatado, você pode personalizar como o texto é exibido na TextBox para corresponder à sua identidade visual. Você pode definir propriedades Control padrão, como FontFamily, FontSize, FontStyle, Background, Foreground e CharacterSpacing, para alterar a aparência do texto. Essas propriedades afetam apenas como o TextBox exibe o texto localmente, portanto, se você copiar e colar o texto em um controle rich text, por exemplo, nenhuma formatação seria aplicada.
Este exemplo mostra um TextBox somente leitura com várias propriedades definidas para personalizar a aparência do texto.
<TextBox Text="Sample Text" IsReadOnly="True"
FontFamily="Verdana" FontSize="24"
FontWeight="Bold" FontStyle="Italic"
CharacterSpacing="200" Width="300"
Foreground="Blue" Background="Beige"/>
TextBox textBox = new TextBox();
textBox.Text = "Sample Text";
textBox.IsReadOnly = true;
textBox.FontFamily = new FontFamily("Verdana");
textBox.FontSize = 24;
textBox.FontWeight = Windows.UI.Text.FontWeights.Bold;
textBox.FontStyle = Windows.UI.Text.FontStyle.Italic;
textBox.CharacterSpacing = 200;
textBox.Width = 300;
textBox.Background = new SolidColorBrush(Windows.UI.Colors.Beige);
textBox.Foreground = new SolidColorBrush(Windows.UI.Colors.Blue);
// Add the TextBox to the visual tree.
rootGrid.Children.Add(textBox);
O TextBox resultante tem esta aparência.
Entrada à caneta
A partir do Windows 10, versão 1803, caixas de entrada de texto XAML têm suporte inserido para entrada à caneta usando Windows Ink. Quando um usuário toca em uma caixa de entrada de texto usando uma caneta do Windows, a caixa de texto se transforma para permitir que o usuário escreva diretamente nela com uma caneta, em vez de abrir um painel de entrada separado.
Para saber mais, confira Entrada de texto com exibição de texto manuscrito.
Modificar o menu de contexto
Por padrão, os comandos mostrados no menu de contexto TextBox dependem do estado do TextBox. Por exemplo, os comandos a seguir podem ser mostrados quando o TextBox é editável.
| Comando | Mostrado quando... |
|---|---|
| Copiar | texto selecionado. |
| Recortar | texto selecionado. |
| Colar | a área de transferência contém texto. |
| Selecionar tudo | a TextBox contém texto. |
| Desfazer | texto foi alterado. |
Para modificar os comandos mostrados no menu de contexto, manipule o evento ContextMenuOpening. Para obter um exemplo disso, consulte Personalizando o CommandBarFlyout do RichEditBox – adicionando o exemplo "Compartilhar" na Galeria do WinUI 2. Para obter informações de design, consulte Diretrizes para menus de contexto.
Seleção, cópia e colagem
Você pode obter ou definir o texto selecionado em um TextBox usando a propriedade SelectedText . Use as propriedades SelectionStart e SelectionLength e os métodos Select e SelectAll para manipular a seleção de texto. Manipule o evento SelectionChanged para fazer algo quando o usuário selecionar ou desmarcar texto. Você pode alterar a cor usada para realçar o texto selecionado, definindo a propriedade SelectionHighlightColor.
A TextBox dá suporte às ações de copiar e colar por padrão. Você pode fornecer tratamento personalizado do evento Paste em controles de texto editáveis em seu aplicativo. Por exemplo, é possível remover as quebras de linha de um endereço de vários linhas ao colá-lo em uma caixa de pesquisa de linha única. Você também poderá verificar o comprimento do texto colado e avisar o usuário se ele exceder o tamanho máximo que pode ser salvo em um banco de dados. Para obter mais informações e exemplos, consulte o evento Paste.
Usar uma caixa de texto com o teclado virtual
O teclado virtual pode ser usado para entrada de texto, quando o aplicativo é executado em um dispositivo com tela sensível ao toque. O TextBox fornece propriedades que você pode definir para torná-lo muito mais rápido e fácil para os usuários inserirem dados em seu aplicativo usando o teclado virtual. Defina a propriedade InputScope para corresponder ao tipo de dados que o usuário deve inserir. Por exemplo, se um TextBox for usado apenas para inserir um PIN de 4 dígitos, defina a propriedade InputScope como Number. Isso informa o sistema para mostrar o layout do teclado numérico, facilitando a inserção do PIN.
Outras propriedades que afetam o teclado virtual são IsSpellCheckEnabled, IsTextPredictionEnabled e PreventKeyboardDisplayOnProgrammaticFocus. (IsSpellCheckEnabled também afeta o TextBox quando um teclado de hardware é usado.) Para obter mais informações e exemplos, consulte Usar o escopo de entrada para alterar o teclado virtual e a documentação da propriedade.
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 Controles de estilo. 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 está disponível localmente com a instalação do pacote SDK ou NuGet.
- Estilos winui (recomendado): Para ver os estilos atualizados do WinUI, consulte
\Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. - Estilos não WinUI: Para estilos internos, consulte
%ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml.
Os locais podem ser diferentes se você personalizou a instalação. 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 . Recursos de estilo leve estão disponíveis a partir de Windows 10, versão 1607 (SDK 14393).
Os recursos que começam com TextControl são compartilhados por TextBox, PasswordBox, RichEditBox e AutoSuggestBox. As alterações nesses recursos afetarão todos os quatro controles.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1511 | 10586 | GetLinguisticAlternativesAsync |
| 1703 | 15063 | SelectionHighlightColorWhenNotFocused |
| 1.709 | 16299 | BeforeTextChanging |
| 1.709 | 16299 | Charactercasing |
| 1.709 | 16299 | CopyingToClipboard |
| 1.709 | 16299 | CuttingToClipboard |
| 1.709 | 16299 | HorizontalTextAlignment |
| 1.709 | 16299 | PlaceholderForeground |
| 1803 | 17134 | HandwritingView |
| 1803 | 17134 | IsHandwritingViewEnabled |
| 1809 | 17763 | CanPasteClipboardContent |
| 1809 | 17763 | Canredo |
| 1809 | 17763 | Canundo |
| 1809 | 17763 | ClearUndoRedoHistory |
| 1809 | 17763 | CopySelectionToClipboard |
| 1809 | 17763 | CutSelectionToClipboard |
| 1809 | 17763 | Descrição |
| 1809 | 17763 | PasteFromClipboard |
| 1809 | 17763 | ProofingMenuFlyout |
| 1809 | 17763 | Refazer |
| 1809 | 17763 | Selectionchanging |
| 1809 | 17763 | SelectionFlyout |
| 1809 | 17763 | Desfazer |
Construtores
| TextBox() |
Inicializa uma nova instância da classe TextBox . |
Propriedades
| AcceptsReturn |
Obtém ou define o valor que determina se a caixa de texto permite e exibe a nova linha ou os caracteres de retorno. |
| AcceptsReturnProperty |
Identifica a propriedade de dependência AcceptsReturn . |
| 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, computada durante a passagem de organização do processo de layout. (Herdado de UIElement) |
| ActualSize |
Obtém o tamanho que esse UIElement calculou durante a passagem de organização do processo de layout. (Herdado de UIElement) |
| ActualTheme |
Obtém o tema da interface do usuário que é 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 (Uniform Resource Identifier) base para um objeto construído em XAML no tempo de carregamento XAML. Essa propriedade é útil para resolução de URI (Uniform Resource Identifier) 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) |
| CanPasteClipboardContent |
Obtém um valor que indica se o conteúdo da área de transferência pode ser colado no controle . |
| CanPasteClipboardContentProperty |
Identifica a propriedade de dependência CanPasteClipboardContent. |
| CanRedo |
Obtém um valor que indica se o buffer de restauração contém uma ação que pode ser refeito. |
| CanRedoProperty |
Identifica a propriedade de dependência CanRedo. |
| CanUndo |
Obtém um valor que indica se o buffer de desfazer contém uma ação que pode ser desfeita. |
| CanUndoProperty |
Identifica a propriedade de dependência CanUndo. |
| 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) |
| CharacterCasing |
Obtém ou define um valor que indica como o controle modifica as maiúsculas e minúsculas dos caracteres conforme eles são digitadas. |
| CharacterCasingProperty |
Identifica a propriedade de dependência CharacterCasing. |
| 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) |
| CompositeMode |
Obtém ou define uma propriedade que declara modos alternativos de composição e mesclagem para o elemento em seu layout pai e janela. Isso é relevante para elementos envolvidos em uma interface do usuário XAML/Microsoft DirectX mista. (Herdado de UIElement) |
| ContextFlyout |
Obtém ou define o submenu associado a esse elemento. (Herdado de UIElement) |
| 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) |
| 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) |
| Description |
Obtém ou define o conteúdo mostrado abaixo do controle . O conteúdo deve fornecer diretrizes sobre a entrada esperada pelo controle. |
| DescriptionProperty |
Identifica a propriedade de dependência Description. |
| DesiredCandidateWindowAlignment |
Obtém ou define um valor que indica o alinhamento preferencial do IME (Editor de Método de Entrada). |
| DesiredCandidateWindowAlignmentProperty |
Identifica a propriedade de dependência DesiredCandidateWindowAlignment . |
| DesiredSize |
Obtém o tamanho que esse UIElement calculou durante a passagem de medida do processo de layout. (Herdado de UIElement) |
| Dispatcher |
Obtém o CoreDispatcher ao qual esse objeto está associado. O CoreDispatcher representa uma instalação que pode acessar 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 para 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 Control) |
| 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 |
| FocusVisualPrimaryThickness |
Obtém ou define a espessura da borda externa de um |
| FocusVisualSecondaryBrush |
Obtém ou define o pincel usado para desenhar a borda interna de um |
| FocusVisualSecondaryThickness |
Obtém ou define a espessura da borda interna de um |
| 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) |
| HandwritingView |
Obtém ou define o HandwritingView associado a esse controle de texto. |
| HandwritingViewProperty |
Identifica a propriedade de dependência HandwritingView. |
| Header |
Obtém ou define o conteúdo do cabeçalho do controle. |
| HeaderProperty |
Identifica a propriedade Dependência de cabeçalho . |
| HeaderTemplate |
Obtém ou define o DataTemplate usado para exibir o conteúdo do cabeçalho do controle. |
| HeaderTemplateProperty |
Identifica a propriedade de dependência HeaderTemplate . |
| 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 os temas de alto contraste estão habilitados. (Herdado de UIElement) |
| HorizontalAlignment |
Obtém ou define as características de alinhamento horizontal que são aplicadas a um FrameworkElement quando ele é composto em um pai de layout, como um painel ou controle de itens. (Herdado de FrameworkElement) |
| HorizontalContentAlignment |
Obtém ou define o alinhamento horizontal do conteúdo do controle. (Herdado de Control) |
| HorizontalTextAlignment |
Obtém ou define um valor que indica como o texto é alinhado na TextBox. |
| HorizontalTextAlignmentProperty |
Identifica a propriedade de dependência HorizontalTextAlignment. |
| InputScope |
Obtém ou define o contexto de entrada usado por esta TextBox. |
| InputScopeProperty |
Identifica a propriedade de dependência InputScope. |
| IsAccessKeyScope |
Obtém ou define um valor que indica se um elemento define seu próprio escopo de chave de acesso. (Herdado de UIElement) |
| IsColorFontEnabled |
Obtém ou define um valor que determina se os glifos de fonte que contêm camadas de cores, como Emoji de Interface do Usuário do Segoe, são renderizados em cores. |
| IsColorFontEnabledProperty |
Identifica a propriedade de dependência IsColorFontEnabled . |
| 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 está restrito dentro dos limites de controle (para interação remota/painel de jogos). (Herdado de Control) |
| IsFocusEngagementEnabled |
Obtém ou define um valor que indica se o foco pode ser restrito dentro dos limites de controle (para interação remota/painel de jogos). (Herdado de Control) |
| IsHandwritingViewEnabled |
Obtém ou define um valor que indica se um usuário pode inserir texto no modo de exibição de manuscrito. |
| IsHandwritingViewEnabledProperty |
Identifica a propriedade de dependência IsHandwritingViewEnabled. |
| 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 se originar 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) |
| IsReadOnly |
Obtém ou define o valor que determina se o usuário pode alterar o texto na caixa de texto. |
| IsReadOnlyProperty |
Identifica a propriedade de dependência IsReadOnly . |
| IsRightTapEnabled |
Obtém ou define um valor que determina se o evento RightTapped pode se originar desse elemento. (Herdado de UIElement) |
| IsSpellCheckEnabled |
Obtém ou define um valor que especifica se a entrada TextBox interage com um mecanismo de marcar ortográfico. |
| IsSpellCheckEnabledProperty |
Identifica a propriedade de dependência IsSpellCheckEnabled . |
| IsTabStop |
Obtém ou define um valor que indica se o controle está incluído na navegação pela tecla tab. (Herdado de Control) |
| IsTapEnabled |
Obtém ou define um valor que determina se o evento Tapped pode se originar desse elemento. (Herdado de UIElement) |
| IsTextPredictionEnabled |
Obtém ou define um valor que determina se os recursos de previsão de texto ("preenchimento automático") devem ser habilitados para este TextBox. |
| IsTextPredictionEnabledProperty |
Identifica a propriedade de dependência IsTextPredictionEnabled . |
| 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 de acelerador. (Herdado de UIElement) |
| KeyboardAccelerators |
Obtém a coleção de combinações de teclas que invocam uma ação usando o teclado. Os aceleradores normalmente são atribuídos a botões ou itens de menu.
|
| KeyTipHorizontalOffset |
Obtém ou define um valor que indica o quão distante à 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 chave 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 chave de acesso. (Herdado de UIElement) |
| KeyTipVerticalOffset |
Obtém ou define um valor que indica até que ponto a Dica de Chave é colocada em relação ao elemento de interface do usuário. (Herdado de UIElement) |
| Language |
Obtém ou define informações de linguagem de localização/globalização que se aplicam a um FrameworkElement e também a todos os elementos filho do FrameworkElement atual na representação do objeto e na interface do usuário. (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 o comportamento de UIElement e a interação com gestos. Definir esse valor permite lidar com 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) |
| MaxLength |
Obtém ou define o valor que especifica o número máximo de caracteres permitidos para entrada do usuário. |
| MaxLengthProperty |
Identifica a propriedade de dependência MaxLength . |
| 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 da marcação XAML, o código em tempo de execução pode se referir ao objeto declarado 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 deste FrameworkElement na árvore de objetos. (Herdado de FrameworkElement) |
| PlaceholderForeground |
Obtém ou define um pincel que descreve a cor do texto do espaço reservado. |
| PlaceholderForegroundProperty |
Identifica a propriedade de dependência PlaceholderForeground. |
| PlaceholderText |
Obtém ou define o texto exibido no controle até que o valor seja alterado por uma ação do usuário ou alguma outra operação. |
| PlaceholderTextProperty |
Identifica a propriedade de dependência PlaceholderText . |
| PointerCaptures |
Obtém o conjunto de todos os ponteiros capturados, representados como valores de ponteiro . (Herdado de UIElement) |
| PreventKeyboardDisplayOnProgrammaticFocus |
Obtém ou define um valor que indica se o teclado virtual é mostrado quando o controle recebe o foco programaticamente. |
| PreventKeyboardDisplayOnProgrammaticFocusProperty |
Identifica a propriedade de dependência PreventKeyboardDisplayOnProgrammaticFocus . |
| Projection |
Obtém ou define a projeção de perspectiva (efeito 3D) a ser aplicada ao renderizar esse elemento. (Herdado de UIElement) |
| ProofingMenuFlyout |
Obtém o submenu que mostra os comandos de revisão de texto. |
| ProofingMenuFlyoutProperty |
Identifica a propriedade de dependência ProofingMenuFlyout . |
| 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 que é usado pelo UIElement (e seus elementos filho) para determinação de recursos. O tema da interface do usuário especificado com RequestedTheme pode substituir RequestedTheme no nível do aplicativo. (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 painel de jogo ou controle remoto. (Herdado de Control) |
| Resources |
Obtém o dicionário de recursos definido localmente. No XAML, você pode estabelecer itens de recurso como elementos de objeto filho de um |
| Rotation |
Obtém ou define o ângulo da rotação no sentido horário, em graus. Gira em relação ao RotationAxis e ao CenterPoint. Afeta a posição de renderização do elemento . (Herdado de UIElement) |
| RotationAxis |
Obtém ou define o eixo para girar o elemento ao redor. (Herdado de UIElement) |
| RotationTransition |
Obtém ou define o ScalarTransition que anima as alterações na propriedade Rotation. (Herdado de UIElement) |
| Scale |
Obtém ou define a escala do elemento . Dimensiona em relação ao CenterPoint do elemento. Afeta a posição de renderização do elemento . (Herdado de UIElement) |
| ScaleTransition |
Obtém ou define o Vector3Transition que anima as alterações na propriedade Scale. (Herdado de UIElement) |
| SelectedText |
Obtém ou define o conteúdo da seleção atual na caixa de texto. |
| SelectionFlyout |
Obtém ou define o submenu mostrado quando o texto é selecionado com entrada por toque ou caneta. |
| SelectionFlyoutProperty |
Identifica a propriedade de dependência SelectionFlyout. |
| SelectionHighlightColor |
Obtém ou define o pincel usado para realçar o texto selecionado. |
| SelectionHighlightColorProperty |
Identifica a propriedade de dependência SelectionHighlightColor . |
| SelectionHighlightColorWhenNotFocused |
Obtém ou define o pincel usado para realçar o texto selecionado quando o TextBox não tem foco. |
| SelectionHighlightColorWhenNotFocusedProperty |
Identifica a propriedade de dependência SelectionHighlightColorWhenNotFocused . |
| SelectionLength |
Obtém ou define o número de caracteres na seleção atual na caixa de texto. |
| SelectionStart |
Obtém ou define a posição inicial do texto selecionado na caixa de texto. Quando SelectionLength é 0 (não há texto selecionado), a propriedade SelectionStart corresponde à posição do cursor. |
| 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 indica a ordem na qual os elementos recebem foco quando o usuário navega pela interface do usuário do aplicativo usando a tecla Tab. (Herdado de Control) |
| TabNavigation |
Obtém ou define um valor que modifica como o tabbing e 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. |
| 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) |
| Text |
Obtém ou define o conteúdo da caixa de texto. |
| TextAlignment |
Obtém ou define como o texto deve ser alinhado horizontalmente na caixa de texto. |
| TextAlignmentProperty |
Identifica a propriedade de dependência TextAlignment . |
| TextProperty |
Identifica a propriedade Dependência de texto . |
| TextReadingOrder |
Obtém ou define um valor que indica como a ordem de leitura é determinada para a TextBox. |
| TextReadingOrderProperty |
Identifica a propriedade de dependência TextReadingOrder . |
| TextWrapping |
Obtém ou define como a quebra de linha ocorre se uma linha de texto se estende além da largura disponível da caixa de texto. |
| TextWrappingProperty |
Identifica a propriedade de dependência TextWrapping . |
| 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) |
| UIContext |
Obtém o identificador de contexto para o elemento . (Herdado de UIElement) |
| UseLayoutRounding |
Obtém ou define um valor que determina se a renderização para o objeto e sua subárvore visual deve usar o comportamento de arredondamento que alinha a renderização a pixels inteiros. (Herdado de UIElement) |
| UseSystemFocusVisuals |
Obtém ou define um valor que indica se o controle usa visuais de foco desenhados pelo sistema ou aqueles definidos no modelo de controle. (Herdado de Control) |
| 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 |
| XYFocusDown |
Obtém ou define o objeto que obtém o foco quando um usuário pressiona o Teclado Direcional (D-pad) para baixo. (Herdado de Control) |
| 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 o Teclado Direcional (D-pad) à esquerda. (Herdado de Control) |
| 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 o Teclado Direcional (D-pad) à direita. (Herdado de Control) |
| 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 o Teclado Direcional (D-pad) para cima. (Herdado de Control) |
| 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. Os objetos pai que implementam o layout personalizado para seus elementos filho devem chamar esse método de suas implementações de substituição de layout para formar uma atualização de layout recursivo. (Herdado de UIElement) |
| ArrangeOverride(Size) |
Fornece o comportamento para a passagem "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) |
| ClearUndoRedoHistory() |
Esvazia os buffers desfazer e refazer. |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject) |
| CopySelectionToClipboard() |
Copia o conteúdo selecionado para a área de transferência do Windows. |
| CutSelectionToClipboard() |
Move o conteúdo selecionado para a área de transferência do Windows e o remove do controle de texto. |
| 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 no controle. (Herdado de Control) |
| 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) |
| GetLinguisticAlternativesAsync() |
Obtém de forma assíncrona uma lista de palavras candidatas com base nos caracteres fonéticos fornecidos em um IME (Editor de Método de Entrada). |
| GetRectFromCharacterIndex(Int32, Boolean) |
Retorna uma região retangular para a borda à esquerda ou à direita de um caractere em um índice de caracteres específico. |
| 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) |
| GoToElementStateCore(String, Boolean) |
Quando implementado em uma classe derivada, permite a construção por estado de uma árvore visual para um modelo de controle no código, em vez de carregar XAML para todos os estados na inicialização de controle. (Herdado de FrameworkElement) |
| InvalidateArrange() |
Invalida o estado de organização (layout) de um UIElement. Após a invalidação, o UIElement terá seu layout atualizado, o que ocorrerá de forma assíncrona. (Herdado de UIElement) |
| InvalidateMeasure() |
Invalida o estado de medida (layout) de um UIElement. (Herdado de UIElement) |
| InvalidateViewport() |
Invalida o estado do visor para um UIElement usado para calcular o visor efetivo. (Herdado de FrameworkElement) |
| Measure(Size) |
Atualizações DesiredSize de um UIElement. Normalmente, os objetos que implementam o layout personalizado para seus filhos de layout chamam esse método de suas próprias implementações MeasureOverride para formar uma atualização de layout recursiva. (Herdado de UIElement) |
| MeasureOverride(Size) |
Fornece o comportamento para a passagem "Medida" do ciclo de layout. As classes podem substituir esse método para definir seu próprio comportamento de passagem "Medida". (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 do evento BringIntoViewRequested ocorrer. (Herdado de UIElement) |
| OnCharacterReceived(CharacterReceivedRoutedEventArgs) |
Chamado antes que o evento CharacterReceived ocorra. (Herdado de Control) |
| OnCreateAutomationPeer() |
Quando implementado em uma classe derivada, retorna implementações de 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 um conteúdo específico da classe ou da propriedade children. (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 resposta do aplicativo 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 a manipulação 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) |
| PasteFromClipboard() |
Copia o conteúdo da área de transferência do Windows para o controle de texto. |
| 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) |
| Redo() |
Reaplica a primeira ação no buffer de restauração. |
| 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 foco dos limites de controle para um controle que tem envolvimento de foco (para interação remota/painel de jogos). (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) |
| Select(Int32, Int32) |
Seleciona um intervalo de texto na caixa de texto. |
| SelectAll() |
Seleciona todo o conteúdo da caixa de texto. |
| 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) |
| StartAnimation(ICompositionAnimationBase) |
Inicia a animação especificada no elemento . (Herdado de UIElement) |
| StartBringIntoView() |
Inicia uma solicitação para a estrutura XAML para colocar o elemento em exibição em todas as regiões roláveis em que ele está contido. (Herdado de UIElement) |
| StartBringIntoView(BringIntoViewOptions) |
Inicia uma solicitação para a estrutura XAML para colocar o elemento em exibição usando as opções especificadas. (Herdado de UIElement) |
| StartDragAsync(PointerPoint) |
Inicia uma operação do tipo "arrastar e soltar". (Herdado de UIElement) |
| StopAnimation(ICompositionAnimationBase) |
Interrompe a animação especificada no elemento . (Herdado de UIElement) |
| TransformToVisual(UIElement) |
Retorna um objeto de transformação que pode ser usado para transformar coordenadas do UIElement para o objeto especificado. (Herdado de UIElement) |
| TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
Tenta invocar um atalho de teclado (ou acelerador) pesquisando toda a árvore visual do UIElement para obter o atalho. (Herdado de UIElement) |
| Undo() |
Desfaz a primeira ação no buffer de desfazer. |
| 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) |
| BeforeTextChanging |
Ocorre de forma síncrona quando o texto na caixa de texto começa a ser alterado, mas antes que a propriedade Text seja atualizada. |
| BringIntoViewRequested |
Ocorre quando StartBringIntoView é chamado nesse elemento ou um de seus descendentes. (Herdado de UIElement) |
| CandidateWindowBoundsChanged |
Ocorre quando a janela IME (Editor de Método de Entrada) abre, atualiza ou fecha. |
| CharacterReceived |
Ocorre quando um único caractere composto é recebido pela fila de entrada. (Herdado de UIElement) |
| ContextCanceled |
Ocorre quando um gesto de entrada de contexto continua em um gesto de manipulação, para notificar o elemento de que o submenu de contexto não deve ser aberto. (Herdado de UIElement) |
| ContextMenuOpening |
Ocorre quando o sistema processa uma interação que exibe um menu de contexto. |
| ContextRequested |
Ocorre quando o usuário conclui um gesto de entrada de contexto, como um clique com o botão direito do mouse. (Herdado de UIElement) |
| CopyingToClipboard |
Ocorre antes que o texto copiado seja movido para a área de transferência. |
| CuttingToClipboard |
Ocorre antes que o texto recortado seja movido para a área de transferência. |
| DataContextChanged |
Ocorre quando o valor da propriedade FrameworkElement.DataContext é alterado. (Herdado de FrameworkElement) |
| DoubleTapped |
Ocorre quando ocorre uma interação DoubleTap sem tratamento na área de teste de ocorrência desse elemento. (Herdado de UIElement) |
| DragEnter |
Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com esse elemento como o destino. (Herdado de UIElement) |
| DragLeave |
Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com esse elemento como a origem. (Herdado de UIElement) |
| DragOver |
Ocorre quando o sistema de entrada relata um evento do tipo "arrastar" subjacente com esse elemento como a reprodução automática potencial. (Herdado de UIElement) |
| DragStarting |
Ocorre quando uma operação de arrastar é iniciada. (Herdado de UIElement) |
| Drop |
Ocorre quando o sistema de entrada relata um evento soltar subjacente com esse elemento sendo uma reprodução automática. (Herdado de UIElement) |
| DropCompleted |
Ocorre quando uma operação de arrastar e soltar com esse elemento quando a origem é encerrada. (Herdado de UIElement) |
| EffectiveViewportChanged |
Ocorre quando o visor efetivo do FrameworkElement é alterado. (Herdado de FrameworkElement) |
| FocusDisengaged |
Ocorre quando o foco é liberado dos limites de controle (para interação remota/painel de jogos). (Herdado de Control) |
| FocusEngaged |
Ocorre quando o foco é restrito dentro dos limites de controle (para interação remota/painel de jogos). (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 ocorrência 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 é lançada 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 guias ou direcionais), mas o foco não se move porque nenhum candidato de foco é encontrado na direção do movimento. (Herdado de UIElement) |
| Paste |
Ocorre quando o texto é colado no controle . |
| 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 de Imprensa não é garantido para disparar um evento PointerReleased; outros eventos podem disparar 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) |
| 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) |
| SelectionChanged |
Ocorre quando a seleção de texto é alterada. |
| SelectionChanging |
Ocorre quando a seleção de texto começa a ser alterada. |
| 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) |
| TextChanged |
Ocorre quando o conteúdo é alterado na caixa de texto. |
| TextChanging |
Ocorre de forma síncrona quando o texto na caixa de texto começa a ser alterado, mas antes de ser renderizado. |
| TextCompositionChanged |
Ocorre quando o texto que está sendo composto por meio de um IME (Editor de Método de Entrada) é alterado. |
| TextCompositionEnded |
Ocorre quando um usuário para de redigir texto por meio de um IME (Editor de Método de Entrada). |
| TextCompositionStarted |
Ocorre quando um usuário começa a redigir texto por meio de um IME (Editor de Método de Entrada). |
| Unloaded |
Ocorre quando esse objeto não está mais conectado à árvore de objetos main. (Herdado de FrameworkElement) |
Aplica-se a
Confira também
- PasswordBox
- RichEditBox
- RichTextBlock
- SearchBox
- Visão geral da caixa de texto
- Como usar o escopo de entrada para alterar o teclado virtual
- Amostra de edição de texto XAML
- Diretrizes para verificação ortográfica
- Lista de controles
- Controles por função
- Exemplo de entrada de texto do teclado virtual (Windows 10)
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de