Selection Class

Represents a set of objects selected by a user in a designer.

Inheritance Hierarchy

System.Object
  Microsoft.Windows.Design.ContextItem
    Microsoft.Windows.Design.Interaction.Selection

Namespace:  Microsoft.Windows.Design.Interaction
Assembly:  Microsoft.Windows.Design.Interaction (in Microsoft.Windows.Design.Interaction.dll)

Syntax

'Declaration
Public Class Selection _
    Inherits ContextItem

public class Selection : ContextItem

public ref class Selection : public ContextItem

type Selection =  
    class
        inherit ContextItem
    end

public class Selection extends ContextItem

The Selection type exposes the following members.

Constructors

	Name	Description
	Selection()	Initializes a new instance of the Selection class.
	Selection(IEnumerable)	Initializes a new instance of the Selection class with the specified enumeration of objects.
	Selection(array<ModelItem[])	Initializes a new instance of the Selection class with the specified array of ModelItem objects.
	Selection(IEnumerable<ModelItem>)	Initializes a new instance of the Selection class with the specified enumeration of ModelItem objects.
	Selection(IEnumerable, Predicate<ModelItem>)	Initializes a new instance of the Selection class with the specified enumeration of objects and predicate.
	Selection(IEnumerable<ModelItem>, Predicate<ModelItem>)	Initializes a new instance of the Selection class by using the specified enumeration of ModelItem objects and predicate.

Top

Properties

	Name	Description
	ItemType	Gets the type of Selection. (Overrides ContextItem.ItemType.)
	PrimarySelection	Gets the primary selection object.
	SelectedObjects	Gets an enumeration of the objects in the selection.
	SelectionCount	Gets the number of objects in the selection.
	ViewSelection	Gets a selection that contains model items that provide a view.

Top

Methods

	Name	Description
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	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.)
	OnItemChanged	Called on a context item before it is stored in the context item manager. (Inherited from ContextItem.)
	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, cancel the selection of objects, and select all objects. You can use extensibility to control how the user selects objects in the designer.

Note

Other types of selection that are 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

SelectionCommands

SelectionOperations

SelectionTool

EditingContext

Other Resources

WPF Designer Extensibility Architecture