FrameworkElement.ActualHeight Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml

Ottiene l'altezza di cui è stato eseguito il rendering di un FrameworkElement. Vedere la sezione Osservazioni.

public:
 property double ActualHeight { double get(); };

double ActualHeight();

public double ActualHeight { get; }

var double = frameworkElement.actualHeight;

Public ReadOnly Property ActualHeight As Double

Valore della proprietà

Double

double

Altezza, in pixel, dell'oggetto . Il valore predefinito è 0. L'impostazione predefinita potrebbe essere rilevata se l'oggetto non è stato caricato e non è ancora stato coinvolto in un passaggio di layout che esegue il rendering dell'interfaccia utente.

Esempio

Questo esempio mostra uno scenario comune in cui si usa ActualHeight di uno o più elementi nell'interfaccia utente per impostare l'altezza di uno degli elementi coinvolti o di un elemento diverso, in modo che la stessa altezza netta venga mantenuta dopo l'azione. Questa operazione viene in genere eseguita in risposta ai gestori eventi richiamati quando gli elementi vengono aperti o chiusi o cambiano l'area di visualizzazione.

void SDKSample::WebViewControl::PageWithAppBar::BottomAppBar_Opened(Object^ sender, Object^ obj)
{
    // AppBar has Opened so we need to put the WebView back to its
    // original size/location.
    AppBar^ bottomAppBar = (AppBar^) sender;
    if (bottomAppBar != nullptr)
    {
        // Force layout so that we can guarantee that our AppBar's
        // actual height has height
        this->UpdateLayout();
        // Get the height of the AppBar
        double appBarHeight = bottomAppBar->ActualHeight;
        // Reduce the height of the WebView to allow for the AppBar
        WebView8->Height = WebView8->ActualHeight - appBarHeight;
        // Translate the WebView in the Y direction to reclaim the space occupied by the AppBar.  
        TranslateYOpen->To = -appBarHeight / 2.0;
        // Run our translate animation to match the AppBar
        OpenAppBar->Begin();
    }
}

void BottomAppBar_Opened(object sender, object e)
{
    // AppBar has Opened so we need to put the WebView back to its
    // original size/location.
    AppBar bottomAppBar = sender as AppBar;
    if (bottomAppBar != null)
    {
        // Force layout so that we can guarantee that our AppBar's
        // actual height has height
        this.UpdateLayout();
        // Get the height of the AppBar
        double appBarHeight = bottomAppBar.ActualHeight;
        // Reduce the height of the WebView to allow for the AppBar
        WebView8.Height = WebView8.ActualHeight - appBarHeight;
        // Translate the WebView in the Y direction to reclaim the space occupied by 
        // the AppBar.  Notice that we translate it by appBarHeight / 2.0.
        // This is because the WebView has VerticalAlignment and HorizontalAlignment
        // of 'Stretch' and when we reduce its size it reduces its overall size
        // from top and bottom by half the amount.
        TranslateYOpen.To = -appBarHeight / 2.0;
        // Run our translate animation to match the AppBar
        OpenAppBar.Begin();
    }
}

Private Sub BottomAppBar_Opened(sender As Object, e As Object)
    ' AppBar has Opened so we need to put the WebView back to its
    ' original size/location.
    Dim bottomAppBar As AppBar = TryCast(sender, AppBar)
    If bottomAppBar IsNot Nothing Then
        ' Force layout so that we can guarantee that our AppBar's
        ' actual height has height
        Me.UpdateLayout()
        ' Get the height of the AppBar
        Dim appBarHeight As Double = bottomAppBar.ActualHeight
        ' Reduce the height of the WebView to allow for the AppBar
        WebView8.Height = WebView8.ActualHeight - appBarHeight
        ' Translate the WebView in the Y direction to reclaim the space occupied by 
        ' the AppBar.  Notice that we translate it by appBarHeight / 2.0.
        ' This is because the WebView has VerticalAlignment and HorizontalAlignment
        ' of 'Stretch' and when we reduce its size it reduces its overall size
        ' from top and bottom by half the amount.
        TranslateYOpen.[To] = -appBarHeight / 2.0
        ' Run our translate animation to match the AppBar
        OpenAppBar.Begin()
    End If
End Sub

Commenti

Nota

Sebbene abbia un campo sottostante ActualHeightProperty , ActualHeight non genera notifiche di modifica delle proprietà e deve essere considerato come una proprietà normale e non una proprietà di dipendenza.

ActualHeight è una proprietà calcolata. I calcoli sono il risultato di un passaggio di layout, in cui l'oggetto viene ridimensionato nel layout in base alla logica degli elementi padre del layout successivi. Per altre info, vedi Definire i layout con XAML.

ActualHeight può avere modifiche segnalate multiple o incrementali al valore a causa delle operazioni eseguite dal sistema di layout. Se si ottiene il valore durante l'iterazione del layout, il sistema di layout potrebbe comunque calcolare la misura necessaria di spazio per gli oggetti figlio, i vincoli dell'oggetto padre e così via. Poiché il valore è basato su un passaggio di rendering effettivo, può essere leggermente indietro rispetto al valore impostato di proprietà come Height, che può essere la base della modifica di input.

Ai fini dell'associazione ElementName , ActualHeight non pubblica gli aggiornamenti quando viene modificato (a causa della natura calcolata asincrona e in fase di esecuzione). Non tentare di usare ActualHeight come origine di associazione per un'associazione ElementName . Se si dispone di uno scenario che richiede aggiornamenti basati su ActualHeight, usare un gestore SizeChanged .

Vedi anche

• ActualWidth
• Height
• <xref:Windows.UI.Xaml.FrameworkElement.SizeChanged%0a(frameworkelement_sizechanged.md)>