Visual.VisualScrollableAreaClip Visual.VisualScrollableAreaClip Visual.VisualScrollableAreaClip Visual.VisualScrollableAreaClip Property

Определение

Получает или задает обрезанную прокручиваемую область для объекта Visual.Gets or sets a clipped scrollable area for the Visual.

public:  property Nullable<System::Windows::Rect> VisualScrollableAreaClip {  protected public:
Nullable<System::Windows::Rect> get(); protected:
 void set(Nullable<System::Windows::Rect> value); };
public Nullable<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, если обрезанная область не задана.A Rect that represents the scrollable clipping area, or null if no clipping area is assigned.

Комментарии

VisualScrollableAreaClip Задайте свойство, чтобы включить ускоренную прокрутку при отрисовке в программном обеспечении.Set the VisualScrollableAreaClip property to enable accelerated scrolling when rendering in software. Это полезно в сценариях удаленной подготовки к просмотру, таких как работа с удаленный рабочий стол или выполнение на виртуальной машине.This is useful in remote rendering scenarios, such as running over Remote Desktop or running in a virtual machine. Задайте это свойство для родительского элемента, чьи дочерние элементы будут прокручиваться.Set this property on the parent element whose children will be scrolled. Установка свойства VisualScrollableAreaClip не влияет на аппаратный ускоренный рендеринг.Setting the VisualScrollableAreaClip property has no effect when rendering is hardware accelerated.

VisualScrollableAreaClip Свойство включает конкретные сложные сценарии.The VisualScrollableAreaClip property enables specific, advanced scenarios. В следующем списке приведены предостережения, применяемые при использовании VisualScrollableAreaClip свойства.The following list shows the caveats that apply when you use the VisualScrollableAreaClip property.

  • Фон области прокрутки должен быть непрозрачным или выполняться прокрутка артефактов.The background of the scrolled area must be opaque, or scrolling artifacts will occur.

  • VisualScrollableAreaClip Свойство ускоряет прокрутку только при отрисовке WPF в программном обеспечении.The VisualScrollableAreaClip property accelerates scrolling only when WPF is rendering in software. Например, такая ситуация возникает, когда приложение выполняется с удаленный рабочий стол или выполняется локально на виртуальной машине.For example, this situation occurs when the application is running over Remote Desktop or running locally in a virtual machine.

  • При отрисовке в оборудовании режим прокрутки не изменяется.The scrolling behavior is unchanged when rendering in hardware. Чтобы предотвратить различия в поведении полосы прокрутки, VisualScrollableAreaClip свойство должно быть включено как для оборудования, так и для программного обеспечения.To prevent differences in scrolling behavior, you should keep the VisualScrollableAreaClip property enabled for both hardware and software.

  • Преобразования «вращение» и «наклон» отключают ускоренную прокрутку.Rotate and skew transforms disable accelerated scrolling. Преобразования масштабирования, горизонтальные или вертикальные переводы выше области прокрутки работают правильно и не отключают ускорение прокрутки.Scale transforms and horizontal or vertical translations above the scrolled region work correctly and do not disable scrolling acceleration.

  • Изменение поддерева или запуск частей прокручиваемой области для перерисовки с помощью анимации ведет себя так, как ожидалось, но при этом теряется преимущество ускоренной прокрутки для перерисованной области.Changing the subtree or triggering parts of the scrollable area to redraw via animation behave as expected, but lose the benefit of accelerated scrolling for the redrawn area. Любая анимация, которая делает область прокрутки недействительной во время выполнения прокрутки, исключает преимущества этой оптимизации.Any animation that invalidates the scrolled area during the same frame in which scrolling occurs eliminates the benefit of this optimization.

  • VisualScrollableAreaClip Прямоугольник привязывается к пикселям.The VisualScrollableAreaClip rectangle snaps inward to pixels. Следовательно, размер привязанного прямоугольника прокрутки всегда меньше или равен размеру, заданному.Therefore, the snapped size of the scrolling rectangle is always less than or equal to the size you have set.

  • Смещение привязывается вниз.Offsets snap downward. Это означает, что разница между предыдущим и текущим привязанным смещением всегда является целым числом пикселей.This means that the difference of the previous snapped offset and current snapped offset is always an integer number of pixels.

  • Проверка попадания может быть отключена до пикселя.Hit tests can be off by up to a pixel.

  • Округление макета должно быть включено, так как это гарантирует, что края прокручиваемых областей и клиентской области окна границ будут привязаны к границам пикселей, что приведет к правильному выравниванию.Layout rounding should be turned on, because it ensures that the edges of scrollable areas and the boundary window client area are snapped to pixel boundaries, resulting in correct alignment.

  • Ускорение прокрутки не работает для многоуровневых окон.Scrolling acceleration does not work on layered windows. Это означает, что окна, в которых Алловтранспаренци = = true, Window. WindowStyle = = None и т. д.This means windows in which AllowTransparency == true, window.windowstyle == none, and so on.

  • Ускорение прокрутки не происходит во время отрисовки в полноэкранном режиме.Scrolling acceleration does not occur during full-window rendering.

  • Ускорение прокрутки не работает, если окно находится на двух мониторах.Scrolling acceleration does not work when the window straddles two monitors.

  • Ускорение прокрутки не работает при наличии промежуточных целевых объектов отрисовки в родительской цепочке прокручиваемого элемента.Scrolling acceleration does not work in the presence of intermediate render targets in the parent chain of the scrolled element. В следующем списке показаны некоторые из этих промежуточных целевых объектов рендеринга.The following list shows some of these intermediate render targets.

    • ГолосClips

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

    • дравингбрушесDrawingBrushes

    • висуалбрушесVisualBrushes

    • опаЦитимасксOpacityMasks

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

  • В кадре может выполняться только одна Ускоренная прокрутка.Only one accelerated scroll can happen per frame. Можно использовать несколько областей ускоренной прокрутки, но только один из них может выполнять ускоренную прокрутку во время кадра.There can be multiple accelerated scroll areas, but only one of them can perform an accelerated scroll during a frame. Область с прокруткой является неопределенной.Which area is scrolled is indeterminate.

  • Ускорение прокрутки поддерживает содержимое над областью прокрутки (в z-порядке), которое не прокручивается с остальной частью содержимого.Scrolling acceleration supports content above the scrolling region (in z-order) that is not scrolled with the rest of the content. Система вычисляет все необходимые «грязные» регионы и завершает ускоренную прокрутку, но отправляет несколько дополнительных точечных рисунков по каналу передачи, чтобы случайно переместить непреднамеренно прокрутку в нужную положение на экране.The system calculates all necessary dirty regions and completes the accelerated scroll, but it sends several additional bitmaps over the wire to move the unintentionally scrolled portion back to its correct position on screen.

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