Export (0) Print
Expand All

WorkflowDesignerMessageFilter Class

Note: This API is now obsolete.

Provides a base class for all workflow message filters.


Namespace:  System.Workflow.ComponentModel.Design
Assembly:  System.Workflow.ComponentModel (in System.Workflow.ComponentModel.dll)

[ObsoleteAttribute(L"The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public ref class WorkflowDesignerMessageFilter abstract : IDisposable

The WorkflowDesignerMessageFilter type exposes the following members.

Protected methodWorkflowDesignerMessageFilterWhen implemented in a derived class, initializes an instance of a WorkflowDesignerMessageFilter.

Protected propertyMessageHitTestContextGets the HitTestInfo that describes the context of the WorkflowDesignerMessageFilter.
Protected propertyParentViewGets the WorkflowView that is associated with the WorkflowDesignerMessageFilter.

Public methodDispose()Releases the resources used by the WorkflowDesignerMessageFilter.
Protected methodDispose(Boolean)Releases the unmanaged resources used by the WorkflowDesignerMessageFilter and optionally releases the managed resources.
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAttempts to free resources by calling Dispose(false) before the object is reclaimed by garbage collection. (Overrides Object::Finalize().)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodInitializeInitializes the WorkflowDesignerMessageFilter with the associated WorkflowView.
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Protected methodOnDragDropOccurs when the mouse button is released above an object during a drag operation.
Protected methodOnDragEnterOccurs when the mouse pointer enters the bounds of an object during a drag operation.
Protected methodOnDragLeaveOccurs when the mouse pointer leaves the bounds of an object during a drag operation.
Protected methodOnDragOverOccurs when the mouse pointer moves within the bounds of an object during a drag operation.
Protected methodOnGiveFeedbackOccurs during a drag operation.
Protected methodOnKeyDownOccurs when a key is pressed.
Protected methodOnKeyUpOccurs when a key is released.
Protected methodOnLayoutOccurs when child objects should be repositioned.
Protected methodOnMouseCaptureChangedOccurs when the items selected by dragging the mouse changes.
Protected methodOnMouseDoubleClickOccurs when you double-click the mouse.
Protected methodOnMouseDownOccurs when a mouse button is clicked.
Protected methodOnMouseEnterOccurs when the mouse pointer enters the bounds of an object.
Protected methodOnMouseHoverOccurs when the mouse pointer pauses above an object.
Protected methodOnMouseLeaveOccurs when the mouse pointer leaves the bounds of an object.
Protected methodOnMouseMoveOccurs when the mouse pointer moves while within the bounds of an object.
Protected methodOnMouseUpOccurs when the mouse button is released.
Protected methodOnMouseWheelOccurs when the mouse wheel moves.
Protected methodOnPaintOccurs when a paint message is received.
Protected methodOnPaintWorkflowAdornmentsOccurs when the workflow should repaint its adornments.
Protected methodOnQueryContinueDragOccurs during a drag operation.
Protected methodOnScrollOccurs when a user scrolls in a workflow designer.
Protected methodOnShowContextMenuOccurs when the workflow should show a context menu.
Protected methodOnThemeChangeOccurs when the theme of the workflow changes.
Protected methodProcessMessageOccurs when a raw Win32 message must be processed.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)


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

The workflow designer provides a Strategy design pattern to create replaceable message filter objects to handle events.

Derive from the WorkflowDesignerMessageFilter class to create message filters that can respond to workflow designer events, such as drag operations, layout and paint operations, and other designer events. To add a custom message filter to the message filters chain, call the AddDesignerMessageFilter on the WorkflowView or override the MessageFilters virtual property on the custom root activity and add the custom message filter to the collection returned from the base class.

The following code example shows a custom designer message filter that derives from WorkflowDesignerMessageFilter. The class, named CustomMessageFilter, overrides a number of its base class methods including OnMouseDown, OnMouseMove, OnMouseUp, OnMouseDoubleClick, OnMouseEnter, OnMouseHover, OnMouseLeave, OnDragEnter, OnDragOver, and OnKeyDown.

This code example is part of the Basic Designer Hosting SDK Sample from the DesignerShell.cs file. For more information, see Basic Designer Hosting.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0
Obsolete (compiler warning) in 4.6
Obsolete (compiler warning) in 4.5
Obsolete (compiler warning) in 4.5.1
Obsolete (compiler warning) in 4.5.2

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

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