FreeformActivityDesigner Class

Definition

Caution

The System.Workflow.* types are deprecated. Instead, please use the new types from System.Activities.*

Provides a customizable activity designer surface for users to visually modify on a workflow design surface.

public ref class FreeformActivityDesigner : System::Workflow::ComponentModel::Design::CompositeActivityDesigner
public class FreeformActivityDesigner : System.Workflow.ComponentModel.Design.CompositeActivityDesigner
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public class FreeformActivityDesigner : System.Workflow.ComponentModel.Design.CompositeActivityDesigner
type FreeformActivityDesigner = class
    inherit CompositeActivityDesigner
[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type FreeformActivityDesigner = class
    inherit CompositeActivityDesigner
Public Class FreeformActivityDesigner
Inherits CompositeActivityDesigner
Inheritance
Attributes

Remarks

Note

This material discusses types and namespaces that are obsolete. For more information, see Deprecated Types in Windows Workflow Foundation 4.5.

The FreeformActivityDesigner allows users to modify how an activity appears on a workflow design surface. When you associate FreeformActivityDesigner with a custom activity class using the Designer attribute, the custom activity's appearance is different from other activities when a user drops the custom activity onto a design surface. Once FreeformActivityDesigner displays an activity on the design surface, users can draw connectors to other activity designers and resize the designer within the parameters defined by the design surface.

Note

Users can only add connectors to the custom activity because the FreeformActivityDesigner is associated with the top-level activity in a workflow.

Constructors

FreeformActivityDesigner()

Initializes a new instance of the FreeformActivityDesigner class.

Properties

AccessibilityObject

Gets an AccessibleObject that accessibility applications use to adjust the application UI for users who have impairments.

Activity

Gets the Activity associated with the designer.

(Inherited from ActivityDesigner)
AutoSize

Gets or sets a value that indicates whether the FreeformActivityDesigner is resized automatically when a user resizes the designer's child designers.

AutoSizeMargin

Gets or sets the margin size to render around the child designers when the FreeformActivityDesigner is automatically resized.

AutoSizeMode

Gets or sets the AutoSizeMode settings for the FreeformActivityDesigner.

Bounds

Gets a Rectangle which contains the value for the enclosing rectangle of the designer in logical coordinates.

(Inherited from ActivityDesigner)
CanExpandCollapse

Gets a value that indicates whether the FreeformActivityDesigner can be collapsed on a workflow design surface.

Connectors

Gets a read-only collection of connectors that are associated with the FreeformActivityDesigner.

ContainedDesigners

Gets the array of ActivityDesigner contained within the CompositeActivityDesigner.

(Inherited from CompositeActivityDesigner)
DesignerActions

Gets the array of actions associated with configuration errors.

(Inherited from ActivityDesigner)
DesignerTheme

Gets the current designer theme for the activity designer.

(Inherited from ActivityDesigner)
EnableUserDrawnConnectors

Gets or sets a value that indicates whether users can drag and draw connectors on the free-form activity designer surface.

EnableVisualResizing

Gets a value that indicates whether the FreeformActivityDesigner can be visually resized on the workflow design surface.

ExpandButtonRectangle

Gets the Rectangle that contains the expand or collapse button.

(Inherited from CompositeActivityDesigner)
Expanded

Gets or sets a value that indicates whether the CompositeActivityDesigner is expanded.

(Inherited from CompositeActivityDesigner)
FirstSelectableObject

Gets the first selectable object in the navigation order of the FreeformActivityDesigner.

Glyphs

Gets the collection of glyphs that are displayed on the FreeformActivityDesigner.

Image

Gets or sets the Image associated with the designer.

(Inherited from ActivityDesigner)
ImageRectangle

Gets the value for the enclosing bounds of the image associated with the designer in logical coordinates.

(Inherited from CompositeActivityDesigner)
InvokingDesigner

Gets or sets the designer of the activity that invokes the activity associated with the current activity designer.

(Inherited from ActivityDesigner)
IsEditable

Gets a value that indicates whether the designer can be edited.

(Inherited from CompositeActivityDesigner)
IsLocked

Gets a value that indicates whether the activity associated with the designer can be modified.

(Inherited from ActivityDesigner)
IsPrimarySelection

Gets a value that indicates whether the activity associated with the designer is the primary selection.

(Inherited from ActivityDesigner)
IsRootDesigner

Gets a value that indicates whether the designer is a root designer.

(Inherited from ActivityDesigner)
IsSelected

Gets a value that indicates whether the activity associated with the designer is selected.

(Inherited from ActivityDesigner)
IsVisible

Gets a value that indicates whether the activity associated with the designer is visible on the workflow.

(Inherited from ActivityDesigner)
LastSelectableObject

Gets the last selectable object in the navigation order of the FreeformActivityDesigner.

Location

Gets or sets the location of the FreeformActivityDesigner in logical coordinates.

MessageFilters

Gets a read-only collection of message filters that are associated with the activity designer.

(Inherited from ActivityDesigner)
MinimumSize

Gets the minimum size settings for the FreeformActivityDesigner.

ParentDesigner

Gets the parent designer of the existing designer.

(Inherited from ActivityDesigner)
ParentView

Gets the workflow view that contains the current activity designer.

(Inherited from ActivityDesigner)
ShowConnectorsInForeground

Gets a value that indicates whether the FreeformActivityDesigner draws connectors in the foreground of its design surface.

ShowSmartTag

Gets a value that indicates whether the activity should show a smart tag.

(Inherited from ActivityDesigner)
Size

Gets or sets the size of the ActivityDesigner.

(Inherited from ActivityDesigner)
SmartTagRectangle

Gets the rectangle where the smart tag should be displayed.

(Inherited from ActivityDesigner)
SmartTagVerbs

Gets a read-only collection of designer actions to associate with a smart tag on the activity designer.

(Inherited from ActivityDesigner)
Text

Gets or sets the text to associate with the designer.

(Inherited from ActivityDesigner)
TextRectangle

Gets the value of the description rectangle in logical coordinates.

(Inherited from CompositeActivityDesigner)
TitleHeight

Gets the height of the title area of the designer.

(Inherited from CompositeActivityDesigner)
Verbs

Gets the collection of verbs to be associated with the designer.

(Inherited from ActivityDesigner)

Methods

AddConnector(ConnectionPoint, ConnectionPoint)

Adds a connector to the FreeformActivityDesigner.

BringToFront(ActivityDesigner)

Brings the specified ActivityDesigner to the top of the z-order of the FreeformActivityDesigner.

CanBeParentedTo(CompositeActivityDesigner)

Returns a value that indicates if a CompositeActivity can be set as the parent of the activity associated with the designer.

(Inherited from ActivityDesigner)
CanConnect(ConnectionPoint, ConnectionPoint)

Returns a value that indicates whether a connection can be created between the specified connection point on the current activity designer and the specified connection point on a target activity designer.

(Inherited from ActivityDesigner)
CanConnectContainedDesigners(ConnectionPoint, ConnectionPoint)

Returns a value that indicates whether the FreeformActivityDesigner can create a connection between the specified connection point on a source child activity designer and the specified connection point on a target child activity designer.

CanInsertActivities(HitTestInfo, ReadOnlyCollection<Activity>)

Returns a value that indicates whether activities can be inserted into the composite activity associated with the designer.

(Inherited from CompositeActivityDesigner)
CanMoveActivities(HitTestInfo, ReadOnlyCollection<Activity>)

Returns a value that indicates whether activities contained within the composite activity can be moved out of the composite activity associated with the designer.

(Inherited from CompositeActivityDesigner)
CanRemoveActivities(ReadOnlyCollection<Activity>)

Returns a value that indicates if activities can be removed from the composite activity associated with the designer.

(Inherited from CompositeActivityDesigner)
CanResizeContainedDesigner(ActivityDesigner)

Returns a value that indicates whether a user can visually resize the specified child activity designer in the FreeformActivityDesigner.

CreateConnector(ConnectionPoint, ConnectionPoint)

Creates a connector between the two specified connection points.

CreateView(ViewTechnology)

Creates a workflow view for the current activity designer using the specified ViewTechnology.

(Inherited from ActivityDesigner)
Dispose()

Releases the unmanaged resources used by the ActivityDesigner and optionally releases the managed resources.

(Inherited from ActivityDesigner)
Dispose(Boolean)

Releases the unmanaged resources used by the FreeformActivityDesigner and optionally releases the managed resources.

DoDefaultAction()

Performs the default UI action associated with the designer.

(Inherited from ActivityDesigner)
EnsureVisible()

Shifts the visible area of the screen to guarantee that the specified designer is visible.

(Inherited from ActivityDesigner)
EnsureVisibleContainedDesigner(ActivityDesigner)

Verifies that the contained designer is visible.

(Inherited from CompositeActivityDesigner)
Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetConnectionPoints(DesignerEdges)

Returns a read-only collection of connection points for the activity designer along the specified DesignerEdges.

(Inherited from ActivityDesigner)
GetConnections(DesignerEdges)

Returns a read-only collection of points that the designer uses for connections.

(Inherited from ActivityDesigner)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetNextSelectableObject(Object, DesignerNavigationDirection)

Returns the first selectable object that follows the specified object in the navigation order of the current FreeformActivityDesigner.

GetPreviewImage(Graphics)

Gets the image of the activity designer on the specified Graphics.

(Inherited from ActivityDesigner)
GetService(Type)

Tries to retrieve the specified type of service from the design mode site for the activity associated with the designer.

(Inherited from ActivityDesigner)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
HitTest(Point)

Returns information about the FreeformActivityDesigner at the specified coordinates on the workflow design surface.

Initialize(Activity)

Initializes the FreeformActivityDesigner by using the specified Activity.

InsertActivities(HitTestInfo, ReadOnlyCollection<Activity>)

Adds the specified read-only collection of activities to the FreeformActivityDesigner at the specified location on the workflow design surface.

Invalidate()

Invalidates the designer.

(Inherited from ActivityDesigner)
Invalidate(Rectangle)

Invalidates the specified rectangle on the designer.

(Inherited from ActivityDesigner)
IsContainedDesignerVisible(ActivityDesigner)

Gets a value that indicates if the contained designer is visible.

(Inherited from CompositeActivityDesigner)
IsSupportedActivityType(Type)

Returns a value that indicates whether the specified activity type is supported if the activity designer is a root designer.

(Inherited from ActivityDesigner)
LoadViewState(BinaryReader)

Restores the view state from a binary stream.

(Inherited from CompositeActivityDesigner)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
MoveActivities(HitTestInfo, ReadOnlyCollection<Activity>)

Moves activities to a specified location within the design surface.

MoveContainedDesigner(ActivityDesigner, Point)

Moves the specified ActivityDesigner to the specified location.

OnActivityChanged(ActivityChangedEventArgs)

Notifies the ActivityDesigner when the activity it is associated with changes.

(Inherited from ActivityDesigner)
OnBeginResizing(ActivityDesignerResizeEventArgs)

Notifies the ActivityDesigner when a user starts to visually resize the activity designer when the designer is in a FreeformActivityDesigner.

(Inherited from ActivityDesigner)
OnConnected(ConnectionPoint, ConnectionPoint)

Notifies the ActivityDesigner when a connection is established between two connection points.

(Inherited from ActivityDesigner)
OnConnectorAdded(ConnectorEventArgs)

Raises the ConnectorAdded event.

OnConnectorChanged(ConnectorEventArgs)

Raises the ConnectorChanged event.

OnConnectorRemoved(ConnectorEventArgs)

Raises the ConnectorRemoved event.

OnContainedActivitiesChanged(ActivityCollectionChangeEventArgs)

Occurs when more than one activities contained within the designers have changed. This occurs, for example, when a new child activity is added or an existing child activity is removed.

(Inherited from CompositeActivityDesigner)
OnContainedActivitiesChanging(ActivityCollectionChangeEventArgs)

Notifies the FreeformActivityDesigner when a child activity is added or deleted from its Activities collection.

OnContainedActivityChanged(ActivityChangedEventArgs)

Occurs when an activity contained within the designer has changed.

(Inherited from CompositeActivityDesigner)
OnContainedDesignersConnected(ConnectionPoint, ConnectionPoint)

Notifies the FreeformActivityDesigner when a connection has been established between two of its contained activity designers.

OnDragDrop(ActivityDragEventArgs)

Notifies the FreeformActivityDesigner when a drag-drop operation is completed within the bounds of its design surface.

OnDragEnter(ActivityDragEventArgs)

Occurs when the drag-drop operation is in progress and the pointer enters the designer bounds.

(Inherited from ActivityDesigner)
OnDragLeave()

Occurs when the drag-drop operation is in progress and the pointer leaves the designer bounds.

(Inherited from ActivityDesigner)
OnDragOver(ActivityDragEventArgs)

Notifies the FreeformActivityDesigner when a drag-drop operation is in progress and the user's mouse cursor is inside the bounds of the designer.

OnEndResizing()

Notifies the ActivityDesigner when a user is finished visually resizing the activity designer when the designer is in a FreeformActivityDesigner.

(Inherited from ActivityDesigner)
OnExecuteDesignerAction(DesignerAction)

Notifies the ActivityDesigner when the user clicks on the configuration errors associated with the designer.

(Inherited from ActivityDesigner)
OnGiveFeedback(GiveFeedbackEventArgs)

Updates the visual cues for feedback supplied to the user when performing a drag operation.

(Inherited from ActivityDesigner)
OnKeyDown(KeyEventArgs)

Occurs when a key is pressed when the designer has the keyboard focus.

OnKeyUp(KeyEventArgs)

Occurs when a key is released when the designer has keyboard focus.

(Inherited from ActivityDesigner)
OnLayoutPosition(ActivityDesignerLayoutEventArgs)

Performs layout tasks to position visual cues and child designers on the FreeformActivityDesigner.

OnLayoutSize(ActivityDesignerLayoutEventArgs)

Notifies the FreeformActivityDesigner when the size of the visual cues on the designers displayed by the FreeformActivityDesigner have changed.

OnMouseCaptureChanged()

Occurs when the mouse capture changes.

(Inherited from ActivityDesigner)
OnMouseDoubleClick(MouseEventArgs)

Occurs when the mouse button is clicked multiple times on the designer.

(Inherited from ActivityDesigner)
OnMouseDown(MouseEventArgs)

Called when the mouse is clicked when the pointer is in designer bounds.

(Inherited from CompositeActivityDesigner)
OnMouseDragBegin(Point, MouseEventArgs)

Occurs when the user starts to drag the mouse on the designer.

(Inherited from ActivityDesigner)
OnMouseDragEnd()

Occurs when the user stops dragging the mouse on the designer.

(Inherited from ActivityDesigner)
OnMouseDragMove(MouseEventArgs)

Occurs on each movement of the mouse as the user drags the pointer over the designer.

(Inherited from ActivityDesigner)
OnMouseEnter(MouseEventArgs)

Occurs when the mouse first enters the designer bounds.

(Inherited from ActivityDesigner)
OnMouseHover(MouseEventArgs)

Occurs when the pointer is in designer bounds.

(Inherited from ActivityDesigner)
OnMouseLeave()

Occurs when the pointer leaves designer bounds.

(Inherited from ActivityDesigner)
OnMouseMove(MouseEventArgs)

Occurs when the pointer is moving in designer bounds.

(Inherited from ActivityDesigner)
OnMouseUp(MouseEventArgs)

Occurs when the mouse button is released when the pointer is in designer bounds.

(Inherited from ActivityDesigner)
OnPaint(ActivityDesignerPaintEventArgs)

Draws the visual representation of a composite activity at design time.

(Inherited from CompositeActivityDesigner)
OnProcessMessage(Message)

Allows the designer to process raw Win32 messages.

(Inherited from ActivityDesigner)
OnQueryContinueDrag(QueryContinueDragEventArgs)

Controls whether the drag operation should continue.

(Inherited from ActivityDesigner)
OnResizing(ActivityDesignerResizeEventArgs)

Notifies the FreeformActivityDesigner when a user is visually resizing it at design time.

OnScroll(ScrollBar, Int32)

Notifies the ActivityDesigner when a user changes the scroll position.

(Inherited from ActivityDesigner)
OnShowSmartTagVerbs(Point)

Displays the designer verbs associated with a smart tag at the specified point.

(Inherited from ActivityDesigner)
OnSmartTagVisibilityChanged(Boolean)

Notifies the ActivityDesigner whether a smart tag should be displayed or hidden.

(Inherited from ActivityDesigner)
OnThemeChange(ActivityDesignerTheme)

Notifies the FreeformActivityDesigner that its associated theme has changed.

PaintContainedDesigners(ActivityDesignerPaintEventArgs)

Adjusts the clip region on the graphics object and calls OnPaint(ActivityDesignerPaintEventArgs) on all contained designers.

(Inherited from CompositeActivityDesigner)
PerformLayout()

Updates the layout of the designer.

(Inherited from ActivityDesigner)
PointToLogical(Point)

Transforms a point from screen coordinate system to the activity designer coordinate system.

(Inherited from ActivityDesigner)
PointToScreen(Point)

Transforms a point from the activity designer coordinate system to the screen coordinate system.

(Inherited from ActivityDesigner)
PostFilterAttributes(IDictionary)

When overridden in a derived class, allows a designer to change or remove items from the set of attributes that it exposes through a TypeDescriptor.

(Inherited from ActivityDesigner)
PostFilterEvents(IDictionary)

When overridden in a derived class, allows the designer to change or remove items from the set of events that it exposes through a TypeDescriptor.

(Inherited from ActivityDesigner)
PostFilterProperties(IDictionary)

When overridden in a derived class, allows a designer to change or remove items from the set of properties that it exposes through a TypeDescriptor.

(Inherited from ActivityDesigner)
PreFilterAttributes(IDictionary)

When overridden in a derived class, allows a designer to add items to the set of attributes that it exposes through a TypeDescriptor.

(Inherited from ActivityDesigner)
PreFilterEvents(IDictionary)

When overridden in a derived class, allows a designer to add items to the set of events that it exposes through a TypeDescriptor.

(Inherited from ActivityDesigner)
PreFilterProperties(IDictionary)

When overridden in a derived class, allows a designer to add items to the set of properties that it exposes through a TypeDescriptor.

(Inherited from ActivityDesigner)
RectangleToLogical(Rectangle)

Transforms a rectangle from the screen coordinate system to the activity designer coordinate system.

(Inherited from ActivityDesigner)
RectangleToScreen(Rectangle)

Transforms a rectangle from the activity designer coordinate system to the screen coordinate system.

(Inherited from ActivityDesigner)
RefreshDesignerActions()

Refreshes the configuration errors associated with the designer.

(Inherited from ActivityDesigner)
RefreshDesignerVerbs()

Refreshes the activity designer verbs associated with the designer by calling the status handler.

(Inherited from ActivityDesigner)
RemoveActivities(ReadOnlyCollection<Activity>)

Removes a list of activities from the composite activity designer.

(Inherited from CompositeActivityDesigner)
RemoveConnector(Connector)

Removes the specified Connector from the FreeformActivityDesigner.

ResizeContainedDesigner(ActivityDesigner, Size)

Resizes the specified ActivityDesigner to the dimensions of specified size.

SaveViewState(BinaryWriter)

Saves the view state to a binary stream.

(Inherited from CompositeActivityDesigner)
SendToBack(ActivityDesigner)

Sets the specified ActivityDesigner to the bottom of the z-order of the FreeformActivityDesigner.

ShowInfoTip(String)

Shows the specified info tip.

(Inherited from ActivityDesigner)
ShowInfoTip(String, String)

Displays the info tip for the ActivityDesigner with the specified title and text.

(Inherited from ActivityDesigner)
ShowInPlaceTip(String, Rectangle)

Displays the specified tool tip in the specified rectangle location.

(Inherited from ActivityDesigner)
ToString()

Returns a string that represents the current object.

(Inherited from Object)

Events

ConnectorAdded

Occurs when a Connector is added to the FreeformActivityDesigner.

ConnectorChanged

Occurs when a user changes the ConnectionPoint locations associated with a Connector displayed by the FreeformActivityDesigner.

ConnectorRemoved

Occurs when a user removes a connector from the FreeformActivityDesigner.

Explicit Interface Implementations

IDesigner.Component

Gets the base component with which the activity designer is associated.

(Inherited from ActivityDesigner)
IDesigner.DoDefaultAction()

Performs the default action associated with the designer.

(Inherited from ActivityDesigner)
IDesigner.Initialize(IComponent)

Initializes the designer with the associated activity.

(Inherited from ActivityDesigner)
IDesigner.Verbs

Gets the design-time verbs associated with the activity designer.

(Inherited from ActivityDesigner)
IDesignerFilter.PostFilterAttributes(IDictionary)

When overridden in a derived class, allows a designer to change or remove items from the set of attributes that it exposes through a TypeDescriptor.

(Inherited from ActivityDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)

When overridden in a derived class, allows a designer to change or remove items from the set of events that it exposes through a TypeDescriptor.

(Inherited from ActivityDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)

When overridden in a derived class, allows a designer to change or remove items from the set of properties that it exposes through a TypeDescriptor.

(Inherited from ActivityDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)

When overridden in a derived class, allows a designer to add items to the set of attributes that it exposes through a TypeDescriptor.

(Inherited from ActivityDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)

When overridden in a derived class, allows a designer to add items to the set of events that it exposes through a TypeDescriptor.

(Inherited from ActivityDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)

When overridden in a derived class, allows a designer to add items to the set of properties that it exposes through a TypeDescriptor.

(Inherited from ActivityDesigner)
IPersistUIState.LoadViewState(BinaryReader)

Restores the view state from a binary stream.

(Inherited from ActivityDesigner)
IPersistUIState.SaveViewState(BinaryWriter)

Saves the view state to a binary stream.

(Inherited from ActivityDesigner)
IRootDesigner.GetView(ViewTechnology)

Returns a view object for the specified view technology.

(Inherited from ActivityDesigner)
IRootDesigner.SupportedTechnologies

Gets the array of technologies that the activity designer can support for its display.

(Inherited from ActivityDesigner)
IToolboxUser.GetToolSupported(ToolboxItem)

Determines whether the specified Toolbox item is supported by the current activity designer.

(Inherited from ActivityDesigner)
IToolboxUser.ToolPicked(ToolboxItem)

Selects the specified toolbox item.

(Inherited from ActivityDesigner)
IWorkflowRootDesigner.InvokingDesigner

Gets or sets the CompositeActivityDesigner that requested the activity designer be initialized.

(Inherited from ActivityDesigner)
IWorkflowRootDesigner.IsSupportedActivityType(Type)

Returns a value that indicates whether the specified type is supported on the current ActivityDesigner.

(Inherited from ActivityDesigner)
IWorkflowRootDesigner.MessageFilters

Gets any message filters associated with the activity designer.

(Inherited from ActivityDesigner)
IWorkflowRootDesigner.SupportsLayoutPersistence

Gets the value that indicates whether the actual workflow root designer supports the layout persistence.

(Inherited from ActivityDesigner)

Applies to