FrameworkElement.EffectiveViewportChanged Evento

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Si verifica quando cambia il viewport effettivo di FrameworkElement.

// Register
event_token EffectiveViewportChanged(TypedEventHandler<FrameworkElement, EffectiveViewportChangedEventArgs const&> const& handler) const;

// Revoke with event_token
void EffectiveViewportChanged(event_token const* cookie) const;

// Revoke with event_revoker
FrameworkElement::EffectiveViewportChanged_revoker EffectiveViewportChanged(auto_revoke_t, TypedEventHandler<FrameworkElement, EffectiveViewportChangedEventArgs const&> const& handler) const;

public event TypedEventHandler<FrameworkElement,EffectiveViewportChangedEventArgs> EffectiveViewportChanged;

function onEffectiveViewportChanged(eventArgs) { /* Your code */ }
frameworkElement.addEventListener("effectiveviewportchanged", onEffectiveViewportChanged);
frameworkElement.removeEventListener("effectiveviewportchanged", onEffectiveViewportChanged);
- or -
frameworkElement.oneffectiveviewportchanged = onEffectiveViewportChanged;

Public Custom Event EffectiveViewportChanged As TypedEventHandler(Of FrameworkElement, EffectiveViewportChangedEventArgs) 

Tipo evento

TypedEventHandler<FrameworkElement,EffectiveViewportChangedEventArgs>

Commenti

Un controllo di scorrimento consente all'utente di eseguire la panoramica/scorrimento del contenuto che occupa più spazio rispetto a quanto disponibile nell'interfaccia utente. La parte del contenuto visualizzata dall'utente viene chiamata viewport.

L'evento EffectiveViewportChanged fornisce più informazioni:

1. Effettivo EffectiveViewport
2. Calcolo per MaxViewport
3. Valori scalari per BringIntoViewDistanceX e BringIntoViewDistanceY

EffectiveViewport

EffectiveViewport è l'intersezione di tutti i viewport noti che contengono FrameworkElement nel relativo sottoalbero. Se sono presenti due o più viewport (ad esempio, un controllo ScrollViewer annidato in un altro ScrollViewer) che non si sovrappongono, EffectiveViewport è un rect vuoto.

Nota

Affinché il riquadro di visualizzazione di un controllo di scorrimento sia noto al framework, il controllo deve averla registrata in precedenza usando il metodo UIElement.RegisterAsScrollPort . Il framework usa il clip dell'elemento registrato quando si determina il viewport effettivo.

Quando il riquadro di visualizzazione del controllo di scorrimento cambia, è necessario richiamarne il metodo InvalidateViewport per informare il framework che il relativo riquadro di visualizzazione è stato modificato e che uno dei relativi sottoelementi in ascolto del viewport effettivo deve ricevere una notifica delle modifiche.

EffectiveViewport viene specificato nello spazio delle coordinate di FrameworkElement. Non è necessario eseguire transformToVisual con il riquadro di visualizzazione Rect.

In uno scenario semplice in cui è presente un controllo ScrollViewer che contiene un singolo elemento, l'evento EffectiveViewportChanged fornisce aggiornamenti del riquadro di visualizzazione simili all'evento ViewChanged . La differenza principale è che l'evento EffectiveViewportChanged viene generato dopo il passaggio di disposizione del layout.

Ad esempio, questo ...

<ScrollViewer>
    <Grid Height="4000" Width="4000"
          EffectiveViewportChanged="Grid_EffectiveViewportChanged"/>
</ScrollViewer>

... fornisce informazioni simili al riquadro di visualizzazione in questo modo...

<ScrollViewer ViewChanged="ScrollViewer_ViewChanged">
    <Grid Height="4000" Width="4000"/>
</ScrollViewer>

MaxViewport

MaxViewport è simile a EffectiveViewport, ma invece di rappresentare una semplice intersezione dei viewport noti, rappresenta l'intersezione dei viewport come se ognuno fosse stato portato in visualizzazione di qualsiasi viewport esterno. Il rect risultante rappresenta due elementi:

1. le dimensioni maggiori che effectiveViewport può essere (date le dimensioni correnti del riquadro di visualizzazione) e
2. posizione del viewport effettivo massimo rispetto a FrameworkElement.

Queste informazioni possono essere usate per misurare la posizione e la quantità di contenuto che FrameworkElement deve generare in precedenza per riempire potenzialmente il riquadro di visualizzazione prima che venga eseguito lo scorrimento nella visualizzazione.

