ScrollView 類別

定義

如果其內容需要,能夠捲動的項目。

[Xamarin.Forms.ContentProperty("Content")]
[Xamarin.Forms.RenderWith(typeof(Xamarin.Forms.Platform._ScrollViewRenderer))]
public class ScrollView : Xamarin.Forms.Layout, Xamarin.Forms.IElementConfiguration<Xamarin.Forms.ScrollView>, Xamarin.Forms.IScrollViewController
type ScrollView = class
    inherit Layout
    interface IScrollViewController
    interface ILayoutController
    interface IElementConfiguration<ScrollView>
繼承
屬性
實作

備註

下列範例示範如何建立具有大型 StackLayout 的 ScrollView。

var stack = new StackLayout();

for (int i = 0; i < 100; i++)
{
    stack.Children.Add(new Button { Text = "Button " + i });
}

MainPage = new ContentPage
{
    Content = new ScrollView { Content = stack }
};

建構函式

ScrollView()

初始化 ScrollView 類別的新執行個體。

欄位

ContentSizeProperty

識別 ContentSize 可繫結屬性。

HorizontalScrollBarVisibilityProperty

HorizontalScrollBarVisibility 屬性的備份存放區。

OrientationProperty

識別 Orientation 可繫結屬性。

ScrollXProperty

ScrollX 屬性的備份存放區。

ScrollYProperty

ScrollY 屬性的備份存放區。

VerticalScrollBarVisibilityProperty

VerticalScrollBarVisibility 屬性的備份存放區。

屬性

AnchorX

取得或設定任何轉換內中心點的 X 元件 (相對於項目界限)。 這是可繫結屬性。

(繼承來源 VisualElement)
AnchorY

取得或設定任何轉換內中心點的 Y 元件 (相對於項目界限)。 這是可繫結屬性。

(繼承來源 VisualElement)
AutomationId

取得或設定值,允許自動化架構尋找此項目並與之互動。

(繼承來源 Element)
Background

如果其內容需要,能夠捲動的項目。

(繼承來源 VisualElement)
BackgroundColor

取得或設定將會填滿 VisualElement 背景的色彩。 這是可繫結屬性。

(繼承來源 VisualElement)
Batched

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
Behaviors

取得與此元素關聯的行為清單。 這是可繫結屬性。

(繼承來源 VisualElement)
BindingContext

取得或設定物件,這個物件包含屬於此 BindableObject 屬性繫結屬性將設為目標的屬性。

(繼承來源 BindableObject)
Bounds

取得項目的界限。

(繼承來源 VisualElement)
CascadeInputTransparent

取得或設定值,這個值控制子項目在透明度為 true 時,是否繼承 this 配置的輸入透明度。

(繼承來源 Layout)
Children

供 Xamarin.Forms 平台內部使用。

(繼承來源 Layout)
class

如果其內容需要,能夠捲動的項目。

(繼承來源 NavigableElement)
ClassId

取得或設定值,用來識別語意類似項目的集合。

(繼承來源 Element)
Clip

如果其內容需要,能夠捲動的項目。

(繼承來源 VisualElement)
Content

取得或設定顯示於 ScrollView 中的 View

ContentSize

取得內容的大小。 這是可繫結屬性。

DisableLayout

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
Dispatcher

如果其內容需要,能夠捲動的項目。

(繼承來源 BindableObject)
EffectControlProvider

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
Effects

套用至此項目的效果清單。

(繼承來源 Element)
FlowDirection

取得或設定配置流程方向。

(繼承來源 VisualElement)
GestureController

取得檢視的軌跡控制器。

(繼承來源 View)
GestureRecognizers

與此檢視建立關聯的筆勢辨識器集合。

(繼承來源 View)
Height

取得此項目的目前呈現高度。 這是唯讀的可繫結屬性。

(繼承來源 VisualElement)
HeightRequest

取得或設定此項目所需的高度覆寫項。

