ScrollViewer.ChangeView 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| 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>
介于 0 和 ScrollableWidth 之间的值，指定应水平滚动内容的距离。
- verticalOffset
-
IReference<double>
介于 0 和 ScrollableHeight 之间的值，该值指定应垂直滚动内容的距离。
- zoomFactor
-
IReference<float>
MinZoomFactor 和 MaxZoomFactor 之间的值，指定所需的目标 ZoomFactor。
返回
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>
介于 0 和 ScrollableWidth 之间的值，指定应水平滚动内容的距离。
- verticalOffset
-
IReference<double>
介于 0 和 ScrollableHeight 之间的值，该值指定应垂直滚动内容的距离。
- zoomFactor
-
IReference<float>
MinZoomFactor 和 MaxZoomFactor 之间的值，指定所需的目标 ZoomFactor。
- disableAnimation
-
Boolean
bool
若要在更改视图时禁用缩放/平移动画，则为 true;否则为 false。 默认值为 false。
返回
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 ，以便使用此方法仅水平滚动、仅垂直滚动或仅更改缩放因子。