Visual.VisualScrollableAreaClip Proprietà

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

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

Valore della proprietà

Nullable<Rect>

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

Commenti

Impostare la proprietà per abilitare lo scorrimento accelerato durante il VisualScrollableAreaClip 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 i cui elementi figlio verranno scorrevoli. L'impostazione della proprietà non ha alcun effetto quando il rendering è accelerato dall'hardware VisualScrollableAreaClip .

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

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

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

• Il comportamento di scorrimento è invariato durante il rendering nell'hardware. Per evitare differenze nel comportamento di scorrimento, è consigliabile mantenere la VisualScrollableAreaClip proprietà abilitata per hardware e software.

• Ruotare e asimnciare le trasformazioni disabilitano lo scorrimento accelerato. Ridimensionare le trasformazioni e le traduzioni orizzontali o verticali sopra l'area scorrevole funzionano correttamente e non disabilitare l'accelerazione di scorrimento.

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

• Il rettangolo si blocca verso l'interno VisualScrollableAreaClip dei pixel. Pertanto, le dimensioni ritagliate del rettangolo di scorrimento sono sempre inferiori o uguali alle dimensioni impostate.

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

• I test di hit 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 ai limiti dei pixel, determinando l'allineamento corretto.

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

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

• L'accelerazione di scorrimento non funziona quando la finestra si sposta tra due monitor.

• L'accelerazione di 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à

• Uno scorrimento accelerato può verificarsi per fotogramma. Esistono più aree di scorrimento accelerate, ma solo una di esse può eseguire uno scorrimento accelerato durante un frame. L'area di scorrimento è indeterminato.

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