Components of a designer document can be selected using the ISelectionService.SetSelectedComponents(ICollection) method of the System.ComponentModel.Design.ISelectionService. Some types of actions can operate on a selected component or group of selected components. The System.ComponentModel.Design.ISelectionService keeps track of the selection type of the current selection. These selection type identifiers indicate whether the selection was completed using a single click, a mouse down or mouse up selection, whether the selection should replace the previous selection, or use the default selection mode.
Use the System.ComponentModel.Design.SelectionTypes enumeration to specify the type of a selection when setting a new selection using the ISelectionService.SetSelectedComponents(ICollection) method.
Member Name | Description |
---|---|
Add |
Represents an add selection that adds the selected components to the current selection, maintaining the current set of selected components. |
Auto |
Represents a regular selection. The selection service responds to the CTRL and SHIFT keys to support adding or removing components to or from the selection. |
Click |
Represents a selection that occurs when a user clicks a component. If the newly selected component is already selected, it is promoted to be the primary selected component rather than being canceled. |
MouseDown |
Represents a selection that occurs when the user presses on the mouse button while the mouse pointer is over a component. If the component under the pointer is already selected, it is promoted to become the primary selected component rather than being canceled. |
MouseUp |
Represents a selection that occurs when the user releases the mouse button immediately after a component has been selected. If the newly selected component is already selected, it is promoted to be the primary selected component rather than being canceled. |
Normal |
Represents a regular selection. The selection service responds to the CTRL and SHIFT keys to support adding or removing components to or from the selection. |
Primary |
Represents a primary selection that occurs when a user clicks on a component. If a component in the selection list is already selected, the component is promoted to be the primary selection. |
Remove |
Represents a remove selection that removes the selected components from the current selection, maintaining the current set of selected components. |
Replace |
Represents a selection that occurs when the content of a selection is replaced. The selection service replaces the current selection with the replacement. |
Toggle |
Represents a toggle selection that switches between the current selection and the provided selection. If a component is already selected and is passed into erload:System.ComponentModel.Design.ISelectionService.SetSelectedComponents with a selection type of SelectionTypes.Toggle, the component selection will be canceled. |
Valid |
Identifies the valid selection types as SelectionTypes.Normal, SelectionTypes.Replace, SelectionTypes.MouseDown, SelectionTypes.MouseUp, or SelectionTypes.Click. |