Visual Classe

Referência

Definição

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece suporte à renderização no WPF, que inclui teste de clique, transformação de coordenadas e cálculos da caixa delimitadora.

public ref class Visual abstract : System::Windows::DependencyObject

public abstract class Visual : System.Windows.DependencyObject

type Visual = class
    inherit DependencyObject
    interface DUCE.IResource

type Visual = class
    inherit DependencyObject

Public MustInherit Class Visual
Inherits DependencyObject

Herança: Object

DispatcherObject

DependencyObject
Visual

Derivado: System.Windows.Media.ContainerVisual

System.Windows.Media.Media3D.Viewport3DVisual

System.Windows.UIElement

Comentários

A Visual classe é a abstração básica da qual cada FrameworkElement objeto deriva. Ele também serve como o ponto de entrada para escrever novos controles no WPF e, em muitos aspectos, pode ser considerado como um equivalente a um identificador de janela (HWND) no modelo de aplicativo Win32.

O Visual objeto é um objeto WPF principal, cuja função principal é fornecer suporte de renderização. Controles de interface do usuário, como Button e TextBox, derivam da Visual classe, e usam as Visual propriedades definidas para persistir seus dados de renderização. O Visual objeto fornece suporte para o seguinte:

Exibição de saída: renderização do conteúdo de desenho persistentes e serializado de um visual.
Transformações: realizando transformações em um visual.
Recorte: dar suporte à área de recorte para um visual.
Teste de clique: determinar se uma coordenada especificada (ponto) ou geometria está contida dentro dos limites de um visual.
Cálculos de caixa delimitadora: determinar o retângulo delimitador de um visual.

Arquitetônicamente, o Visual objeto não inclui suporte para outros requisitos de desenvolvimento de aplicativos/recursos do WPF que não estão imediatamente relacionados à sua renderização, como o seguinte:

Manipulação de eventos
Layout
Estilos
Associação de dados
Globalização

Visual é fornecida como uma classe abstrata pública da qual outras classes podem ser derivadas. A ilustração a seguir mostra a hierarquia dos objetos visuais existentes definidos na arquitetura do WPF.

Diagrama de classes derivadas do objeto visual
Hierarquia de classes visuais

Em alguns casos, os membros definidos como protegidos 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 de renderização de gráficos do WPF.

A Visual tem um número limitado de níveis. Nas versões anteriores do .NET Framework, essa profundidade máxima era de 255. Esse limite é inadequado para alguns layouts que têm muitos níveis na árvore visual.

Em .NET Framework 4, a profundidade máxima de um Visual é 2047, que permite árvores visuais muito mais profundas. Na maioria dos aplicativos, não há espaço de pilha suficiente para percorrer tantos níveis e o resultado é um StackOverflowException layout durante. Para o tamanho da pilha padrão, essa exceção geralmente é gerada quando a profundidade da árvore é de aproximadamente 800, o que corresponde a cerca de 190 objetos aninhados TreeViewItem .

Se essa exceção for gerada pelo aplicativo e você precisar ter uma árvore visual mais profunda, poderá aumentar o tamanho da pilha do aplicativo. Você pode aumentar o tamanho da pilha usando a opção /STACK no momento da compilação ou usando o utilitário EDITBIN. Aumentar o tamanho da pilha pode afetar o desempenho do aplicativo. Para obter mais informações, consulte Alocações de Pilha e Opções EDITBIN.

Construtores

Visual()

Fornece a inicialização de base para objetos derivados da classe Visual.

Propriedades