Nota

Lo scorrimento tramite input diretto, ad esempio tocco o penna, viene gestito dal sistema in un processo separato. Per impostazione predefinita, lo scorrimento viene gestito in modo asincrono al thread dell'interfaccia utente. I controlli che eseguono la virtualizzazione potrebbero dover generare in anticipo il contenuto prima di immettere il riquadro di visualizzazione a causa del costo intrinseco della creazione di elementi.

Il ritardo di tutta la preparazione del contenuto fino a quando non viene visualizzata può causare una scarsa esperienza di scorrimento per gli utenti. Gli utenti possono visualizzare spazi vuoti o stub, entrambi i sintomi del thread dell'interfaccia utente non sono in grado di rimanere al passo con la velocità di panoramica.

La posizione di MaxViewport viene segnalata nello spazio delle coordinate di FrameworkElement. Se MaxViewport è stato trasformato nello spazio delle coordinate del primo viewport nella catena di predecessori di FrameworkElement, il Rect si troverebbe entro i limiti del primo viewport.

BringIntoViewDistanceX e Y

Questi valori indicano la chiusura di FrameworkElement per diventare visibile al massimo in tutti i relativi viewport.

Se il valore è maggiore di zero, ma minore di ActualWidth / ActualHeight , l'elemento è parzialmente all'interno del viewport visibile dall'utente. Quando i valori sono zero, FrameworkElement è completamente all'interno del riquadro di visualizzazione visibile all'utente.

Suggerimento

Ciò non garantisce che l'elemento sia visibile all'utente perché altri elementi con un ordine Z più elevato potrebbero comunque essere occlusi a FrameworkElement.

Indicati più formalmente, questi valori sono la somma della distanza assoluta che frameworkElement verrebbe tradotta quando soddisfa una chiamata a StartBringIntoView. I valori non fanno riferimento alla possibilità che uno scorrimento di un controllo di scorrimento sia disabilitato.

<ListView x:Name="lv">
    <ListView.ItemTemplate>
        <DataTemplate x:DataType="x:String">
            <UserControl Tag="{x:Bind}"
                         EffectiveViewportChanged="Item_EffectiveViewportChanged"/>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

private void Item_EffectiveViewportChanged(FrameworkElement sender, EffectiveViewportChangedEventArgs args)
{
    // If we wanted to know if a list item (w/ vertical scrolling only) is partially within the viewport
    // then we can just check the BringIntoViewDistanceY of the event args.  If the distance is 0 then the item is fully within
    // the effective viewport.  If the BringIntoViewDistanceY is less than the sender's ActualHeight, then its
    // partially within the effective viewport.
    // The EffectiveViewport rect is relative to the sender, so we can use it to know where the element is within the viewport.  
    // NOTE: "Within the viewport" != visible to the user's eye, since another element may overlap and obscure it.
    if (args.BringIntoViewDistanceY < sender.ActualHeight)
    {
        Debug.WriteLine($"Item: {sender.Tag} has {sender.ActualHeight - args.BringIntoViewDistanceY} pixels within the viewport");
    }
    else
    {
        Debug.WriteLine($"Item: {sender.Tag} has {args.BringIntoViewDistanceY - sender.ActualHeight} pixels to go before it is even partially visible");
    }

    // Consider disconnecting from the effective viewport when not needed.  Otherwise, it is called on every viewport change.
    //lv.EffectiveViewportChanged -= Item_EffectiveViewportChanged;
}

Comportamento

• Se il viewport effettivo di un elemento padre e figlio cambiano entrambi, l'elemento padre riceverà la notifica prima dell'elemento figlio.
• L'evento viene generato solo per gli elementi dell'albero dell'interfaccia utente che partecipano al layout. Ad esempio, se l'elemento non si trova nell'albero attivo o se la proprietà Visibility dell'elemento o di uno dei relativi predecessori è impostata su Collapsed, questo evento non verrà generato.
• Anche se il riquadro di visualizzazione effettivo tiene conto delle trasformazioni di rendering per tutti gli elementi predecessori, non considera gli effetti del ritaglio (oltre alla clip dell'elemento registrato da un controllo di scorrimento come riquadro di visualizzazione).
• Il riquadro di visualizzazione effettivo non tiene conto dell'occlusione a causa di altri elementi con un ordine Z superiore.

Vedi anche

• InvalidateViewport()
• UIElement.RegisterAsScrollPort