BringIntoViewRequestedEventArgs.HorizontalAlignmentRatio プロパティ

定義

名前空間:

Microsoft.UI.Xaml

ビューポートの縦軸に対する の縦軸 TargetRect の配置を制御する、要求された水平方向の配置比率を取得します。

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

double HorizontalAlignmentRatio();

public double HorizontalAlignmentRatio { get; }

var double = bringIntoViewRequestedEventArgs.horizontalAlignmentRatio;

Public ReadOnly Property HorizontalAlignmentRatio As Double

プロパティ値

Double

double

0.0 から 1.0、または NaN の水平方向の配置比率を要求しました。 「解説」を参照してください。

注釈

NaN の値は、スクロール コントロールが、ビューポートの最も近い端に配置された要素を完全にビューに配置するために必要な最小限の処理を行う必要があることを意味します。

Note

演算子を使用して == NaN をテストしないでください。

C# では、 Double.IsNaN() を使用して NaN をテストします。

C++ では、 isnan() を使用して NaN をテストします。

値が NaN でない場合、可能な値の範囲は 0.0 から 1.0 に固定され、0.0 は左の垂直エッジを表し、1.0 は右の垂直エッジを表します。

値 0.0 は、 を TargetRect ビューポート内で左揃えにする必要があることを示します。 値 1.0 は、右揃えにする必要があることを示します。 値 0.5 は、 TargetRect をビューポートの水平方向の中央に配置する必要があることを示します。

要素をビューに取り込むすべてのスクロール コントロールは、可能な限りアラインメント要求を受け入れることが期待されます。 イベント バブルとしてイベント ハンドラーによってこの値を変更することはできません。 コントロールが要求を完全に満たすことができない場合は、要求された HorizontalOffset プロパティを変更しないようにする必要があります。