(繼承來源 VisualElement)
HorizontalOptions

取得或設定 LayoutOptions,定義如何在配置循環配置項目。 這是可繫結屬性。

(繼承來源 View)
HorizontalScrollBarVisibility

取得或設定值,該值控制水平捲軸是否為可見。

Id

取得值,可用來在應用程式執行期間唯一識別項目。

(繼承來源 Element)
InputTransparent

取得或設定值,這個值指出是否應該在使用者互動週期中包含此項目。 這是可繫結屬性。

(繼承來源 VisualElement)
IsClippedToBounds

取得或設定值,這個值決定 Layout 是否應該將其子系裁剪到其界限。

(繼承來源 Layout)
IsEnabled

取得或設定值,這個值指出使用者介面中是否已啟用此項目。 這是可繫結屬性。

(繼承來源 VisualElement)
IsFocused

取得值,這個值指出此項目目前是否為焦點。 這是可繫結屬性。

(繼承來源 VisualElement)
IsInNativeLayout

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsNativeStateConsistent

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsPlatformEnabled

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsTabStop

取得或設定值,這個值表示此元素是否包含於索引標籤巡覽。 這是可繫結屬性。

(繼承來源 VisualElement)
IsVisible

取得或設定值,這個值會決定此項目是否應成為視覺化樹狀結構的一部分。 這是可繫結屬性。

(繼承來源 VisualElement)
LayoutAreaOverride

如果其內容需要,能夠捲動的項目。

LogicalChildren

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
Margin

取得或設定檢視的邊界。

(繼承來源 View)
MinimumHeightRequest

取得或設定值,這個值會覆寫項目在配置期間要求的最小高度。

(繼承來源 VisualElement)
MinimumWidthRequest

取得或設定值,這個值會覆寫項目在配置期間要求的最小寬度。

(繼承來源 VisualElement)
Navigation

如果其內容需要,能夠捲動的項目。

(繼承來源 NavigableElement)
NavigationProxy

如果其內容需要,能夠捲動的項目。

(繼承來源 NavigableElement)
Opacity

取得或設定套用至項目 (呈現時) 的不透明度值。 這是可繫結屬性。

(繼承來源 VisualElement)
Orientation

取得或設定 ScrollView 的捲動方向。 這是可繫結屬性。

Padding

取得或設定 Layout 的內部填補。

(繼承來源 Layout)
Parent

取得或設定項目的父項目。

(繼承來源 Element)
ParentView
已過時。

取得即此項目最接近上階的項目,而此項目是 VisualElement

(繼承來源 Element)
Platform
已過時。

如果其內容需要,能夠捲動的項目。

(繼承來源 Element)
RealParent

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
Resources

取得或設定本機資源字典。

(繼承來源 VisualElement)
Rotation

取得或設定呈現元素時繞著 Z 軸 (仿射旋轉) 的旋轉 (度)。

(繼承來源 VisualElement)
RotationX

取得或設定呈現元素時繞著 X 軸 (透視旋轉) 的旋轉 (度)。

(繼承來源 VisualElement)
RotationY

取得或設定呈現元素時繞著 Y 軸 (透視旋轉) 的旋轉 (度)。

(繼承來源 VisualElement)
Scale

取得或設定套用至項目的縮放比例。

(繼承來源 VisualElement)
ScaleX

取得或設定要套用至 X 方向的小數位數值。

(繼承來源 VisualElement)
ScaleY

取得或設定要套用至 Y 方向的小數位數值。

(繼承來源 VisualElement)
ScrollX

取得目前的 X 捲動位置。

ScrollY

取得目前的 Y 捲動位置。

Style

如果其內容需要,能夠捲動的項目。

(繼承來源 NavigableElement)
StyleClass

如果其內容需要,能夠捲動的項目。

(繼承來源 NavigableElement)
StyleId

取得或設定使用者定義值來唯一識別項目。

