共用方式為


值控制項模式

描述實作 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 方法

 

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

控制項類型及其支援的控制項模式

UI 自動化控制項模式概觀

UI 自動化樹狀目錄概觀

文字和 TextRange 控制項模式