SelectionTool Class
Represents a tool that selects objects in a designer, such as a mouse pointer.
Inheritance Hierarchy
System.Object
Microsoft.Windows.Design.ContextItem
Microsoft.Windows.Design.Interaction.Tool
Microsoft.Windows.Design.Interaction.SelectionTool
Namespace: Microsoft.Windows.Design.Interaction
Assembly: Microsoft.Windows.Design.Interaction (in Microsoft.Windows.Design.Interaction.dll)
Syntax
'Declaration
Public Class SelectionTool _
Inherits Tool
public class SelectionTool : Tool
public ref class SelectionTool : public Tool
type SelectionTool =
class
inherit Tool
end
public class SelectionTool extends Tool
The SelectionTool type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
.gif "Public method") |
SelectionTool | Initializes a new instance of the SelectionTool class. |
Top
Properties
| Name | Description | |
|---|---|---|
.gif "Protected property") |
Context | Gets the editing context for code within the tool. (Inherited from Tool.) |
.gif "Public property") |
Cursor | Gets or sets the default cursor for the mouse. (Inherited from Tool.) |
|
FocusedTask | Gets the currently focused task, if one exists. (Inherited from Tool.) |
|
ItemType | Gets the type of the tool. (Inherited from Tool.) |
|
Tasks | Gets the set of tasks this tool provides. (Inherited from Tool.) |
Top
Methods
| Name | Description | |
|---|---|---|
|
Equals | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
.gif "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.) |
|
GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
|
GetType | Gets the Type of the current instance. (Inherited from Object.) |
|
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
|
OnActivate | Called when a SelectionTool is activated. (Overrides Tool.OnActivate(Tool).) |
|
OnDeactivate | Called when a SelectionTool is deactivated. (Overrides Tool.OnDeactivate().) |
|
OnItemChanged | Adds activate and deactivate semantics to the Tool class. (Inherited from Tool.) |
|
ToString | Returns a string that represents the current object. (Inherited from Object.) |
Top
Remarks
The concept of selection is different for different types of designers. When a user selects objects in a designer, there are some standard behaviors the designer should exhibit. For example, the user should be able to select an object, select multiple objects, unselect objects, and select all objects. You can use extensibility to control how the user selects objects in the designer.
Note
Other types of selection not covered here include text selection, where a range of text on an object is selected, and point selection, where one or more points on a curve are selected. Complex selection patterns, such as dragging a rectangle to select several objects, are handled by the TaskProvider providers of those objects.
When multiple objects are selected in a designer, one object is the primary selection object. The primary selection object is often used as a key for other behaviors. For example, to align all selected objects to the left, the primary selection object determines where to align the objects.
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.Windows.Design.Interaction Namespace