值控件模式

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

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

本主題包含下列各節。

實作指導方針和慣例

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

不論控制項目前的編輯模式為何，清單專案或樹狀目錄專案等控件都必須支援值控件模式。如果子專案可編輯，父控件也必須支援 Value 控件模式。下圖顯示可編輯清單專案的範例。

顯示可編輯清單專案圖例
單行和多行編輯控件必須實作 ITextProvider 來公開其唯讀內容。
如果可以變更 IValueProvider，多行編輯控件必須實作 IValueProvider。
IValueProvider 不支援擷取格式化資訊或子字串值。在這些案例中實作 ITextProvider。
IValueProvider 必須由Microsoft Word 的色彩選擇器選取控件等控件實作（請參閱下圖），其支援色彩值（例如“yellow”）與同等的內部 RGB 值之間的字元串對應。

顯示色彩色板字串對應圖例
控件的 IsEnabled 屬性應設定為 TRUE TRUE，且其 ITextProvider：：IsReadOnly 屬性設定為 FALSE，再允許呼叫 ITextProvider：：SetValue。

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

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