SelectionState 類別

表示任何選取狀態的抽象類別。 提供介面來查詢指定的選取範圍的相關資訊，包括：ActualSelection、CoercedSelection，以及選取範圍中是否要篩選出特定命令。

繼承階層架構

System.Object
  Microsoft.VisualStudio.Modeling.Diagrams.SelectionState
    Microsoft.VisualStudio.Modeling.Diagrams.EmptySelection
    Microsoft.VisualStudio.Modeling.Diagrams.GeneralSelection

命名空間：  Microsoft.VisualStudio.Modeling.Diagrams
組件：  Microsoft.VisualStudio.Modeling.Sdk.Diagrams.12.0 (在 Microsoft.VisualStudio.Modeling.Sdk.Diagrams.12.0.dll 中)

語法

'宣告
Public MustInherit Class SelectionState

public abstract class SelectionState

SelectionState 類型會公開下列成員。

建構函式

	名稱	描述
	SelectionState

回頁首

屬性

	名稱	描述
	ActualSelection	取得實際選取項目。
	CoercedSelection	藉由將強制型轉規則套用到實際的選取範圍，取得強制選取範圍。注意：傳回的值可以是 null。空的強制型轉表示選取狀態未定義強制型轉規則 (也就是多狀態只包含註解連接器由 GeneralSelection 狀態，包括未定義任何強制型轉規則，因此，狀態的強制型轉是空的)。如果為選取狀態定義了強制型轉規則，但是強制型轉失敗 (可能的情況是選取項目包括數個屬於不同區域的元件)，則強制選取項目存在，但卻是空的。這些 Helper 可用於回溯強制神秘選取的結果:* IsCoercible -則為 true，如果狀態可以強制型轉 (即選取狀態定義強制型轉規則)。CoercedSelection 將會傳回集合，但這可能是空的。* IsCoercionFailure - 如果可以強制型轉實際選取範圍，但強制型轉因為強制型轉規則而失敗，則為 true。CoercedSelection 將會是空集合。* HasCoercion - 如果實際選取範圍可強制型轉，且其強制型轉不會失敗，則為 true。CoercedSelection 將會傳回非空集合。
	CoercedSelectionCache
	CoercedSelectionModelElements	CoercedSelection 可能包含 Pels 以及與尚未包含之 Pels 相關聯的 Mels。這個方法會傳回清單，此清單會將強制選取範圍中的 Pels 替換成其相關聯的 Mels，加上來自沒有 pels 之強制選取範圍中的任何 mels。
	CoercedSelectionPresentationElements	CoercedSelection 可能包含 Pels 以及與尚未包含之 Pels 相關聯的 Mels。這個方法會傳回集合，此集合會排除任何 Mels。
	CoercionCompliantSelection	傳回符合強制型轉規則的選取物件的清單。如果選取範圍為可強制，則會傳回強制選取範圍，如果強制型轉失敗，則清單會是空的。如果沒有任何強制型轉規則 (!IsCoercable)，則會傳回實際的選取項目。
	HasCoercion	判斷選取範圍是否有有效的強制型轉。
	IsActualSelectionMixed	如果實際的選取範圍中所有選取的物件屬於相同型別，則為 true。
	IsCoercedSelectionMixed	如果強制選取範圍中所有選取的物件屬於相同型別，則為 true。
	IsCoercible	判斷是否可以強制型轉實際選取範圍。Togegher IsCoercible 和 IsCoercionFailure 區別強制型轉失敗和沒有可用的強制型轉。
	IsCoercionFailure	Togegher IsCoercible 和 IsCoercionFailure 區別強制型轉失敗和沒有可用的強制型轉。

回頁首

方法

	名稱	描述
	CacheCoercedSelection	快取指定的集合。
	Equals	判斷指定的物件是否等於目前物件。 (繼承自 Object)。
	Finalize	允許物件在記憶體回收進行回收之前，嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
	GetHashCode	做為預設雜湊函式。 (繼承自 Object)。
	GetType	取得目前執行個體的 Type。 (繼承自 Object)。
	IdentifyCommandsToBeFilteredOutForMultipleSelection	覆寫以識別在單一選取案例中，此選取狀態的無效命令。
	IdentifyCommandsToBeFilteredOutForSingleSelection	覆寫以識別在單一選取案例中，此選取狀態的無效命令。
	Initialize	指定要操作的實際選取範圍。
	IsApplicable	如果 SelectionState 套用至目前指定的選取範圍 (actualSelection)，則為 true。
	IsCommandToBeFilteredOut	如果不應該針對此選取狀態啟用指定的命令，則為 true。會針對強制型轉的選取範圍評估此方法。
	IsCommandToBeFilteredOutForMultipleSelection	如果不應該針對此選取狀態啟用指定的命令，則為 true。會針對強制型轉的選取範圍評估此方法。
	IsCommandToBeFilteredOutForSingleSelection	如果不應該針對此選取狀態啟用指定的命令，則為 true。會針對強制型轉的選取範圍評估此方法。
	MemberwiseClone	建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
	ToString	傳回表示目前物件的字串。 (繼承自 Object)。

回頁首

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.VisualStudio.Modeling.Diagrams 命名空間