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