SelectionState Class

 

Abstract class representing any selection state. Provides the interface for querying infomation about the specified selection, including: the ActualSelection, CoercedSelection, and weather or not a specifc command is to be filtered out for the selection.

Namespace:   Microsoft.VisualStudio.Modeling.Diagrams
Assembly:  Microsoft.VisualStudio.Modeling.Sdk.Diagrams.12.0 (in Microsoft.VisualStudio.Modeling.Sdk.Diagrams.12.0.dll)


public ref class SelectionState abstract 

NameDescription
System_CAPS_pubpropertyActualSelection

Gets the actual selection.

System_CAPS_pubpropertyCoercedSelection

Gets the coerced selection by applying coercion rules to the actual selection. NOTE: The returned value can be null. A null coercion indicates that the selection state doesn't define coercion rules (i.e. a multiple seleciton including only comment connectors is covered by the GeneralSelection state, which doesn't define any coercions rules, so the seleciton's coercion is null). If coercion rules are defined for a selection state, but the coercion fails (as would be the case for a selection including several components belonging to different zones), the coerced selection exists but is empty. These helpers can be used to demystify the results of coercing a selection: * IsCoercible - true if the seleciton can be coerced (i.e. the selection state does define coercion rules). CoercedSelection will return a collection, but it may be empty. * IsCoercionFailure - true if the actual selection can be coerced, but the coercion fails (due coercion rules.) CoercedSelection will be an empy collection. * HasCoercion - true if the actual selection is coercable and its coercion does not fail. CoercedSelection will return a non-empty collection.

System_CAPS_protpropertyCoercedSelectionCache

System_CAPS_pubpropertyCoercedSelectionModelElements

It is possible for the CoercedSelection to include Pels and Mels which are associated with Pels that are not already included. This method returns a list that replaces the Pels in the coerced selection with their associated Mels, plus any mels from the coerced selection that did not have pels.

System_CAPS_pubpropertyCoercedSelectionPresentationElements

It is possible for the CoercedSelection to include Pels and Mels which are associated with Pels that are not already included. This method returns a collection which excludes any Mels.

System_CAPS_pubpropertyCoercionCompliantSelection

Returns the list of selected objects which comply with the coercion rules. If the selection is coercable, then the coerced selection will be returned; if there is a coercion failure the list will be empty. If there are no coercion rules (!IsCoercable), then the actual selection is returned.

System_CAPS_pubpropertyHasCoercion

Determines if the selection has a valid coercion.

System_CAPS_pubpropertyIsActualSelectionMixed

True if all selected objects in the actual selection are of the same type.

System_CAPS_pubpropertyIsCoercedSelectionMixed

True if all selected objects in the coerced selection are of the same type.

System_CAPS_pubpropertyIsCoercible

Determines if the actual selection can be coerced. Togegher IsCoercible and IsCoercionFailure distinguish between coercion failure, and no coercion available.

System_CAPS_pubpropertyIsCoercionFailure

Togegher IsCoercible and IsCoercionFailure distinguish between coercion failure, and no coercion available.

NameDescription
System_CAPS_protmethodCacheCoercedSelection(ICollection^)

Cache the specified collection.

System_CAPS_pubmethodEquals(Object^)

(Inherited from Object.)

System_CAPS_protmethodFinalize()

(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

(Inherited from Object.)

System_CAPS_pubmethodGetType()

(Inherited from Object.)

System_CAPS_protmethodIdentifyCommandsToBeFilteredOutForMultipleSelection(CommandIdCollection^)

Override to identify the commands which are not valid in a single selection scenario, for this selection state.

System_CAPS_protmethodIdentifyCommandsToBeFilteredOutForSingleSelection(CommandIdCollection^)

Override to identify the commands which are not valid in a single selection scenario, for this selection state.

System_CAPS_pubmethodInitialize(ICollection^)

specifies the actual selection to operate upon.

System_CAPS_pubmethodIsApplicable(ICollection^)

True if the SelectionState appiles to the specified selection (actualSelection.)

System_CAPS_pubmethodIsCommandToBeFilteredOut(CommandID^)

True if the specified command should not be enabled for this selection state. The method is evaluated for the coerced selection.

System_CAPS_protmethodIsCommandToBeFilteredOutForMultipleSelection(CommandID^)

True if the specified command should not be enabled for this selection state. The method is evaluated for the coerced selection.

System_CAPS_protmethodIsCommandToBeFilteredOutForSingleSelection(CommandID^)

True if the specified command should not be enabled for this selection state. The method is evaluated for the coerced selection.

System_CAPS_protmethodMemberwiseClone()

(Inherited from Object.)

System_CAPS_pubmethodToString()

(Inherited from Object.)

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: