BringIntoViewRequestedEventArgs.VerticalAlignmentRatio Eigenschaft

Definition

Namespace:

Windows.UI.Xaml

Ruft das angeforderte vertikale Ausrichtungsverhältnis ab, das die Ausrichtung der horizontalen Achse des TargetRect in Bezug auf die horizontale Achse des Viewports steuert.

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

double VerticalAlignmentRatio();

public double VerticalAlignmentRatio { get; }

var double = bringIntoViewRequestedEventArgs.verticalAlignmentRatio;

Public ReadOnly Property VerticalAlignmentRatio As Double

Eigenschaftswert

Double

double

Das angeforderte vertikale Ausrichtungsverhältnis zwischen 0,0 und 1,0 oder NaN. Siehe Hinweise.

Hinweise

Der Wert NaN gibt an, dass Scrollsteuerelemente das Erforderliche erreichen sollten, um das Element vollständig in die Ansicht zu bringen, die am nächsten Rand des Viewports ausgerichtet ist.

Hinweis

Verwenden Sie den == Operator nicht, um auf NaN zu testen.

Verwenden Sie in C# Double.IsNaN(), um auf NaN zu testen.

Verwenden Sie in C++ isnan(), um auf NaN zu testen.

Wenn der Wert nicht NaN ist, wird der Bereich des möglichen Werts von 0,0 bis 1,0 geklemmt, wobei 0,0 den oberen horizontalen Rand und 1,0 den unteren horizontalen Rand darstellt.

Der Wert 0,0 gibt an, dass TargetRect im Viewport am besten ausgerichtet sein sollte. Der Wert 1,0 gibt an, dass er unten ausgerichtet sein sollte. Der Wert 0,5 gibt an, dass TargetRect vertikal zentriert im Viewport sein sollte.

Von allen Scrollsteuerelementen, die am Anzeigen eines Elements beteiligt sind, wird erwartet, dass sie die Ausrichtungsanforderung so weit wie möglich berücksichtigen. Dieser Wert kann nicht von Ereignishandlern als Ereignisblasen geändert werden. Wenn ein Steuerelement die Anforderung nicht vollständig erfüllen kann, sollte es die angeforderte VerticalOffset-Eigenschaft nicht ändern, während sie sich aufblasen lässt.