值控制模式

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

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

本主题包含以下部分。

实施准则和约定

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

如果任一项的值是可编辑的，则列表项或树项等控件必须支持值控件模式，而不考虑控件的当前编辑模式。如果子项可编辑，父控件还必须支持 Value 控件模式。下图显示了可编辑列表项的示例。

显示可编辑列表项插图
单行和多行编辑控件必须实现 ITextProvider 才能公开其只读内容。
多行编辑控件必须实现 IValueProvider（如果可以更改其内容）。
IValueProvider 不支持检索格式信息或子字符串值。在这些方案中实现 ITextProvider。
IValueProvider 必须由Microsoft Word 中的颜色选取器选择控件（请参阅下图）实现，该控件支持颜色值（例如“yellow”）和等效的内部 RGB 值之间的字符串映射。

显示颜色监视字符串映射插图
控件的 IsEnabled 属性应设置为 TRUE，并且其 ITextProvider：：IsReadOnly 属性设置为 FALSE，然后允许调用 ITextProvider：：SetValue。

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

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