BringIntoViewRequestedEventArgs.VerticalAlignmentRatio Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 DoubleEigenschaftswert
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.