(繼承來源 Element)
TabIndex

如果其內容需要,能夠捲動的項目。

(繼承來源 VisualElement)
TranslationX

取得或設定項目的 X 轉譯差異。

(繼承來源 VisualElement)
TranslationY

取得或設定項目的 Y 轉譯差異。

(繼承來源 VisualElement)
Triggers

取得與此項目建立關聯的觸發程序清單。 這是可繫結屬性。

(繼承來源 VisualElement)
VerticalOptions

取得或設定 LayoutOptions,定義如何在配置循環配置項目。 這是可繫結屬性。

(繼承來源 View)
VerticalScrollBarVisibility

取得或設定值,該值控制垂直捲軸是否為可見。

Visual

如果其內容需要,能夠捲動的項目。

(繼承來源 VisualElement)
Width

取得此項目的目前呈現寬度。 這是唯讀的可繫結屬性。

(繼承來源 VisualElement)
WidthRequest

取得或設定此項目所需的寬度覆寫項。

(繼承來源 VisualElement)
X

取得此項目的目前 X 位置。 這是唯讀的可繫結屬性。

(繼承來源 VisualElement)
Y

取得此項目的目前 Y 位置。 這是唯讀的可繫結屬性。

(繼承來源 VisualElement)

方法

ApplyBindings()

將繫結套用至 BindingContext

(繼承來源 BindableObject)
BatchBegin()

表示項目屬性變更批次的開始。

(繼承來源 VisualElement)
BatchCommit()

表示項目命令批次的結束,而且現在應該已認可這些命令。

(繼承來源 VisualElement)
ChangeVisualState()

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
ClearValue(BindableProperty)

清除 SetValue 針對 property 所設定的任何值。

(繼承來源 BindableObject)
ClearValue(BindablePropertyKey)

清除 SetValue 針對 propertyKey 所識別屬性設定的任何值。

(繼承來源 BindableObject)
CoerceValue(BindableProperty)

如果其內容需要,能夠捲動的項目。

(繼承來源 BindableObject)
CoerceValue(BindablePropertyKey)

如果其內容需要,能夠捲動的項目。

(繼承來源 BindableObject)
Descendants()

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
EffectIsAttached(String)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
FindByName(String)

傳回具有指定名稱的元素。

(繼承來源 Element)
Focus()

嘗試將焦點設定至此項目。

(繼承來源 VisualElement)
ForceLayout()

對項目及其所有子系強制執行配置週期。

(繼承來源 Layout)
GetChildElements(Point)

傳回顯示在所指定 point 下的子元素。

(繼承來源 View)
GetScrollPositionForElement(VisualElement, ScrollToPosition)

供 Xamarin.Forms 平台內部使用。

GetSizeRequest(Double, Double)
已過時。

傳回 Layout 的 SizeRequest。 呼叫此方法會開始配置週期的測量傳遞。

(繼承來源 Layout)
GetValue(BindableProperty)

傳回 BindableProperty 中包含的值。

(繼承來源 BindableObject)
GetValues(BindableProperty, BindableProperty)
已過時。

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
GetValues(BindableProperty, BindableProperty, BindableProperty)
已過時。

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
InvalidateLayout()

使目前的配置失效。

(繼承來源 Layout)
InvalidateMeasure()

用來呼叫而使此 VisualElement 配置失效的方法。 引發 MeasureInvalidated 事件。

(繼承來源 VisualElement)
InvalidateMeasureNonVirtual(InvalidationTrigger)

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsSet(BindableProperty)

如果目標屬性存在且已設定,則傳回 true

(繼承來源 BindableObject)
Layout(Rectangle)

在配置週期期間更新項目的界限。

(繼承來源 VisualElement)
LayoutChildren(Double, Double, Double, Double)

放置 ScrollView 並為其內容調整大小。

LowerChild(View)

將子系傳送到視覺化堆疊的最下層。

(繼承來源 Layout)
Measure(Double, Double, MeasureFlags)

