值控制項模式

描述實作 IValueProvider的指導方針和慣例，包括屬性和方法的相關資訊。 Value控制項模式可用來支援內建值未跨越範圍且可表示為字串的控制項。

值字串可以根據控制項及其設定來編輯。如需實作此控制項模式的控制項範例，請參閱控制項類型及其支援的控制項模式。

本主題包含下列各節。

實作方針和慣例

實作值控制項模式時，請注意下列指導方針和慣例：

如果任一專案的值是可編輯的，清單專案或樹狀目錄專案之類的控制項必須支援 Value 控制項模式，而不論控制項目前的編輯模式為何。如果子專案可編輯，父控制項也必須支援 Value 控制項模式。下圖顯示可編輯清單專案的範例。
單行和多行編輯控制項必須實作 ITextProvider ，才能公開其唯讀內容。
如果可以變更 IValueProvider 的內容，多行編輯控制項就必須實作 IValueProvider 。
IValueProvider 不支援擷取格式化資訊或子字串值。在這些案例中實作 ITextProvider 。
IValueProvider必須由來自 Microsoft Word (的色彩選擇器選取控制項之類的控制項實作，) ，其支援色彩值之間的字串對應 (，例如「yellow」) 和對等的內部RGB值。
控制項應該將其 IsEnabled 屬性設定為 TRUE ，且其 ITextProvider：：IsReadOnly 屬性設定為 FALSE ，再允許呼叫 ITextProvider：：SetValue。

實作 IValueProvider 介面需要下列屬性和方法。

此控制項模式沒有任何相關聯的事件。