捲動控制項模式
描述實作 IScrollProvider的指導方針和慣例,包括屬性和方法的相關資訊。 卷動控制項模式是用來支援做為子物件集合之可捲動容器的控制項。
控制項不需要使用捲軸來支援捲動功能,雖然它通常是這樣。 下圖顯示不使用捲軸的捲動控制項。 如需實作此控制項模式的控制項範例,請參閱 控制項類型及其支援的控制項模式。
本主題包含下列各節。
實作方針和慣例
實作 Scroll 控制項模式時,請注意下列指導方針和慣例:
- 這個控制項的子系必須實作 IScrollItemProvider。
- 容器控制項的捲軸不支援 卷 動控制項模式。 它們必須改為支援 RangeValue 控制項模式。
- 若捲動是以百分比為單位,則與捲動刻度相關的所有值或數量必須標準化為 0 到 100 之間的範圍。
- IScrollProvider::HorizontallyScrollable屬性和VerticallyScrollable屬性與IsEnabled屬性無關。
- 如果 IScrollProvider::HorizontallyScrollable 屬性為 FALSE, HorizontalViewSize 屬性應設定為 100 (100%) , 而 HorizontalScrollPercent 屬性應設定為 UIA_ScrollPatternNoScroll (-1) 。 同樣地,如果 VerticallyScrollable 屬性為 FALSE, 則 VerticalViewSize 屬性應該設定為 100 (100%) , 而 VerticalScrollPercent 屬性應該設定為 UIA_ScrollPatternNoScroll (-1) 。 這可讓 Microsoft 消費者介面自動化 用戶端在SetScrollPercent方法中使用這些屬性值,同時避免用戶端對捲動不感興趣的方向啟動競爭狀況。
- IScrollProvider::HorizontalScrollPercent屬性是地區設定特定的屬性。 將 HorizontalScrollPercent 設定為 100,必須將控制項的捲動位置設定為其最右邊的位置,例如從左至右讀取的語言。 或者,對於從右至左讀取的阿拉伯文,將 HorizontalScrollPercent 設定為 100 必須將捲動位置設定為最左邊的位置。
IScrollProvider的必要成員
實作 IScrollProvider 介面需要下列屬性和方法。
必要成員 | 成員類型 | 備註 |
---|---|---|
HorizontalScrollPercent | 屬性 | 無 |
VerticalScrollPercent | 屬性 | 無 |
HorizontalViewSize | 屬性 | 無 |
VerticalViewSize | 屬性 | 無 |
HorizontallyScrollable | 屬性 | 無 |
VerticallyScrollable | 屬性 | 無 |
Scroll | 方法 | 無 |
SetScrollPercent | 方法 | 無 |
此控制項模式沒有任何相關聯的事件。
相關主題