ScrollViewer.ChangeView 方法

定义

重载

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>

MinZoomFactorMaxZoomFactor 之间的值,指定所需的目标 ZoomFactor

返回

Boolean

bool

如果视图已更改,则为 true;否则为 false

属性

示例

此代码导致名为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)

使 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>

MinZoomFactorMaxZoomFactor 之间的值,指定所需的目标 ZoomFactor

disableAnimation
Boolean

bool

若要在更改视图时禁用缩放/平移动画,则为 true;否则为 false。 默认值为 false

返回

Boolean

bool

如果视图已更改,则为 true;否则为 false

属性

示例

此代码导致名为 myScrollViewerScrollViewer 的滚动到水平偏移量为 2,没有动画。

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

注解

可以将参数值设置为 null ,以便使用此方法仅水平滚动、仅垂直滚动或仅更改缩放因子。

另请参阅

适用于