ScrollViewer.ChangeView 方法

定義

命名空間:

Microsoft.UI.Xaml.Controls

多載

ChangeView(IReference<Double>, IReference<Double>, IReference<Single>)	讓 ScrollViewer 使用指定的位移和縮放因數，將新的檢視載入檢視區。
ChangeView(IReference<Double>, IReference<Double>, IReference<Single>, Boolean)	讓 ScrollViewer 使用指定的位移和縮放因數，將新的檢視載入至檢視區，並選擇性地停用捲動動畫。

ChangeView(IReference<Double>, IReference<Double>, IReference<Single>)

讓 ScrollViewer 使用指定的位移和縮放因數，將新的檢視載入檢視區。

public:
 virtual bool ChangeView(IReference<double> ^ horizontalOffset, IReference<double> ^ verticalOffset, IReference<float> ^ zoomFactor) = ChangeView;

/// [Windows.Foundation.Metadata.Overload("ChangeView")]
bool ChangeView(IReference<double> const& horizontalOffset, IReference<double> const& verticalOffset, IReference<float> const& zoomFactor);

[Windows.Foundation.Metadata.Overload("ChangeView")]
public bool ChangeView(System.Nullable<double> horizontalOffset, System.Nullable<double> verticalOffset, System.Nullable<float> zoomFactor);

function changeView(horizontalOffset, verticalOffset, zoomFactor)

Public Function ChangeView (horizontalOffset As Nullable(Of Double), verticalOffset As Nullable(Of Double), zoomFactor As Nullable(Of Single)) As Boolean

參數

horizontalOffset

IReference<Double>

Nullable<Double>

IReference<double>

介於 0 和 ScrollableWidth 之間的值，指定內容應該水平捲動的距離。

verticalOffset

IReference<Double>

Nullable<Double>

IReference<double>

介於 0 和 ScrollableHeight 之間的值，指定內容應該垂直捲動的距離。

zoomFactor

IReference<Single>

Nullable<Single>

IReference<float>

MinZoomFactor 與 MaxZoomFactor 之間的值，指定必要的目標 ZoomFactor。

傳回

Boolean

bool

如果檢視已變更，則為 true;否則為 false。

屬性

OverloadAttribute

範例

此程式代碼會導致名為 myScrollViewer的 ScrollViewer 卷動至水準位移 2。

bool flag = myScrollViewer.ChangeView(2, null, null); 

bool flag{ myScrollViewer.ChangeView(Windows::Foundation::IReference<double>{2.f}, nullptr, nullptr) };

備註

您可以將參數值設定為 null ，以使用此方法只水準、僅垂直捲動，或只變更縮放因數。

另請參閱

• ChangeView(IReference<Double>, IReference<Double>, IReference<Single>, Boolean)

ChangeView(IReference<Double>, IReference<Double>, IReference<Single>, Boolean)

讓 ScrollViewer 使用指定的位移和縮放因數，將新的檢視載入至檢視區，並選擇性地停用捲動動畫。

public:
 virtual bool ChangeView(IReference<double> ^ horizontalOffset, IReference<double> ^ verticalOffset, IReference<float> ^ zoomFactor, bool disableAnimation) = ChangeView;

/// [Windows.Foundation.Metadata.Overload("ChangeViewWithOptionalAnimation")]
bool ChangeView(IReference<double> const& horizontalOffset, IReference<double> const& verticalOffset, IReference<float> const& zoomFactor, bool const& disableAnimation);

[Windows.Foundation.Metadata.Overload("ChangeViewWithOptionalAnimation")]
public bool ChangeView(System.Nullable<double> horizontalOffset, System.Nullable<double> verticalOffset, System.Nullable<float> zoomFactor, bool disableAnimation);

function changeView(horizontalOffset, verticalOffset, zoomFactor, disableAnimation)

Public Function ChangeView (horizontalOffset As Nullable(Of Double), verticalOffset As Nullable(Of Double), zoomFactor As Nullable(Of Single), disableAnimation As Boolean) As Boolean

參數

horizontalOffset

IReference<Double>

Nullable<Double>

IReference<double>

介於 0 和 ScrollableWidth 之間的值，指定內容應該水平捲動的距離。

verticalOffset

IReference<Double>

Nullable<Double>

IReference<double>

介於 0 和 ScrollableHeight 之間的值，指定內容應該垂直捲動的距離。

zoomFactor

IReference<Single>

Nullable<Single>

IReference<float>

MinZoomFactor 與 MaxZoomFactor 之間的值，指定必要的目標 ZoomFactor。

disableAnimation

Boolean

bool

true 表示在變更檢視時停用縮放/移動瀏覽動畫;否則為 false。 預設值為 false。

傳回

Boolean

bool

如果檢視已變更，則為 true;否則為 false。

屬性

OverloadAttribute

範例

此程式代碼會導致名為 myScrollViewer的 ScrollViewer 卷動至 2 的水準位移，而沒有動畫。

bool flag = myScrollViewer.ChangeView(2, null, null, true); 

bool flag{ myScrollViewer.ChangeView(Windows::Foundation::IReference<double>{2.f}, nullptr, nullptr, true) };

備註

您可以將參數值設定為 null ，以使用此方法只水準、僅垂直捲動，或只變更縮放因數。

另請參閱

• ChangeView(IReference<Double>, IReference<Double>, IReference<Single>)