ModelItem 類別

代表編輯模型中的單一項目。

繼承階層架構

System.Object
  Microsoft.Windows.Design.Model.ModelItem
    Microsoft.Windows.Design.Model.ModelItemCollection
    Microsoft.Windows.Design.Model.ModelItemDictionary

命名空間:  Microsoft.Windows.Design.Model
組件:  Microsoft.Windows.Design.Interaction (在 Microsoft.Windows.Design.Interaction.dll 中)

語法

'宣告
Public MustInherit Class ModelItem _
    Implements INotifyPropertyChanged
public abstract class ModelItem : INotifyPropertyChanged
public ref class ModelItem abstract : INotifyPropertyChanged
[<AbstractClass>]
type ModelItem =  
    class
        interface INotifyPropertyChanged
    end
public abstract class ModelItem implements INotifyPropertyChanged

ModelItem 型別會公開下列成員。

建構函式

  名稱 說明
受保護的方法 ModelItem 初始化 ModelItem 類別的新執行個體。

回頁首

屬性

  名稱 說明
公用屬性 Content 在衍生類別中覆寫時,取得 ModelProperty,表示項目的 ContentPropertyAttribute
公用屬性 Context 取得包含內容資訊的物件,這些內容與專為設計工具建立的 ModelItem 相關。
公用屬性 Events 在衍生類別中覆寫時,取得這個物件上的公用事件。
公用屬性 ItemType 在衍生類別中覆寫時,取得項目所表示的物件型別。
公用屬性 Name 在衍生類別中覆寫時,取得或設定項目的名稱或 ID。
公用屬性 Parent 在衍生類別中覆寫時,取得這個項目的父代項目。
公用屬性 Properties 在衍生類別中覆寫時,取得這個物件上的公用屬性。
公用屬性 Root 在衍生類別中覆寫時,取得這個樹狀結構的根項目。
公用屬性 Source 在衍生類別中覆寫時,取得提供這個值的屬性。
公用屬性 View 在衍生類別中覆寫時,取得表示這個項目之 UI 的 visual 或 visual3D。

回頁首

方法

  名稱 說明
公用方法 BeginEdit() 當在衍生類別中被覆寫時,會在一個物件或物件群組中執行多個作業時呼叫方法。
公用方法 BeginEdit(String) 當在衍生類別中被覆寫時,會在一個物件或物件群組中執行多個作業時呼叫方法。
公用方法 Equals 判斷指定的 Object 和目前的 Object 是否相等。 (繼承自 Object)。
受保護的方法 Finalize 允許物件在記憶體回收進行回收之前,嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
公用方法 GetAttributes(Type) 取得在此項目上宣告之要求型別的屬性。
公用方法 GetAttributes(TypeIdentifier) 取得在此項目上宣告之要求型別的屬性。
公用方法 GetCurrentValue 在衍生類別中覆寫時,傳回 ModelItem 所包裝的基礎模型物件的目前值。
公用方法 GetHashCode 做為特定型別的雜湊函式。 (繼承自 Object)。
公用方法 GetType 取得目前執行個體的 Type。 (繼承自 Object)。
公用方法 IsItemOfType(Type) 取得值,這個值表示這個項目是否屬於指定的型別,或者實作指定的介面。
公用方法 IsItemOfType(TypeIdentifier) 取得值,這個值表示這個項目是否屬於指定的型別,或者實作指定的介面。
受保護的方法 MemberwiseClone 建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
公用方法 ToString 傳回表示目前物件的字串。 (繼承自 Object)。

回頁首

事件

  名稱 說明
公用事件 PropertyChanged 在衍生類別中覆寫時,當模型上的屬性變更時發生。

回頁首

備註

ModelItem 類別,表示編輯模型中的單一項目。 上至視窗或控制項,下至色彩或整數,都算是項目。 您可以透過 Properties 集合存取項目的屬性,並變更屬性的值。 基本上,ModelItem 是設計工具基礎資料模型周圍的包裝函式。 您可以透過 GetCurrentValue 方法存取基礎模型。

請務必使用 CreateItem 方法,在設計介面上建立新物件。 這是因為許多原始的執行個體無法剖析成模型項目。 一旦值設定在模型中,您便應該只透過模型與它互動。 支持模型的執行個體隨時都可以由架構重建,而此情況會使您已快取的任何參考失效。

注意事項注意事項

請勿對 GetCurrentValue 方法傳回的物件採取任何序列化變更。 這種變更不會反映回到設計工具的序列化系統或復原系統中。

注意事項注意事項

透過使用字串來設定模型項目的値時,使用不因國別而異的文化特性。

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。

請參閱

參考

Microsoft.Windows.Design.Model 命名空間

其他資源

WPF 設計工具擴充性架構

編輯模型架構