Visual.VisualScrollableAreaClip Propriedade

Definição

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Obtém ou define uma área rolável recortada para o Visual.

public:  property Nullable<System::Windows::Rect> VisualScrollableAreaClip {  protected public:
Nullable<System::Windows::Rect> get(); protected:
 void set(Nullable<System::Windows::Rect> value); };

public System.Windows.Rect? VisualScrollableAreaClip { protected internal get; protected set; }

member this.VisualScrollableAreaClip : Nullable<System.Windows.Rect> with get, set

Public Property VisualScrollableAreaClip As Nullable(Of Rect)

Valor da propriedade

Nullable<Rect>

Um Rect que representa a área de recorte rolável ou null se nenhuma área de recorte for atribuída.

Comentários

Defina a VisualScrollableAreaClip propriedade para habilitar a rolagem acelerada ao renderizar no software. Isso é útil em cenários de renderização remota, como executar pela Área de Trabalho Remota ou em execução em uma máquina virtual. Defina essa propriedade no elemento pai cujos filhos serão rolados. A configuração da VisualScrollableAreaClip propriedade não tem efeito quando a renderização é acelerada por hardware.

A VisualScrollableAreaClip propriedade habilita cenários específicos e avançados. A lista a seguir mostra as ressalvas que se aplicam quando você usa a VisualScrollableAreaClip propriedade .

• A tela de fundo da área rolada deve ser opaca ou os artefatos de rolagem ocorrerão.

• A VisualScrollableAreaClip propriedade acelera a rolagem somente quando o WPF está sendo renderizado no software. Por exemplo, essa situação ocorre quando o aplicativo está em execução na Área de Trabalho Remota ou em execução localmente em uma máquina virtual.

• O comportamento de rolagem não é alterado durante a renderização no hardware. Para evitar diferenças no comportamento de rolagem, você deve manter a VisualScrollableAreaClip propriedade habilitada para hardware e software.

• Girar e distorcer transformações desabilitam a rolagem acelerada. As transformações de escala e as traduções horizontais ou verticais acima da região rolada funcionam corretamente e não desabilitam a aceleração de rolagem.

• Alterar a subárvore ou disparar partes da área rolável para redesenhar por meio da animação se comporta conforme o esperado, mas perde o benefício da rolagem acelerada para a área redesenhada. Qualquer animação que invalide a área rolada durante o mesmo quadro em que a rolagem ocorre elimina o benefício dessa otimização.

• O VisualScrollableAreaClip retângulo se ajusta para dentro de pixels. Portanto, o tamanho ajustado do retângulo de rolagem é sempre menor ou igual ao tamanho definido.

• Os deslocamentos se ajustam para baixo. Isso significa que a diferença do deslocamento ajustado anterior e do deslocamento ajustado atual é sempre um número inteiro de pixels.

• Os testes de clique podem estar desativados em até um pixel.

• O arredondamento de layout deve ser ativado, pois garante que as bordas das áreas roláveis e da área do cliente da janela de limite sejam ajustadas aos limites de pixel, resultando no alinhamento correto.

• A aceleração de rolagem não funciona em janelas em camadas. Isso significa janelas nas quais AllowTransparency == true, window.windowstyle == none e assim por diante.

• A aceleração de rolagem não ocorre durante a renderização de janela inteira.

• A aceleração de rolagem não funciona quando a janela atravessa dois monitores.

• A aceleração de rolagem não funciona na presença de destinos de renderização intermediários na cadeia pai do elemento rolado. A lista a seguir mostra alguns desses destinos de renderização intermediários.

  • Clipes

  • Efeitos

  • DrawingBrushes

  • VisualBrushes

  • OpacidadeMasks

  • Opacidade

• Somente uma rolagem acelerada pode acontecer por quadro. Pode haver várias áreas de rolagem aceleradas, mas apenas uma delas pode executar uma rolagem acelerada durante um quadro. Qual área é rolada é indeterminada.

• A aceleração de rolagem dá suporte ao conteúdo acima da região de rolagem (em ordem z) que não é rolada com o restante do conteúdo. O sistema calcula todas as regiões sujas necessárias e conclui a rolagem acelerada, mas envia vários bitmaps adicionais sobre o fio para mover a parte rolada involuntariamente de volta para sua posição correta na tela.