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

Definizione

Ottiene o imposta un'area scorrevole ritagliata per l'oggetto 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)

Valore della proprietà

Oggetto Rect che rappresenta l'area di ritaglio scorrevole o null se non viene assegnata un'area di ritaglio.A Rect that represents the scrollable clipping area, or null if no clipping area is assigned.

Commenti

Impostare la VisualScrollableAreaClip proprietà per abilitare lo scorrimento accelerato durante il rendering nel software.Set the VisualScrollableAreaClip property to enable accelerated scrolling when rendering in software. Questa operazione è utile negli scenari di rendering remoto, ad esempio in esecuzione su Desktop remoto o in esecuzione in una macchina virtuale.This is useful in remote rendering scenarios, such as running over Remote Desktop or running in a virtual machine. Impostare questa proprietà sull'elemento padre i cui elementi figlio verranno sottoposti a scorrimento.Set this property on the parent element whose children will be scrolled. L'impostazione VisualScrollableAreaClip della proprietà non ha alcun effetto quando il rendering viene accelerato dall'hardware.Setting the VisualScrollableAreaClip property has no effect when rendering is hardware accelerated.

La VisualScrollableAreaClip proprietà Abilita scenari specifici e avanzati.The VisualScrollableAreaClip property enables specific, advanced scenarios. Nell'elenco seguente vengono illustrate le avvertenze che si applicano quando VisualScrollableAreaClip si utilizza la proprietà.The following list shows the caveats that apply when you use the VisualScrollableAreaClip property.

  • Lo sfondo dell'area a scorrimento deve essere opaco oppure si verificheranno elementi di scorrimento.The background of the scrolled area must be opaque, or scrolling artifacts will occur.

  • La VisualScrollableAreaClip proprietà accelera lo scorrimento solo quando viene eseguito il rendering di WPF nel software.The VisualScrollableAreaClip property accelerates scrolling only when WPF is rendering in software. Questa situazione si verifica ad esempio quando l'applicazione viene eseguita su Desktop remoto o in esecuzione localmente in una macchina virtuale.For example, this situation occurs when the application is running over Remote Desktop or running locally in a virtual machine.

  • Quando si esegue il rendering nell'hardware, il comportamento di scorrimento è invariato.The scrolling behavior is unchanged when rendering in hardware. Per evitare differenze nel comportamento di scorrimento, è necessario che la VisualScrollableAreaClip proprietà sia abilitata sia per l'hardware che per il software.To prevent differences in scrolling behavior, you should keep the VisualScrollableAreaClip property enabled for both hardware and software.

  • Le trasformazioni di rotazione e asimmetria disabilitano lo scorrimento accelerato.Rotate and skew transforms disable accelerated scrolling. Le trasformazioni di ridimensionamento e le conversioni orizzontali o verticali sopra l'area di scorrimento funzionano correttamente e non disabilitano l'accelerazione dello scorrimento.Scale transforms and horizontal or vertical translations above the scrolled region work correctly and do not disable scrolling acceleration.

  • La modifica del sottoalbero o l'attivazione di parti dell'area di scorrimento da ricreare tramite animazioni si comportano come previsto, ma si perde il vantaggio dello scorrimento accelerato per l'area ridisegnato.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. Qualsiasi animazione che invalida l'area di scorrimento durante lo stesso frame in cui si verifica lo scorrimento elimina il vantaggio di questa ottimizzazione.Any animation that invalidates the scrolled area during the same frame in which scrolling occurs eliminates the benefit of this optimization.

  • Il VisualScrollableAreaClip rettangolo viene agganciato internamente ai pixel.The VisualScrollableAreaClip rectangle snaps inward to pixels. Pertanto, la dimensione bloccata del rettangolo di scorrimento è sempre minore o uguale alla dimensione impostata.Therefore, the snapped size of the scrolling rectangle is always less than or equal to the size you have set.

  • Allinea a discesa gli offset.Offsets snap downward. Ciò significa che la differenza tra l'offset blocco precedente e l'offset blocco corrente è sempre un numero intero di pixel.This means that the difference of the previous snapped offset and current snapped offset is always an integer number of pixels.

  • Gli hit test possono essere disattivati fino a un pixel.Hit tests can be off by up to a pixel.

  • L'arrotondamento del layout deve essere attivato, perché assicura che i bordi delle aree scorrevoli e l'area client della finestra limite siano bloccati ai limiti dei pixel, ottenendo un corretto allineamento.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.

  • L'accelerazione dello scorrimento non funziona nelle finestre sovrapposte.Scrolling acceleration does not work on layered windows. Ovvero Windows in cui AllowTransparency = = true, Window. WindowStyle = = None e così via.This means windows in which AllowTransparency == true, window.windowstyle == none, and so on.

  • L'accelerazione dello scorrimento non si verifica durante il rendering della finestra completa.Scrolling acceleration does not occur during full-window rendering.

  • Lo scorrimento dell'accelerazione non funziona quando la finestra si sposta su due monitor.Scrolling acceleration does not work when the window straddles two monitors.

  • L'accelerazione dello scorrimento non funziona in presenza di destinazioni di rendering intermedie nella catena padre dell'elemento a scorrimento.Scrolling acceleration does not work in the presence of intermediate render targets in the parent chain of the scrolled element. Nell'elenco seguente vengono illustrate alcune di queste destinazioni di rendering intermedie.The following list shows some of these intermediate render targets.

    • ClipClips

    • EffettiEffects

    • DrawingBrushesDrawingBrushes

    • VisualBrushesVisualBrushes

    • OpacityMasksOpacityMasks

    • OpacitàOpacity

  • Può verificarsi un solo scorrimento accelerato per fotogramma.Only one accelerated scroll can happen per frame. Possono essere presenti più aree di scorrimento accelerate, ma solo una di esse può eseguire uno scorrimento accelerato durante un frame.There can be multiple accelerated scroll areas, but only one of them can perform an accelerated scroll during a frame. L'area di cui è stato eseguito lo scorrimento è indeterminata.Which area is scrolled is indeterminate.

  • L'accelerazione a scorrimento supporta il contenuto sopra l'area di scorrimento (in ordine z) che non viene visualizzato con il resto del contenuto.Scrolling acceleration supports content above the scrolling region (in z-order) that is not scrolled with the rest of the content. Il sistema calcola tutte le aree dirty necessarie e completa lo scorrimento accelerato, ma invia diverse bitmap aggiuntive sulla rete per spostare la parte involontariamente spostata nella posizione corretta sullo schermo.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.

Si applica a