值控制項模式
描述實作 IValueProvider的指導方針和慣例，包括屬性和方法的相關資訊。 Value控制項模式可用來支援內建值未跨越範圍且可表示為字串的控制項。
值字串可以根據控制項及其設定來編輯。 如需實作此控制項模式的控制項範例，請參閱 控制項類型及其支援的控制項模式。
本主題包含下列各節。
實作方針和慣例
實作 值 控制項模式時，請注意下列指導方針和慣例：
如果任一專案的值是可編輯的，清單專案或樹狀目錄專案之類的控制項必須支援 Value 控制項模式，而不論控制項目前的編輯模式為何。 如果子專案可編輯，父控制項也必須支援 Value 控制項模式。 下圖顯示可編輯清單專案的範例。
單行和多行編輯控制項必須實作 ITextProvider ，才能公開其唯讀內容。
如果可以變更 IValueProvider 的內容，多行編輯控制項就必須實作 IValueProvider 。
IValueProvider 不支援擷取格式化資訊或子字串值。 在這些案例中實作 ITextProvider 。
IValueProvider必須由來自 Microsoft Word (的色彩選擇器選取控制項之類的控制項實作，) ，其支援色彩值之間的字串對應 (，例如「yellow」) 和對等的內部RGB值。
控制項應該將其 IsEnabled 屬性設定為 TRUE ，且其 ITextProvider：：IsReadOnly 屬性設定為 FALSE ，再允許呼叫 ITextProvider：：SetValue。
IValueProvider的必要成員
實作 IValueProvider 介面需要下列屬性和方法。
| 必要成員 | 成員類型 | 備註 |
|---|---|---|
| IsReadOnly | 屬性 | 無 |
| 值 | 屬性 | 無 |
| SetValue | 方法 | 無 |
此控制項模式沒有任何相關聯的事件。
相關主題