Share via


GeneralSelection Class

Handles general selections not covered by other selection states.

Inheritance Hierarchy

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

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

Syntax

'Declaration
Public Class GeneralSelection _
    Inherits SelectionState
public class GeneralSelection : SelectionState
public ref class GeneralSelection : public SelectionState
type GeneralSelection =  
    class 
        inherit SelectionState 
    end
public class GeneralSelection extends SelectionState

The GeneralSelection type exposes the following members.

Constructors

  Name Description
Public method GeneralSelection constructor

Top

Properties

  Name Description
Public property ActualSelection Gets the actual selection. (Inherited from SelectionState.)
Public property CoercedSelection 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. (Inherited from SelectionState.)
Protected property CoercedSelectionCache (Inherited from SelectionState.)
Public property CoercedSelectionModelElements 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. (Inherited from SelectionState.)
Public property CoercedSelectionPresentationElements 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. (Inherited from SelectionState.)
Public property CoercionCompliantSelection 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. (Inherited from SelectionState.)
Public property HasCoercion Determines if the selection has a valid coercion. (Inherited from SelectionState.)
Public property IsActualSelectionMixed True if all selected objects in the actual selection are of the same type. (Inherited from SelectionState.)
Public property IsCoercedSelectionMixed True if all selected objects in the coerced selection are of the same type. (Inherited from SelectionState.)
Public property IsCoercible Determines if the actual selection can be coerced. Togegher IsCoercible and IsCoercionFailure distinguish between coercion failure, and no coercion available. (Inherited from SelectionState.)
Public property IsCoercionFailure Togegher IsCoercible and IsCoercionFailure distinguish between coercion failure, and no coercion available. (Inherited from SelectionState.)

Top

Methods

  Name Description
Protected method CacheCoercedSelection Cache the specified collection. (Inherited from SelectionState.)
Public method Equals Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method IdentifyCommandsToBeFilteredOutForMultipleSelection Override to identify the commands which are not valid. (Overrides SelectionState.IdentifyCommandsToBeFilteredOutForMultipleSelection(CommandIdCollection).)
Protected method IdentifyCommandsToBeFilteredOutForSingleSelection Override to identify the commands which are not valid in a single selection scenario, for this selection state. (Inherited from SelectionState.)
Public method Initialize specifies the actual selection to operate upon. (Inherited from SelectionState.)
Public method IsApplicable Determines if this selection state is apppropriate for use with the specified selection. (Overrides SelectionState.IsApplicable(ICollection).)
Public method IsCommandToBeFilteredOut True if the specified command should not be enabled for this selection state. The method is evaluated for the coerced selection. (Inherited from SelectionState.)
Protected method IsCommandToBeFilteredOutForMultipleSelection True if the specified command should not be enabled for this selection state. The method is evaluated for the coerced selection. (Overrides SelectionState.IsCommandToBeFilteredOutForMultipleSelection(CommandID).)
Protected method IsCommandToBeFilteredOutForSingleSelection True if the specified command should not be enabled for this selection state. The method is evaluated for the coerced selection. (Inherited from SelectionState.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method ToString Returns a string that represents the current object. (Inherited from Object.)

Top

Thread Safety

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

See Also

Reference

Microsoft.VisualStudio.Modeling.Diagrams Namespace