BringIntoViewRequestedEventArgs.HorizontalAlignmentRatio Eigenschaft

Definition

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

public:
 property double HorizontalAlignmentRatio { double get(); };
double HorizontalAlignmentRatio();
public double HorizontalAlignmentRatio { get; }
var double = bringIntoViewRequestedEventArgs.horizontalAlignmentRatio;
Public ReadOnly Property HorizontalAlignmentRatio As Double

Eigenschaftswert

Double

double

Das angeforderte horizontale 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 linken vertikalen Rand und 1,0 den rechten vertikalen Rand darstellt.

Der Wert 0,0 gibt an, dass TargetRect im Viewport linksbündig sein sollte. Der Wert 1,0 gibt an, dass er rechtsbündig sein sollte. Der Wert 0,5 gibt an, dass TargetRect horizontal 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 HorizontalOffset-Eigenschaft nicht ändern, während sie sich aufblasen lässt.

Gilt für: