Visual.VisualScrollableAreaClip Proprietà

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)

Valore della proprietà

Oggetto Rect che rappresenta l'area di ritaglio scorrevole o null se non viene assegnata alcuna area di ritaglio.

Commenti

Impostare la proprietà per abilitare lo VisualScrollableAreaClip scorrimento accelerato durante il rendering nel software. Ciò è utile negli scenari di rendering remoto, ad esempio l'esecuzione su Desktop remoto o l'esecuzione in una macchina virtuale. Impostare questa proprietà sull'elemento padre di cui verranno scorrere gli elementi figlio. L'impostazione della proprietà non ha alcun effetto quando il VisualScrollableAreaClip rendering è accelerato dall'hardware.

La VisualScrollableAreaClip proprietà abilita scenari specifici e avanzati. L'elenco seguente mostra le avvertenze che si applicano quando si usa la VisualScrollableAreaClip proprietà .

• Lo sfondo dell'area a scorrimento deve essere opaco oppure si verificheranno artefatti di scorrimento.

• La VisualScrollableAreaClip proprietà accelera lo scorrimento solo quando WPF esegue il rendering nel software. Ad esempio, questa situazione si verifica quando l'applicazione è in esecuzione su Desktop remoto o in esecuzione in locale in una macchina virtuale.

• Il comportamento di scorrimento rimane invariato durante il rendering nell'hardware. Per evitare differenze nel comportamento di scorrimento, è necessario mantenere la proprietà abilitata sia per l'hardware VisualScrollableAreaClip che per il software.

• La rotazione e l'asimmetria delle trasformazioni disabilitano lo scorrimento accelerato. Le trasformazioni di scala e le traduzioni orizzontali o verticali sopra l'area scorrevole funzionano correttamente e non disabilitano l'accelerazione dello scorrimento.

• La modifica del sottoalbero o l'attivazione di parti dell'area scorrevole per ridisegnare tramite animazione si comportano come previsto, ma perdono il vantaggio dello scorrimento accelerato per l'area ridisegnata. Qualsiasi animazione che invalida l'area di scorrimento durante lo stesso fotogramma in cui lo scorrimento si verifica elimina il vantaggio di questa ottimizzazione.

• Il VisualScrollableAreaClip rettangolo si blocca verso l'interno in pixel. Di conseguenza, le dimensioni ritagliate del rettangolo di scorrimento sono sempre minori o uguali alle dimensioni impostate.

• Gli scostamento si bloccano verso il basso. Ciò significa che la differenza dell'offset mappato precedente e l'offset corrente con snapped è sempre un numero intero di pixel.

• I hit test possono essere disattivati fino a un pixel.

• L'arrotondamento del layout deve essere attivato, perché garantisce che i bordi delle aree scorrevoli e l'area client della finestra limite vengano ritagliati fino ai limiti dei pixel, con conseguente allineamento corretto.

• L'accelerazione dello scorrimento non funziona su finestre a più livelli. Ciò significa le finestre in cui AllowTransparency == true, window.windowstyle == none e così via.

• L'accelerazione dello scorrimento non si verifica durante il rendering a finestra intera.

• L'accelerazione dello scorrimento non funziona quando la finestra si sposta su due monitor.

• L'accelerazione dello scorrimento non funziona in presenza di destinazioni di rendering intermedie nella catena padre dell'elemento scorrevole. L'elenco seguente mostra alcune di queste destinazioni di rendering intermedie.

  • Clip

  • Effetti

  • DrawingBrushes

  • VisualBrushes

  • OpacityMasks

  • Opacità

• Un solo scorrimento accelerato può verificarsi per fotogramma. Possono essere presenti più aree di scorrimento accelerato, ma solo una di esse può eseguire uno scorrimento accelerato durante un fotogramma. L'area a scorrimento è indeterminato.

• L'accelerazione dello scorrimento supporta il contenuto sopra l'area di scorrimento (in ordine z) che non viene eseguito con il resto del contenuto. Il sistema calcola tutte le aree dirty necessarie e completa lo scorrimento accelerato, ma invia diverse bitmap aggiuntive sul filo per spostare la parte involontariamente scorrevole alla posizione corretta sullo schermo.