DependencyObjectType	Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject)
Dispatcher	Obtém o Dispatcher ao qual este DispatcherObject está associado. (Herdado de DispatcherObject)
IsSealed	Obtém um valor que indica se essa instância está validada no momento (somente leitura). (Herdado de DependencyObject)
VisualBitmapEffect	Obsoleto. Obsoleto. Obtém ou define o valor BitmapEffect para o Visual.
VisualBitmapEffectInput	Obsoleto. Obsoleto. Obtém ou define o valor BitmapEffectInput para o Visual.
VisualBitmapScalingMode	Obtém ou define o BitmapScalingMode do Visual.
VisualCacheMode	Obtém ou define uma representação armazenada em cache do Visual.
VisualChildrenCount	Obtém o número de elementos filhos do 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 corte do Visual como um valor Geometry.
VisualEdgeMode	Obtém ou define o modo de borda do Visual com um valor EdgeMode.
VisualEffect	Obtém ou define o efeito de bitmap a ser aplicado 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 valor Brush 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 rolável recortada para o Visual.
VisualTextHintingMode	Obtém ou define o TextHintingMode do Visual.
VisualTextRenderingMode	Obtém ou define o TextRenderingMode do Visual.
VisualTransform	Obtém ou define o valor Transform para o Visual.
VisualXSnappingGuidelines	Obtém ou define a coleção de diretrizes (vertical) da coordenada X.
VisualYSnappingGuidelines	Obtém ou define a coleção de diretrizes (horizontal) da coordenada y.

Métodos

AddVisualChild(Visual)	Define a relação pai-filho entre dois visuais.
CheckAccess()	Determina se o thread de chamada 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 identificador DependencyProperty. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade somente leitura. A propriedade a ser limpa é especificada por um DependencyPropertyKey. (Herdado de DependencyObject)
CoerceValue(DependencyProperty)	Converte o valor da propriedade de dependência especificada. Isso é feito invocando qualquer função CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência, visto que ela existe na chamada a DependencyObject. (Herdado de DependencyObject)
Equals(Object)	Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual. (Herdado de DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Retorna o ancestral comum de dois objetos visuais.
GetHashCode()	Obtém o código hash para esse DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject. (Herdado de DependencyObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject. (Herdado de DependencyObject)
GetVisualChild(Int32)	Retorna o Visual especificado no VisualCollection pai.
HitTestCore(GeometryHitTestParameters)	Determina se um valor de geometria está dentro dos limites do objeto visual.
HitTestCore(PointHitTestParameters)	Determina se um valor de coordenadas de ponto está dentro dos limites do objeto visual.
InvalidateProperty(DependencyProperty)	Reavalia o valor efetivo para a 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 é um descendente do objeto visual ancestral.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnDpiChanged(DpiScale, DpiScale)	Chamado quando o DPI em que esse modo de exibição é renderizado é alterada.
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizado. A propriedade de dependência específica que mudou é relatada os dados do evento. (Herdado de DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Chamado quando o VisualCollection de um objeto visual é modificado.
OnVisualParentChanged(DependencyObject)	Chamado quando o pai do objeto visual for alterado.
PointFromScreen(Point)	Converte um Point em coordenadas de tela em um Point que representa o sistema de coordenadas atual do Visual.
PointToScreen(Point)	Converte um Point que representa o sistema de coordenadas atual do Visual em um Point nas coordenadas da tela.
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, local, se houver. (Herdado de DependencyObject)
RemoveVisualChild(Visual)	Remove a relação pai-filho entre dois visuais.
SetCurrentValue(DependencyProperty, Object)	Define o valor da propriedade de dependência sem alterar a origem do valor. (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência. (Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TransformToAncestor(Visual)	Retorna uma transformação que pode ser usada para transformar as coordenadas do Visual para o ancestral Visual especificado do objeto visual.
TransformToAncestor(Visual3D)	Retorna uma transformação que pode ser usada para transformar as coordenadas do Visual para o ancestral Visual3D especificado do objeto visual.
TransformToDescendant(Visual)	Retorna uma transformação que pode ser usada para transformar as coordenadas do Visual até o descendente do objeto visual especificado.
TransformToVisual(Visual)	Retorna uma transformação que pode ser usada para transformar as coordenadas do Visual até o objeto visual especificado.
VerifyAccess()	Impõe que o thread de chamada tenha acesso a este DispatcherObject. (Herdado de DispatcherObject)

Aplica-se a