Поделиться через


Visual.VisualScrollableAreaClip Свойство

Определение

Получает или задает обрезанную прокручиваемую область для объекта 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)

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

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

Комментарии

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • Clips

    • Произведенный эффект

    • DrawingBrushes

    • VisualBrushes

    • OpacityMasks

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

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

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

Применяется к