Visual.VisualScrollableAreaClip Propriedade

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 de Propriedade

A que representa a área de recorte deslocável, ou null se não estiver atribuída nenhuma Rect área de recorte.

Observações

Defina a VisualScrollableAreaClip propriedade para permitir o scroll acelerado ao renderizar em software. Isto é útil em cenários de renderização remota, como correr sobre Ambiente de Trabalho Remoto ou correr numa máquina virtual. Defina esta propriedade no elemento pai cujos filhos serão deslocados. Definir a VisualScrollableAreaClip propriedade não tem efeito quando a renderização é acelerada por hardware.

A VisualScrollableAreaClip propriedade permite cenários específicos e avançados. A lista seguinte mostra as ressalvas que se aplicam quando utiliza a VisualScrollableAreaClip propriedade.

• O fundo da área rolada deve ser opaco, caso contrário ocorrerão artefactos de rolamento.

• A propriedade VisualScrollableAreaClip acelera o scroll apenas quando WPF está a renderizar em software. Por exemplo, esta situação ocorre quando a aplicação está a correr sobre Ambiente de Trabalho Remoto ou localmente numa máquina virtual.

• O comportamento de scroll mantém-se inalterado ao renderizar em hardware. Para evitar diferenças no comportamento de scroll, deve manter a VisualScrollableAreaClip propriedade ativada tanto para hardware como para software.

• Transformações de rotação e desvio desativam o scroll acelerado. Transformações de escala e translações horizontais ou verticais acima da região deslocada funcionam corretamente e não desativam a aceleração de deslocamento.

• Mudar a subárvore ou ativar partes da área deslocável para redesenhar via animação comporta-se como esperado, mas perde o benefício do scroll acelerado para a área redesenhada. Qualquer animação que invalide a área deslocada durante o mesmo frame em que ocorre o scroll elimina o benefício desta otimização.

• O VisualScrollableAreaClip retângulo encaixa-se para dentro, em pixels. Portanto, o tamanho estalado do retângulo de scroll é sempre menor ou igual ao tamanho que definiste.

• Os deslocamentos descem bruscamente. Isto significa que a diferença entre o deslocamento estalado anterior e o deslocamento estalado atual é sempre um número inteiro de píxeis.

• Os testes de acerto podem estar errados até um pixel.

• O arredondamento do layout deve ser ativado, pois garante que as bordas das áreas deslocáveis e a área do cliente da janela de fronteira sejam encaixadas nos limites dos píxeis, resultando num alinhamento correto.

• A aceleração por scroll não funciona em janelas em camadas. Isto significa janelas em que AllowTransparency == true, window.windowstyle == nenhum, e assim sucessivamente.

• A aceleração de scroll não ocorre durante a renderização em janela completa.

• A aceleração por scroll não funciona quando a janela está entre dois monitores.

• A aceleração por scroll não funciona na presença de alvos de renderização intermédios na cadeia principal do elemento deslocado. A lista seguinte mostra alguns destes alvos de renderização intermédios.

  • Excertos

  • Efeitos

  • Pincéis de Desenho

  • VisualBrushes

  • Máscaras de Opacidade

  • Opacidade

• Só pode acontecer um scroll acelerado por frame. Podem existir múltiplas áreas de scroll acelerado, mas apenas uma delas pode realizar um scroll acelerado durante um frame. Qual a área que se desloca é indeterminada.

• A aceleração de scroll suporta conteúdos acima da região de scrolling (em ordem z) que não são deslocados com o resto do conteúdo. O sistema calcula todas as regiões sujas necessárias e completa o scroll acelerado, mas envia vários bitmaps adicionais pelo fio para mover a porção involuntariamente deslocada de volta à sua posição correta no ecrã.