傳回視覺項目為了在裝置上顯示時所需的最小大小。

(繼承來源 VisualElement)
NativeSizeChanged()

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
On<T>()

傳回此 ScrollView 的平台特定執行個體,可在其上呼叫平台特定方法。

OnBindingContextChanged()

只要 View 的繫結內容變更時就叫用。 覆寫這個方法可以為這個事件加入類別處理。

(繼承來源 View)
OnChildAdded(Element)

應用程式開發人員可以覆寫此方法,以便在新增子系時加以回應。

(繼承來源 VisualElement)
OnChildMeasureInvalidated()

每當配置的子系發出 MeasureInvalidated 時叫用。 實作這個方法可為此事件加入類別處理。

(繼承來源 Layout)
OnChildMeasureInvalidated(Object, EventArgs)

每當配置的子系發出 MeasureInvalidated 時叫用。 實作這個方法可為此事件加入類別處理。

(繼承來源 Layout)
OnChildRemoved(Element)
已過時。

應用程式開發人員可以覆寫此方法,以便在移除子系時加以回應。

(繼承來源 VisualElement)
OnChildRemoved(Element, Int32)

如果其內容需要,能夠捲動的項目。

(繼承來源 VisualElement)
OnChildrenReordered()

每當即將發出 ChildrenReordered 事件時叫用。 實作這個方法可為此事件加入類別處理。

(繼承來源 VisualElement)
OnMeasure(Double, Double)

配置度量發生時所呼叫的方法。

(繼承來源 VisualElement)
OnParentSet()

如果其內容需要,能夠捲動的項目。

(繼承來源 NavigableElement)
OnPropertyChanged(String)

繫結屬性變更時呼叫的方法。

(繼承來源 Element)
OnPropertyChanging(String)

從子類別呼叫這個方法,以通知屬性即將發生變更。

(繼承來源 BindableObject)
OnSizeAllocated(Double, Double)

在配置週期期間設定項目的大小時,會呼叫此方法。 在發出 SizeChanged 事件之前會直接呼叫此方法。 實作這個方法可為此事件加入類別處理。

(繼承來源 Layout)
OnSizeRequest(Double, Double)
已過時。

這個方法會在配置週期的測量傳遞期間呼叫,以取得項目的所需大小。

OnTabIndexPropertyChanged(Int32, Int32)

如果其內容需要,能夠捲動的項目。

(繼承來源 VisualElement)
OnTabStopPropertyChanged(Boolean, Boolean)

如果其內容需要,能夠捲動的項目。

(繼承來源 VisualElement)
RaiseChild(View)

將子系傳送到視覺化堆疊的最上層。

(繼承來源 Layout)
RemoveBinding(BindableProperty)

移除先前設定的繫結。

(繼承來源 BindableObject)
RemoveDynamicResource(BindableProperty)

移除先前設定的動態資源

(繼承來源 Element)
ResolveLayoutChanges()

如果其內容需要,能夠捲動的項目。

(繼承來源 Layout)
ScrollToAsync(Double, Double, Boolean)

傳回工作,以非同步方式將捲動檢視捲到某個位置。

ScrollToAsync(Element, ScrollToPosition, Boolean)

傳回工作,以非同步方式將捲動檢視捲到某個項目。

SendScrollFinished()

供 Xamarin.Forms 平台內部使用。

SetBinding(BindableProperty, BindingBase)

將繫結指派給屬性。

(繼承來源 BindableObject)
SetDynamicResource(BindableProperty, String)

透過具有所提供索引鍵的 DynamicResource,設定更新此項目的 BindableProperty 屬性。

(繼承來源 Element)
SetScrolledPosition(Double, Double)

供 Xamarin.Forms 平台內部使用。

SetValue(BindableProperty, Object)

設定指定之屬性的值。

(繼承來源 BindableObject)
SetValue(BindablePropertyKey, Object)

