Visual Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece suporte de renderização em WPF, que inclui testes de hits, transformação de coordenadas e cálculos de caixas delimitadoras.
public ref class Visual abstract : System::Windows::DependencyObjectpublic abstract class Visual : System.Windows.DependencyObjecttype Visual = class
inherit DependencyObject
interface DUCE.IResourcetype Visual = class
inherit DependencyObjectPublic MustInherit Class Visual
Inherits DependencyObject- Herança
- Derivado
Observações
A Visual classe é a abstração básica da qual todo FrameworkElement objeto deriva. Também serve como ponto de entrada para a escrita de novos controlos em WPF e, em muitos aspetos, pode ser visto como um equivalente a um handle de janela (HWND) no modelo de aplicação Win32.
O objeto Visual é um objeto WPF principal, cuja função principal é fornecer suporte à renderização. Os controlos da interface de utilizador, como Button e TextBox, derivam da Visual classe e utilizam as Visual propriedades definidas para persistir os seus dados de renderização. O Visual objeto fornece suporte para o seguinte:
Exibição de resultados: renderização do conteúdo de desenho persistente e serializado de uma visualização.
Transformações: Realizar transformações num visual.
Recorte: Fornece suporte de região de recorte para um visual.
Teste de acerto: Determinar se uma coordenada (ponto) ou geometria especificada está contida dentro dos limites de um visual.
Os cálculos da caixa delimitadora: Determinar o retângulo delimitador de um elemento visual.
Arquitetonicamente, o objeto Visual não inclui suporte para outros requisitos de desenvolvimento de aplicações / funcionalidades WPF que não estejam diretamente relacionadas com a sua renderização, tais como as seguintes:
Tratamento de eventos
Esquema
Estilos
Vinculação de dados
Globalização
Visual é fornecida como uma classe abstrata pública da qual podem ser derivadas classes adicionais. A ilustração seguinte mostra a hierarquia dos objetos visuais existentes definidos na arquitetura WPF.
Hierarquia visual de classes
Em alguns casos, membros definidos como protegidos em Visual são expostos como membros mais facilmente acessíveis com nomes semelhantes na classe derivada UIElement .
Para obter mais informações, consulte Visão geral da renderização de gráficos do WPF.
A Visual tem um número limitado de níveis. Nas versões anteriores do Framework .NET, esta profundidade máxima era de 255. Este limite é inadequado para alguns layouts que têm muitos níveis na árvore visual.
No .NET Framework 4, a profundidade máxima de um Visual é 2047, o que permite árvores visuais muito mais profundas. Na maioria das aplicações, não há espaço suficiente na pilha para atravessar tantos níveis, e o resultado é um StackOverflowException layout durante o processo. Para o tamanho padrão da pilha, esta exceção é normalmente lançada quando a profundidade da árvore é aproximadamente 800, o que corresponde a cerca de 190 objetos aninhados TreeViewItem .
Se esta exceção for lançada pela sua aplicação e precisar de uma árvore visual mais profunda, pode aumentar o tamanho da pilha da aplicação. Pode aumentar o tamanho da pilha usando a opção /STACK em tempo de compilação ou usando a utilidade EDITBIN. Aumentar o tamanho da pilha pode afetar o desempenho da sua aplicação. Para mais informações, consulte Alocações de Pilha e Opções EDITBIN.
Construtores
| Name | Description |
|---|---|
| Visual() |
Fornece a inicialização base para objetos derivados da Visual classe. |
Propriedades
| Name | Description |
|---|---|
| DependencyObjectType |
Obtém o DependencyObjectType que envolve o tipo CLR desta instância. (Herdado de DependencyObject) |
| Dispatcher |
Percebe o Dispatcher que isto DispatcherObject está associado. (Herdado de DispatcherObject) |
| IsSealed |
Recebe um valor que indica se esta instância está atualmente selada (apenas leitura). (Herdado de DependencyObject) |
| VisualBitmapEffect |
Obsoleto.
Obsoleto.
Obtém ou define o BitmapEffect valor para o Visual. |
| VisualBitmapEffectInput |
Obsoleto.
Obsoleto.
Obtém ou define o BitmapEffectInput valor para o Visual. |
| VisualBitmapScalingMode |
Obtém ou define para BitmapScalingMode o Visual. |
| VisualCacheMode |
Obtém ou define uma representação em cache do Visual. |
| VisualChildrenCount |
Obtém o número de elementos filhos para o Visual. |
| VisualClearTypeHint |
Obtém ou define o ClearTypeHint que determina como o ClearType é renderizado no Visual. |
| VisualClip |
Obtém ou define a região de clip de como Visual valor Geometry . |
| VisualEdgeMode |
Obtém ou define o modo de aresta de como Visual um EdgeMode valor. |
| VisualEffect |
Obtém ou define o efeito bitmap para se aplicar ao Visual. |
| VisualOffset |
Obtém ou define o valor de deslocamento do objeto visual. |
| VisualOpacity |
Obtém ou define a opacidade do Visual. |
| VisualOpacityMask |
Obtém ou define o Brush valor que representa a máscara de opacidade do Visual. |
| VisualParent |
Obtém o pai da árvore visual do objeto visual. |
| VisualScrollableAreaClip |
Obtém ou define uma área deslocável recortada para o Visual. |
| VisualTextHintingMode |
Obtém ou define o TextHintingMode do Visual. |
| VisualTextRenderingMode |
Obtém ou define o TextRenderingMode do Visual. |
| VisualTransform | |
| VisualXSnappingGuidelines |
Obtém ou define a coleção de orientações de coordenadas x (verticais). |
| VisualYSnappingGuidelines |
Obtém ou define a coleção de orientações de coordenadas y (horizontais). |
Métodos
| Name | Description |
|---|---|
| AddVisualChild(Visual) |
Define a relação pai-filho entre dois visuais. |
| CheckAccess() |
Determina se o thread que chama tem acesso a este DispatcherObject. (Herdado de DispatcherObject) |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um DependencyProperty identificador. (Herdado de DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Limpa o valor local de uma propriedade de apenas leitura. O imóvel a ser limpo é especificado por um DependencyPropertyKey. (Herdado de DependencyObject) |
| CoerceValue(DependencyProperty) |
Coage o valor da propriedade de dependência especificada. Isto é conseguido invocando qualquer CoerceValueCallback função especificada nos metadados da propriedade para a propriedade de dependência tal como existe na chamada DependencyObject. (Herdado de DependencyObject) |
| Equals(Object) |
Determina se um fornecido DependencyObject é equivalente à corrente DependencyObject. (Herdado de DependencyObject) |
| FindCommonVisualAncestor(DependencyObject) |
Devolve o ancestral comum de dois objetos visuais. |
| GetHashCode() |
Obtém um código de hash para isto DependencyObject. (Herdado de DependencyObject) |
| GetLocalValueEnumerator() |
Cria um enumerador especializado para determinar quais as propriedades de dependência que têm valores localmente definidos neste DependencyObject. (Herdado de DependencyObject) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetValue(DependencyProperty) |
Devolve o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject) |
| GetVisualChild(Int32) |
Devolve o especificado Visual no pai VisualCollection. |
| HitTestCore(GeometryHitTestParameters) |
Determina se um valor geométrico está dentro dos limites do objeto visual. |
| HitTestCore(PointHitTestParameters) |
Determina se o valor de uma coordenada pontual está dentro dos limites do objeto visual. |
| InvalidateProperty(DependencyProperty) |
Reavalia o valor efetivo da propriedade de dependência especificada. (Herdado de DependencyObject) |
| IsAncestorOf(DependencyObject) |
Determina se o objeto visual é um ancestral do objeto visual descendente. |
| IsDescendantOf(DependencyObject) |
Determina se o objeto visual é descendente do objeto visual ancestral. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnDpiChanged(DpiScale, DpiScale) |
Chamada quando o DPI em que esta Vista é renderizada muda. |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Invocado sempre que o valor efetivo de qualquer propriedade de dependência disto DependencyObject for atualizado. A propriedade específica da dependência que mudou é reportada nos dados do evento. (Herdado de DependencyObject) |
| OnVisualChildrenChanged(DependencyObject, DependencyObject) |
Chamado quando o VisualCollection objeto visual é modificado. |
| OnVisualParentChanged(DependencyObject) |
Chamada quando o pai do objeto visual é alterado. |
| PointFromScreen(Point) |
Converte coordenadas Point no ecrã em um Point que representa o sistema de coordenadas atual do Visual. |
| PointToScreen(Point) |
Converte um Point que representa o sistema de coordenadas atual de o Visual em Point coordenadas no ecrã. |
| ReadLocalValue(DependencyProperty) |
Devolve o valor local de uma propriedade de dependência, se esta existir. (Herdado de DependencyObject) |
| RemoveVisualChild(Visual) |
Remove a relação entre pais e filhos entre dois visuais. |
| SetCurrentValue(DependencyProperty, Object) |
Define o valor de uma propriedade de dependência sem alterar a sua fonte de valor. (Herdado de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Define o valor local de uma propriedade de dependência, especificado pelo seu identificador de propriedade de dependência. (Herdado de DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Define o valor local de uma propriedade de dependência somente de leitura, especificado pelo DependencyPropertyKey identificador da propriedade de dependência. (Herdado de DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Devolve um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| TransformToAncestor(Visual) |
Devolve uma transformação que pode ser usada para transformar coordenadas do Visual para o ancestral especificado Visual do objeto visual. |
| TransformToAncestor(Visual3D) |
Devolve uma transformação que pode ser usada para transformar coordenadas do Visual para o ancestral especificado Visual3D do objeto visual. |
| TransformToDescendant(Visual) |
Devolve uma transformada que pode ser usada para transformar coordenadas do Visual para o descendente do objeto visual especificado. |
| TransformToVisual(Visual) |
Devolve uma transformada que pode ser usada para transformar coordenadas de para Visual o objeto visual especificado. |
| VerifyAccess() |
Faz cumprir que o thread que chama tem acesso a este DispatcherObject. (Herdado de DispatcherObject) |
