值控件模式

介绍实现 IValueProvider 的准则和约定，包括有关属性和方法的信息。 Value 控件模式用于支持具有不跨范围且可表示为字符串的固有值的控件。

值字符串可以编辑，具体取决于控件及其设置。有关实现此控件模式的控件示例，请参阅控件类型及其支持的控件模式。

本主题包含以下各节：

实现准则和约定

实现 Value 控件模式时，请注意以下准则和约定：

如果任何项的值是可编辑的，则列表项或树项等控件必须支持 Value 控件模式，而不考虑控件的当前编辑模式。如果子项可编辑，父控件还必须支持 Value 控件模式。下图显示了可编辑列表项的示例。
单行和多行编辑控件必须实现 ITextProvider 才能公开其只读内容。
如果多行编辑控件的内容可以更改，则必须实现 IValueProvider 。
IValueProvider 不支持检索格式设置信息或子字符串值。在这些方案中实现 ITextProvider 。
IValueProvider 必须由 Microsoft Word (颜色选取器选择控件等控件实现，请参阅下图) ，该图像支持颜色值之间的字符串映射 (例如“yellow”) 和等效的内部 RGB 值。
在允许调用 ITextProvider：：SetValue 之前，控件应将其 IsEnabled 属性设置为 TRUE，并将其 ITextProvider：：IsReadOnly 属性设置为 FALSE。

实现 IValueProvider 接口需要以下属性和方法。

没有与此控件模式关联的事件。