設定 propertyKey 的值。

(繼承來源 BindableObject)
SetValueCore(BindableProperty, Object, SetValueFlags)

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
SetValueFromRenderer(BindableProperty, Object)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
SetValueFromRenderer(BindablePropertyKey, Object)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
ShouldInvalidateOnChildAdded(View)

實作時,如果 child 應該呼叫 InvalidateMeasure(),則應傳回 true;如果不應該呼叫,則傳回 false

(繼承來源 Layout)
ShouldInvalidateOnChildRemoved(View)

實作時,如果 child 應該在移除時呼叫 InvalidateMeasure(),則應傳回 true;如果不應該呼叫,則傳回 false

(繼承來源 Layout)
SizeAllocated(Double, Double)

在配置週期期間呼叫 SizeAllocated 來表示子樹狀結構配置的開頭。

(繼承來源 VisualElement)
TabIndexDefaultValueCreator()

如果其內容需要,能夠捲動的項目。

(繼承來源 VisualElement)
TabStopDefaultValueCreator()

如果其內容需要,能夠捲動的項目。

(繼承來源 VisualElement)
UnapplyBindings()

取消套用所有先前設定的繫結。

(繼承來源 BindableObject)
Unfocus()

取消將焦點設定至此項目。

(繼承來源 VisualElement)
UpdateChildrenLayout()

指示此配置重新配置其所有子系。

(繼承來源 Layout)

事件

BatchCommitted

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
BindingContextChanged

每當 BindingContext 屬性變更時引發。

(繼承來源 BindableObject)
ChildAdded

只要將子項目新增至項目時就發生。

(繼承來源 Element)
ChildRemoved

只要從項目移除子項目時就發生。

(繼承來源 Element)
ChildrenReordered

在 VisualElement 的子系已重新排序時發生。

(繼承來源 VisualElement)
DescendantAdded

只要將子項目新增至項目樹狀子目錄時即發生。

(繼承來源 Element)
DescendantRemoved

只要從項目樹狀子目錄移除子項目時即發生。

(繼承來源 Element)
FocusChangeRequested

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
Focused

在項目取得焦點時發生。

(繼承來源 VisualElement)
LayoutChanged

如果任何子項目的 Bounds 已變更,則會在配置週期結束時發生。

(繼承來源 Layout)
MeasureInvalidated

視覺項目配置失效時所引發的事件。

(繼承來源 VisualElement)
PlatformSet
已過時。

如果其內容需要,能夠捲動的項目。

(繼承來源 Element)
PropertyChanged

在屬性變更時引發。

(繼承來源 BindableObject)
PropertyChanging

在屬性即將變更時引發。

(繼承來源 BindableObject)
Scrolled

捲動完成之後所引發的事件。

ScrollToRequested

供 Xamarin.Forms 平台內部使用。

SizeChanged

當這個項目的 Width 或 Height 屬性變更值時發生。

(繼承來源 VisualElement)
Unfocused

在項目失去焦點時發生。

(繼承來源 VisualElement)

明確介面實作

IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
IElementController.SetValueFromRenderer(BindableProperty, Object)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
IGestureController.CompositeGestureRecognizers

供 Xamarin.Forms 平台內部使用。

(繼承來源 View)
INameScope.RegisterName(String, Object)

僅供內部使用。

(繼承來源 Element)
IVisualElementController.EffectiveFlowDirection

取得平台上項目的有效視覺流程方向,並將地區設定和邏輯流程設定納入考量。

(繼承來源 VisualElement)
IVisualElementController.InvalidateMeasure(InvalidationTrigger)

此方法供內部使用。

(繼承來源 VisualElement)

擴充方法

AbortAnimation(IAnimatable, String)

停止動畫。

Animate(IAnimatable, String, Action<Double>, Double, Double, UInt32, UInt32, Easing, Action<Double,Boolean>, Func<Boolean>)

設定指定參數並開始動畫。

