Visual.VisualScrollableAreaClip Свойство

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)

Значение свойства

Объект Rect , представляющий прокручиваемую область вырезки или null если область вырезки не назначена.

Комментарии

VisualScrollableAreaClip Задайте свойство, чтобы включить ускорение прокрутки при отрисовке в программном обеспечении. Это полезно в сценариях удаленной отрисовки, таких как запуск на удаленном рабочем столе или запуск в виртуальной машине. Задайте это свойство в родительском элементе, дочерние элементы которого будут прокручиваться. VisualScrollableAreaClip Установка свойства не влияет на процесс отрисовки аппаратного ускорения.

Свойство VisualScrollableAreaClip включает определенные расширенные сценарии. В следующем списке показаны предостережения, которые применяются при использовании VisualScrollableAreaClip свойства.

• Фон прокрученной области должен быть непрозрачным или будет выполняться прокрутка артефактов.

• Свойство VisualScrollableAreaClip ускоряет прокрутку только при отрисовке WPF в программном обеспечении. Например, эта ситуация возникает, когда приложение работает на удаленном рабочем столе или работает локально на виртуальной машине.

• Поведение прокрутки не изменяется при отрисовке в оборудовании. Чтобы предотвратить различия в поведении прокрутки, следует сохранить VisualScrollableAreaClip свойство включено как для оборудования, так и для программного обеспечения.

• Поворот и отклонение преобразований отключают ускоренную прокрутку. Преобразования масштабирования и горизонтальные или вертикальные переводы над прокручиваемой областью работают правильно и не отключают ускорение прокрутки.

• Изменение поддерев или активация частей прокручиваемой области для перераспределения с помощью анимации ведет себя должным образом, но потеряет преимущество ускорения прокрутки для переопределенной области. Любая анимация, которая делает прокрученной областью в том же кадре, в котором происходит прокрутка, устраняет преимущество этой оптимизации.

• Прямоугольник VisualScrollableAreaClip привязывается к пикселям. Таким образом, размер прямоугольника прокрутки всегда меньше или равен заданному размеру.

• Смещения оснастки вниз. Это означает, что разница между предыдущим смещенным смещением и текущим оснастки всегда является целым числом пикселей.

• Тесты попадания могут быть отключены до пикселя.

• Округление макета должно быть включено, так как это гарантирует, что края прокручиваемых областей и клиентской области окна границы привязываются к границам пикселей, что приводит к правильному выравниванию.

• Ускорение прокрутки не работает на многоуровневые окна. Это означает, что окна, в которых AllowTransparency == true, window.windowstyle == нет, и т. д.

• Ускорение прокрутки не происходит во время отрисовки полного окна.

• Ускорение прокрутки не работает, когда окно перестраивает два монитора.

• Ускорение прокрутки не работает в присутствии промежуточных целевых объектов отрисовки в родительской цепочке прокручиваемого элемента. В следующем списке показаны некоторые из этих промежуточных целевых объектов отрисовки.

  • Клипы

  • Эффекты

  • DrawingBrushes

  • VisualBrushes

  • OpacityMasks

  • Непрозрачность

• На кадр может произойти только одна ускоренная прокрутка. Может быть несколько областей ускорения прокрутки, но только одна из них может выполнять ускоренную прокрутку во время кадра. Какая область прокручивается, не определено.

• Ускорение прокрутки поддерживает содержимое над областью прокрутки (в порядке z), которая не прокручивается остальной частью содержимого. Система вычисляет все необходимые грязные регионы и завершает ускоренную прокрутку, но отправляет несколько дополнительных растровых изображений по проводу, чтобы переместить непреднамеренную прокручиваемую часть обратно в правильное положение на экране.