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。
- 屬性
範例
此程式代碼會導致名為 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 ,以使用此方法只水準、僅垂直捲動,或只變更縮放因數。