Image 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 exibe uma imagem. A origem da imagem é especificada referindo-se a um arquivo de imagem, usando vários formatos com suporte. A origem da imagem também pode ser definida com um fluxo. Consulte Comentários para obter a lista de formatos de origem de imagem com suporte.
public ref class Image sealed : FrameworkElement/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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 Image final : FrameworkElement/// [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)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Image final : FrameworkElement[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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 sealed class Image : FrameworkElement[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)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Image : FrameworkElementPublic NotInheritable Class Image
Inherits FrameworkElement<Image .../>
- 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 Imagem.
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.
Comentários
Formatos de arquivo de imagem
Uma Imagem pode exibir estes formatos de arquivo de imagem:
- JPEG
- PNG
- BMP
- GIF
- TIFF
- JPEG XR
- ícones (ICO)
- Scalable Vector Graphics (SVG)
Observação
Arquivos de ícone com suporte apenas no Windows. Sem suporte no Windows Phone 8.1
A partir do Windows 10, versão 1607, o elemento Image dá suporte a imagens animadas de GIF (Graphics Interchange Format). Ao usar um BitmapImage como a origem da imagem, você pode acessar a API BitmapImage para controlar a reprodução da imagem animada do GIF (Graphics Interchange Format). Para saber mais, confira os Comentários sobre a página da classe BitmapImage.
Observação
O suporte a GIF (Animated Graphics Interchange Format) está disponível quando seu aplicativo é compilado para Windows 10, versão 1607 e em execução na versão 1607 (ou posterior). Quando seu aplicativo é compilado para ou executado em versões anteriores, o primeiro quadro do GIF (Graphics Interchange Format) é mostrado, mas não é animado.
A partir do Windows 10, versão 1703, o elemento Image dá suporte a imagens estáticas SVG (Elementos Gráficos Vetoriais Escalonáveis) por meio de SvgImageSource. SvgImageSource dá suporte ao modo estático seguro da especificação SVG e não dá suporte a animações ou interações. O Direct2D fornece o suporte de renderização SVG subjacente e, para obter mais informações sobre o elemento SVG específico e o suporte a atributos, consulte Suporte a SVG. Para saber mais sobre como inserir um SVG em seu aplicativo, visite a página da classe SvgImageSource .
Observação
O suporte a SVG (Elementos Gráficos Vetoriais Escalonáveis) está disponível quando seu aplicativo é compilado para Windows 10, versão 1703 e em execução na versão 1703 (ou posterior). Quando o aplicativo for compilado para ou executado em versões anteriores, a imagem SVG não será mostrada.
Definindo Image.Source
Para definir o arquivo de origem da imagem exibido por uma Imagem, defina sua propriedade Source , em XAML ou em código. Aqui está um exemplo simples de configuração de Origem em XAML:
<Image Width="200" Source="Images/myimage.png"/>
Esse uso está definindo a Origem por URI (Uniform Resource Identifier), que é um atalho habilitado pelo XAML. Observe que o URI (Uniform Resource Identifier) aqui parece ser um URI (Uniform Resource Identifier) relativo; o suporte ao URI (Uniform Resource Identifier) parcial é outro atalho XAML. A raiz desse URI (Uniform Resource Identifier) é a pasta base de um projeto de aplicativo. Geralmente, esse é o mesmo local do qual o arquivo XAML que contém a marca Image é carregado. Neste exemplo, o arquivo de origem da imagem está em uma subpasta Images dentro da estrutura de arquivos do aplicativo.
Definir a propriedade Source é inerentemente uma ação assíncrona. Como é uma propriedade, não há uma sintaxe aguardável, mas, para a maioria dos cenários, você não precisa interagir com os aspectos assíncronos do carregamento de imagens. A estrutura aguardará o retorno da origem da imagem e iniciará um ciclo de layout quando o arquivo de origem da imagem estiver disponível e decodificado.
Definir a origem como um valor de URI (Uniform Resource Identifier) que não pode ser resolvido para um arquivo de origem de imagem válido não gera uma exceção. Em vez disso, ele dispara um evento ImageFailed . Você pode escrever um manipulador ImageFailed e anexá-lo ao objeto Image e, possivelmente, usar ErrorMessage nos dados do evento para determinar a natureza da falha. Um erro na decodificação também pode disparar ImageFailed. Se você quiser verificar se um arquivo de origem de imagem foi carregado corretamente, poderá manipular o evento ImageOpened no elemento Image.
Normalmente, você usa arquivos de origem de imagem incluídos como parte do pacote de download do aplicativo. Para arquivos grandes, pode haver um atraso muito pequeno enquanto o arquivo de origem da imagem é decodificado, se esta for a primeira vez que a origem é usada. Para obter mais informações sobre recursos de aplicativo e como empacotar arquivos de origem de imagem em um pacote de aplicativos, consulte Definindo recursos do aplicativo.
Você também pode usar arquivos de origem de imagem que não fazem parte do aplicativo, por exemplo, imagens de servidores externos. Essas imagens são baixadas por uma solicitação HTTP interna e decodificadas. Se o arquivo de origem da imagem for um arquivo grande ou se houver problemas de conexão, poderá haver um atraso antes que uma imagem externa possa ser exibida em um elemento Image.
Configurando Image.Source usando código
Se você criar um objeto Image usando código, chame o construtor padrão e defina a propriedade Image.Source . Definir a propriedade Image.Source requer uma instância da classe BitmapImage , que você também deve construir. Se a origem da imagem for um arquivo referenciado pelo URI (Uniform Resource Identifier), use o construtor BitmapImage que usa um parâmetro URI (Uniform Resource Identifier). Ao fazer referência ao conteúdo local, você deve incluir o esquema ms-appx: no URI (Uniform Resource Identifier) absoluto que você usa como o parâmetro de construtor BitmapImage . No código, você não obtém os atalhos de processamento para combinar partes relativas do URI (Uniform Resource Identifier) e o esquema ms-appx: que acontece automaticamente se você especificar Source como um atributo XAML. Em vez disso, você deve construir explicitamente um URI (Uniform Resource Identifier) absoluto com o esquema apropriado. Normalmente, você usa o esquema ms-appx: para um arquivo de imagem empacotado como parte do seu aplicativo.
Dica
Se você estiver usando C# ou Microsoft Visual Basic, poderá obter a propriedade BaseUri da Imagem e passá-la como o parâmetro baseUri para construtores System.Uri que combinam um local base de URI (Uniform Resource Identifier) e um caminho relativo dentro desse local.
Aqui está um exemplo de como definir Image.Source em C#. Neste exemplo, o objeto Image foi criado em XAML, mas não tem uma origem ou outros valores de propriedade; Em vez disso, esses valores são fornecidos em tempo de execução quando a imagem é carregada de XAML.
void Image_Loaded(object sender, RoutedEventArgs e)
{
Image img = sender as Image;
BitmapImage bitmapImage = new BitmapImage();
img.Width = bitmapImage.DecodePixelWidth = 80; //natural px width of image source
// don't need to set Height, system maintains aspect ratio, and calculates the other
// dimension, so long as one dimension measurement is provided
bitmapImage.UriSource = new Uri(img.BaseUri,"Assets/StoreLogo.png");
img.Source = bitmapImage;
}
Usando uma fonte de fluxo para uma fonte de imagem
Se a origem da imagem for um fluxo, você deverá escrever um código que defina sua instância de Imagem para usar o fluxo. Isso não pode ser feito apenas em XAML. Construa a Imagem a ser usada ou faça referência a uma instância de Imagem existente (que pode ter sido definida na marcação XAML, mas sem uma origem). Em seguida, use o método SetSourceAsync assíncrono de BitmapImage para definir as informações de imagem de um fluxo, passando o fluxo para usar como o parâmetro streamSource . Usar um fluxo para uma fonte de imagem é bastante comum. Por exemplo, se o aplicativo permitir que um usuário escolha um arquivo de imagem usando um controle FileOpenPicker , o objeto obtido que representa o arquivo escolhido pelo usuário poderá ser aberto como um fluxo, mas não fornecerá uma referência de URI (Uniform Resource Identifier) ao arquivo.
Neste exemplo, o código já é aguardado porque está aguardando o usuário escolher um arquivo e só será executado depois que isso acontecer. O fluxo a ser usado vem de StorageFile.OpenAsync depois que uma instância storageFile é retornada das ações do seletor assíncrono.
FileOpenPicker open = new FileOpenPicker();
// Open a stream for the selected file
StorageFile file = await open.PickSingleFileAsync();
// Ensure a file was selected
if (file != null)
{
using (IRandomAccessStream fileStream = await file.OpenAsync(Windows.Storage.FileAccessMode.Read))
{
// Set the image source to the selected bitmap
BitmapImage bitmapImage = new BitmapImage();
bitmapImage.DecodePixelWidth = 600; //match the target Image.Width, not shown
await bitmapImage.SetSourceAsync(fileStream);
Scenario2Image.Source = bitmapImage;
}
}
Dica
Se você estiver usando C# ou Microsoft Visual Basic, os fluxos poderão usar o tipo System.IO.Stream com o qual você pode estar familiarizado com a experiência de programação anterior do Microsoft .NET. Você pode chamar o método de extensão AsStream como um método de instância em qualquer objeto do tipo IRandomAccessStream obtido de uma API Windows Runtime. O exemplo anterior usou IRandomAccessStream para passagem de parâmetro e não precisou usar AsStream. Mas se você precisar manipular o fluxo, o AsStream estará lá como um utilitário para converter em um System.IO.Stream se você precisar dele.
Confira Exemplo de imagens XAML para obter mais exemplos de código.
Desempenho e arquivos de imagem
Arquivos de imagem grandes podem afetar o desempenho porque são carregados na memória. Se você estiver fazendo referência a um arquivo de imagem em que sabe que o arquivo de origem é uma imagem grande e de alta resolução, mas seu aplicativo está exibindo-o em uma região de interface do usuário menor que o tamanho natural da imagem, defina a propriedade DecodePixelWidth ou DecodePixelHeight. As propriedades DecodePixel* permitem que você passe informações diretamente para o codec específico do formato, e o codec pode usar essas informações para decodificar com mais eficiência e para um volume de memória menor. Defina DecodePixelWidth com a mesma largura de pixel da área que você deseja que seu aplicativo realmente exiba. Em outras palavras, DecodePixelWidth para a fonte BitmapImage deve ser o mesmo valor que Width ou ActualWidth do controle Image que exibe essa origem.
Você pode definir DecodePixelWidth ou definir DecodePixelHeight. Se você definir uma dessas duas propriedades, o sistema calculará a propriedade correspondente para manter a taxa de proporção correta. Você também pode definir ambas as propriedades, mas normalmente deve usar valores que mantêm essa taxa de proporção. Se você quiser alterar as taxas de proporção, há maneiras melhores de fazer isso, por exemplo, usando um TranslateTransform como rendertransform.
Para definir DecodePixelWidth (ou DecodePixelHeight) em XAML, você deve usar uma sintaxe XAML um pouco mais detalhada que inclua um elemento BitmapImage explícito como um valor de elemento de propriedade, desta forma:
<Image>
<Image.Source>
<BitmapImage DecodePixelWidth="200" UriSource="images/myimage.png"/>
</Image.Source>
</Image>
DecodePixelWidth (ou DecodePixelHeight) são propriedades de BitmapImage, portanto, você precisa de um elemento de objeto XAML BitmapImage explícito para definir as propriedades DecodePixel* como atributos em XAML.
Se você estiver criando uma instância image no código, provavelmente já está criando uma instância BitmapImage como um valor a ser fornecido para a propriedade Source , portanto, basta definir DecodePixelWidth (ou DecodePixelHeight) na instância BitmapImage antes de definir a propriedade UriSource . A propriedade DecodePixelType também afeta como os valores de pixel são interpretados pelas operações de decodificação.
Para impedir que as imagens sejam decodificadas mais de uma vez, atribua a propriedade de origem da imagem do URI (Uniform Resource Identifier) em vez de usar fluxos de memória sempre que possível. A estrutura XAML pode associar o mesmo URI (Uniform Resource Identifier) em vários locais a uma imagem decodificada, mas não pode fazer o mesmo para vários fluxos de memória, mesmo que contenham os mesmos dados.
Você pode remover arquivos de imagem do cache de imagens definindo todos os valores Image.Source associados como nulos.
Para obter mais informações sobre a classe Image e o desempenho, consulte Otimizar animações e mídia.
Codificação e decodificação de arquivo de imagem
O suporte de codec subjacente para arquivos de imagem é fornecido pela API wic (componente de imagem do Windows). Para obter mais informações sobre formatos de imagem específicos, conforme documentado para os codecs, consulte Codecs wic nativos.
A API para Imagem, BitmapImage e BitmapSource não inclui nenhum método dedicado para codificação e decodificação de formatos de mídia. Todas as operações de decodificação são internas como ações que ocorrem quando a origem é definida ou redefinida. Isso torna as classes mais fáceis de usar para construir a interface do usuário, pois elas têm um conjunto padrão de formatos de arquivo de origem com suporte e comportamento de decodificação. Classes como BitmapImage expõem algumas das opções de decodificação e lógica como parte dos dados de evento para eventos ImageOpened ou ImageFailed . Se você precisar de decodificação avançada de arquivo de imagem ou codificação de imagem, deverá usar a API do namespace Windows.Graphics.Imaging . Talvez você precise dessa API se o cenário do aplicativo envolver conversões de formato de arquivo de imagem ou manipulação de uma imagem em que o usuário possa salvar o resultado como um arquivo. A API de codificação também é compatível com o componente WIC (Componente de Imagem do Windows) do Windows.
Largura e altura da imagem
A classe Image herda as propriedades Width e Height de FrameworkElement e essas propriedades potencialmente controlam o tamanho que o controle Image renderizará quando for exibido na interface do usuário. Se você não definir uma Largura ou uma Altura, a largura e a altura serão determinadas pelo tamanho natural da origem da imagem. Por exemplo, se você carregar uma imagem de bitmap com 300 pixels de altura e 400 pixels de largura, conforme registrado em seu formato de arquivo de origem, essas medidas serão usadas para a largura e a altura quando o controle Image calcular seu tamanho natural. Você pode marcar ActualHeight e ActualWidth em tempo de execução após a renderização da imagem para obter as informações de medida. Ou você pode manipular propriedades de arquivo imageOpened e marcar, como PixelHeight e PixelWidth imediatamente antes da renderização da imagem.
Se você definir apenas uma das propriedades Width ou Height , mas não ambas, o sistema poderá usar essa dimensão como diretriz e calcular a outra, preservando a taxa de proporção. Se você não tiver certeza das dimensões do arquivo de origem, escolha a dimensão que é mais importante controlar em seu cenário de layout e deixe que o sistema calcule a outra dimensão e, em seguida, o comportamento de layout do contêiner normalmente adaptará o layout para caber.
Se você não definir Width e/ou Height e deixar a imagem como seu tamanho natural, a propriedade Stretch da imagem poderá controlar como o arquivo de origem da imagem preencherá o espaço especificado como Width e Height. O valor de Stretch padrão é Uniforme, que preserva a taxa de proporção quando ele ajusta a imagem em um contêiner de layout. Se as dimensões do contêiner não tiverem a mesma taxa de proporção, haverá espaço vazio que ainda faz parte da Imagem, mas não mostra nenhum pixel de imagem, pelo menos ao usar o valor Uniforme para Stretch. UniformToFill para Stretch não deixará espaço vazio, mas poderá recortar a imagem se as dimensões forem diferentes. O preenchimento de Stretch não deixará espaço vazio, mas poderá alterar a taxa de proporção. Você pode experimentar esses valores para ver o que é melhor para exibição de imagem em seu cenário de layout. Além disso, lembre-se de que determinados contêineres de layout podem dimensionar uma imagem que não tem largura e altura específicas para preencher todo o espaço de layout, nesse caso, você pode optar por definir tamanhos específicos na imagem ou no contêiner para ele.
NineGrid
Usar a técnica NineGrid é outra opção para dimensionar imagens que têm um tamanho natural diferente da área de exibição, se a imagem tiver regiões que não devem ser dimensionadas uniformemente. Por exemplo, você pode usar uma imagem de plano de fundo que tenha uma borda inerente que só deve se alongar em uma dimensão e cantos que não devem se alongar, mas o centro de imagens pode se alongar para se ajustar aos requisitos de layout em ambas as dimensões. Para obter mais informações, consulte NineGrid.
Qualificação e localização de recursos para Imagem
Arquivos de origem de imagem e dimensionamento
Você deve criar suas fontes de imagem em vários tamanhos recomendados, para garantir que seu aplicativo fique ótimo quando o Windows 8 o dimensionar. Ao especificar uma Origem para uma Imagem, você pode usar uma convenção de nomenclatura para recursos que usarão o recurso correto para fatores de dimensionamento específicos do dispositivo. Isso é determinado pelo aplicativo automaticamente em tempo de execução. Para obter detalhes das convenções de nomenclatura a serem usadas e mais informações, consulte Início Rápido: usando recursos de arquivo ou imagem.
Para obter mais informações sobre como projetar imagens corretamente para dimensionamento, consulte Diretrizes de experiência do usuário para layout e dimensionamento.
Usando recursos não qualificados
Recursos não qualificados são uma técnica que você pode usar em que a referência de recurso básica se refere a um recurso padrão e o processo de gerenciamento de recursos pode encontrar o recurso localizado equivalente automaticamente. Você pode usar o tratamento automático para acessar recursos não qualificados com qualificadores de escala e cultura atuais ou usar ResourceManager e ResourceMap com qualificadores para cultura e escala para obter os recursos diretamente. Para saber mais, veja Sistema de gerenciamento de recursos.
FlowDirection para Imagem
Se você definir FlowDirection como RightToLeft para uma Imagem, o conteúdo visual de uma imagem será invertido horizontalmente. No entanto, um elemento Image não herda o valor FlowDirection de nenhum elemento pai. Normalmente, você só deseja um comportamento de inversão de imagem em imagens relevantes para o layout, mas não necessariamente para elementos que tenham texto inserido ou outros componentes que não fariam sentido invertido para um público da direita para a esquerda. Para obter o comportamento de inversão de imagem, você deve definir o elemento FlowDirection no elemento Image especificamente como RightToLeft ou definir a propriedade FlowDirection em code-behind. Considere identificar o elemento Image pela diretiva x:Uid e especificar valores FlowDirection como um recurso Windows Runtime, para que os especialistas em localização possam alterar esse valor posteriormente sem alterar o XAML ou o código.
A classe Image e a acessibilidade
A classe Image não é uma classe de controle verdadeira, pois não é uma classe descendente de Control. Você não pode chamar o foco para um elemento Image ou colocar um elemento Image em uma sequência de guias. Para obter mais informações sobre os aspectos de acessibilidade do uso de imagens e o elemento Image em sua interface do usuário, consulte Informações básicas de acessibilidade.
Comportamento do Windows 8
Para o Windows 8, os recursos podem usar um padrão de qualificador de recursos para carregar recursos diferentes dependendo do dimensionamento específico do dispositivo. No entanto, os recursos não serão recarregados automaticamente se o fator de dimensionamento for alterado enquanto o aplicativo estiver em execução. Nesse caso, os aplicativos teriam que cuidar do recarregamento de recursos, manipulando o evento DpiChanged (ou o evento LogicalDpiChanged preterido) e usando a API ResourceManager para recarregar manualmente o recurso apropriado para o novo fator de dimensionamento. Começando com Windows 8.1, qualquer recurso que foi originalmente recuperado para seu aplicativo será automaticamente reavaliado se o fator de dimensionamento for alterado enquanto o aplicativo estiver em execução. Além disso, quando esse recurso é a fonte de imagem de um objeto Image, um dos eventos de carga de origem (ImageOpened ou ImageFailed) é acionado como resultado da ação do sistema de solicitar o novo recurso e, em seguida, aplicá-lo à Imagem. O cenário em que uma alteração de escala em tempo de execução pode acontecer é se o usuário move seu aplicativo para um monitor diferente quando mais de um está disponível.
Se você migrar o código do aplicativo do Windows 8 para Windows 8.1 talvez queira considerar essa alteração de comportamento, pois isso resulta em eventos ImageOpened ou ImageFailed que ocorrem em tempo de execução quando a alteração de escala é tratada, mesmo nos casos em que a Origem é definida em XAML. Além disso, se você tiver código que lidou com DpiChanged/LogicalDpiChanged e redefinir os recursos, deverá examinar se esse código ainda é necessário, dado o novo Windows 8.1 comportamento de recarregamento automático.
Os aplicativos que foram compilados para Windows 8, mas estão sendo executados no Windows 8.1, continuam a adotar o comportamento do Windows 8.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1607 | 14393 | GetAlphaMask |
Construtores
| Image() |
Inicializa uma nova instância da classe Image . |
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, 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) |
| 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) |
| 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) |
| 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) |
| 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) |
| 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) |
| 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) |
| 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 |
| 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) |
| 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) |
| 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) |
| IsRightTapEnabled |
Obtém ou define um valor que determina se o evento RightTapped pode se originar desse elemento. (Herdado de UIElement) |
| IsTapEnabled |
Obtém ou define um valor que determina se o evento Tapped pode se originar desse elemento. (Herdado de UIElement) |
| 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 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 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) |
| 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) |
| NineGrid |
Obtém ou define um valor para uma metáfora de nove grades que controla como a imagem pode ser redimensionada. A metáfora de nove grades permite que você estique bordas e cantos de uma imagem de forma diferente de seu centro. Consulte Comentários para obter mais informações e uma ilustração. |
| NineGridProperty |
Identifica a propriedade de dependência NineGrid . |
| 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) |
| Parent |
Obtém o objeto pai desse FrameworkElement na árvore de objetos. (Herdado de FrameworkElement) |
| PlayToSource |
Obtém as informações que serão transmitidas se a Imagem for usada para um cenário reproduzir para. |
| PlayToSourceProperty |
Identifica a propriedade de dependência PlayToSource . |
| PointerCaptures |
Obtém o conjunto de todos os ponteiros capturados, representados como valores pointer . (Herdado de UIElement) |
| Projection |
Obtém ou define a projeção de perspectiva (efeito 3D) a ser aplicada ao renderizar esse elemento. (Herdado de UIElement) |
| RenderSize |
Obtém o tamanho de renderização final 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 especificado com RequestedTheme pode substituir o RequestedTheme no nível do aplicativo. (Herdado de FrameworkElement) |
| 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 |
| 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) |
| Shadow |
Obtém ou define o efeito de sombra convertido pelo elemento . (Herdado de UIElement) |
| Source |
Obtém ou define a origem da imagem. |
| SourceProperty |
Identifica a propriedade Dependência de origem . |
| Stretch |
Obtém ou define um valor que descreve como uma Imagem deve ser ampliada para preencher o retângulo de destino. |
| StretchProperty |
Identifica a propriedade de dependência Stretch . |
| 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 TabIndex funcionam para esse controle. (Herdado de UIElement) |
| 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) |
| 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) |
| 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) |
| 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 |
| XYFocusDownNavigationStrategy |
Obtém ou define um valor que especifica a estratégia usada para determinar o elemento de destino de uma navegação inativa. (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) |
| 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) |
| 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) |
| 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) |
| 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) |
| 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) |
| GetAlphaMask() |
Retorna uma máscara que representa o canal alfa de uma imagem como um CompositionBrush. |
| 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) |
| GetAsCastingSource() |
Retorna a imagem como um CastingSource. |
| 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) |
| 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 do 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 que é 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 "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 do evento BringIntoViewRequested ocorrer. (Herdado de UIElement) |
| OnCreateAutomationPeer() |
Quando implementado em uma classe derivada, retorna implementações de AutomationPeer específicas da classe para a infraestrutura de Automação da Interface do Usuário da Microsoft. (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) |
| 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) |
| 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) |
| 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 esse UIElement. (Herdado de UIElement) |
| ReleasePointerCaptures() |
Libera todas as capturas de ponteiro mantidas por esse elemento. (Herdado de UIElement) |
| 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) |
| 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 em toda a árvore visual do UIElement 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 um de seus descendentes. (Herdado de UIElement) |
| 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) |
| 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) |
| 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) |
| 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) |
| ImageFailed |
Ocorre quando há um erro associado à recuperação ou ao formato da imagem. |
| ImageOpened |
Ocorre quando a origem da imagem é baixada e decodificada sem falha. Você pode usar esse evento para determinar o tamanho natural da origem da imagem. |
| 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) |
| 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 clique desse elemento. (Herdado de UIElement) |
| PointerExited |
Ocorre quando um ponteiro sai da área de teste de clique desse elemento. (Herdado de UIElement) |
| PointerMoved |
Ocorre quando um ponteiro se move enquanto o ponteiro permanece dentro da área de teste de clique 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 está dentro desse elemento. Observe que não há garantia de que o fim de uma ação De imprensa dispare um evento PointerReleased; outros eventos podem ser acionados. Para obter mais informações, consulte Comentários. (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 é liberada enquanto o UIElement tem foco. (Herdado de UIElement) |
| ProcessKeyboardAccelerators |
Ocorre quando um atalho de teclado (ou acelerador) é pressionado. (Herdado de UIElement) |
| RightTapped |
Ocorre quando ocorre um estímulo de entrada de toque direito enquanto o ponteiro está sobre o elemento . (Herdado de UIElement) |
| SizeChanged |
Ocorre quando a propriedade ActualHeight ou ActualWidth altera o valor em um FrameworkElement. (Herdado de FrameworkElement) |
| Tapped |
Ocorre quando uma interação tap sem tratamento ocorre na área de teste de clique 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
Confira também
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