Animate(IAnimatable, String, Action<Double>, UInt32, UInt32, Easing, Action<Double,Boolean>, Func<Boolean>)

設定指定參數並開始動畫。

Animate(IAnimatable, String, Animation, UInt32, UInt32, Easing, Action<Double,Boolean>, Func<Boolean>)

設定指定參數並開始動畫。

Animate<T>(IAnimatable, String, Func<Double,T>, Action<T>, UInt32, UInt32, Easing, Action<T,Boolean>, Func<Boolean>)

設定指定參數並開始動畫。

AnimateKinetic(IAnimatable, String, Func<Double,Double,Boolean>, Double, Double, Action)

設定指定參數並開始動態動畫。

AnimationIsRunning(IAnimatable, String)

傳回布林值,指出由 handle 指定的動畫是否正在執行中。

Batch(IAnimatable)

如果其內容需要,能夠捲動的項目。

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)

如果其內容需要,能夠捲動的項目。

SetAppThemeColor(BindableObject, BindableProperty, Color, Color)

如果其內容需要,能夠捲動的項目。

SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)

建立並將繫結套用至屬性。

SetBinding<TSource>(BindableObject, BindableProperty, Expression<Func<TSource,Object>>, BindingMode, IValueConverter, String)
已過時。

從運算式建立及套用繫結。

SetOnAppTheme<T>(BindableObject, BindableProperty, T, T)

如果其內容需要,能夠捲動的項目。

FindByName<T>(Element, String)

傳回包含 element 的範圍中具有 name 名稱的 T 類型執行個體。

FindNextElement(ITabStopElement, Boolean, IDictionary<Int32,List<ITabStopElement>>, Int32)

如果其內容需要,能夠捲動的項目。

GetSortedTabIndexesOnParentPage(VisualElement)

如果其內容需要,能夠捲動的項目。

GetTabIndexesOnParentPage(ITabStopElement, Int32)

如果其內容需要,能夠捲動的項目。

FadeTo(VisualElement, Double, UInt32, Easing)

傳回僅根據 opacitylengtheasing 參數描述的內容執行淡化的工作。

LayoutTo(VisualElement, Rectangle, UInt32, Easing)

傳回一個工作,其可將 view 所指定 VisualElement 的邊界,緩移為 bounds 參數所指定的矩形。

RelRotateTo(VisualElement, Double, UInt32, Easing)

view 所指定的 VisualElement,從其目前的旋轉,加以旋轉 drotation

RelScaleTo(VisualElement, Double, UInt32, Easing)

傳回將 view 所指定 VisualElement 從其目前大小縮放至 dscale 的工作。

RotateTo(VisualElement, Double, UInt32, Easing)

傳回執行由 rotationlengtheasing 參數所描述旋轉的工作。

RotateXTo(VisualElement, Double, UInt32, Easing)

傳回透過 opacity,耗費時間 length 及使用 easing 扭曲 Y 軸的工作。

RotateYTo(VisualElement, Double, UInt32, Easing)

傳回透過 opacity 耗費時間 length 及使用 easing 扭曲 X 軸的工作。

ScaleTo(VisualElement, Double, UInt32, Easing)

傳回將 view 所指定 VisualElement 縮放至絕對縮放比例 scale 的工作。

ScaleXTo(VisualElement, Double, UInt32, Easing)

如果其內容需要,能夠捲動的項目。

ScaleYTo(VisualElement, Double, UInt32, Easing)

如果其內容需要,能夠捲動的項目。

TranslateTo(VisualElement, Double, Double, UInt32, Easing)

將項目 TranslationX 和 TranslationY 屬性,從其目前的值動畫顯示為新值。 這可確保輸入配置在與視覺效果配置相同的位置。

HasVisualStateGroups(VisualElement)

如果 element 具有一或多個與其建立關聯的視覺狀態群組,則傳回 true。 否則傳回 false

適用於