值控件模式
介绍实现 IValueProvider 的准则和约定，包括有关属性和方法的信息。 Value 控件模式用于支持具有不跨范围且可表示为字符串的固有值的控件。
值字符串可以编辑，具体取决于控件及其设置。 有关实现此控件模式的控件示例，请参阅 控件类型及其支持的控件模式。
本主题包含以下各节：
实现准则和约定
实现 Value 控件模式时，请注意以下准则和约定：
如果任何项的值是可编辑的，则列表项或树项等控件必须支持 Value 控件模式，而不考虑控件的当前编辑模式。 如果子项可编辑，父控件还必须支持 Value 控件模式。 下图显示了可编辑列表项的示例。
单行和多行编辑控件必须实现 ITextProvider 才能公开其只读内容。
如果多行编辑控件的内容可以更改，则必须实现 IValueProvider 。
IValueProvider 不支持检索格式设置信息或子字符串值。 在这些方案中实现 ITextProvider 。
IValueProvider 必须由 Microsoft Word (颜色选取器选择控件等控件实现，请参阅下图) ，该图像支持颜色值之间的字符串映射 (例如“yellow”) 和等效的内部 RGB 值。
在允许调用 ITextProvider：：SetValue 之前，控件应将其 IsEnabled 属性设置为 TRUE，并将其 ITextProvider：：IsReadOnly 属性设置为 FALSE。
IValueProvider 的必需成员
实现 IValueProvider 接口需要以下属性和方法。
| 必需的成员 | 成员类型 | 说明 |
|---|---|---|
| IsReadOnly | 属性 | 无 |
| 值 | 属性 | 无 |
| SetValue | 方法 | 无 |
没有与此控件模式关联的事件。
相关主题