滚动控件模式
介绍实现 IScrollProvider 的准则和约定,包括有关属性和方法的信息。 Scroll 控件模式用于支持充当子对象集合的可滚动容器的控件。
控件不需要使用滚动条来支持滚动功能,尽管它通常这样做。 下图显示了不使用滚动条的滚动控件。 有关实现此控件模式的控件示例,请参阅 控件类型及其支持的控件模式。
本主题包含以下各节:
实现准则和约定
实现 Scroll 控件模式时,请注意以下准则和约定:
- 此控件的子级必须实现 IScrollItemProvider。
- 容器控件的滚动条不支持 Scroll 控件模式。 它们必须改为支持 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 UI 自动化 客户端在 SetScrollPercent 方法中使用这些属性值,同时避免在客户端对滚动方向不感兴趣时出现争用条件。
- IScrollProvider::HorizontalScrollPercent 属性特定于区域设置。 将 HorizontalScrollPercent 设置为 100 必须将控件的滚动位置设置为与从左到右阅读的语言(如英语)的最右侧位置等效。 或者,对于从右到左阅读的阿拉伯语等语言,将 HorizontalScrollPercent 设置为 100 必须将滚动位置设置为最左侧的位置。
IScrollProvider 的必需成员
实现 IScrollProvider 接口需要以下属性和方法。
必需的成员 | 成员类型 | 说明 |
---|---|---|
HorizontalScrollPercent | 属性 | 无 |
VerticalScrollPercent | 属性 | 无 |
HorizontalViewSize | 属性 | 无 |
VerticalViewSize | 属性 | 无 |
HorizontallyScrollable | 属性 | 无 |
VerticallyScrollable | 属性 | 无 |
滚动 | 方法 | 无 |
SetScrollPercent | 方法 | 无 |
没有与此控件模式关联的事件。
相关主题