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 accelerated свойство, чтобы включить прокрутку при отрисовке в программном обеспечении.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. Это означает, что windows, в какие AllowTransparency == 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

    • DrawingBrushesDrawingBrushes

    • УвеличительныхVisualBrushes

    • OpacityMasksOpacityMasks

    • Непрозрачность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.

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