WorkflowDesignerMessageFilter 類別

定義

命名空間:

System.Workflow.ComponentModel.Design

組件:

System.Workflow.ComponentModel.dll

警告

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

對所有工作流程訊息篩選條件提供基底類別。

public ref class WorkflowDesignerMessageFilter abstract : IDisposable

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

[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type WorkflowDesignerMessageFilter = class
    interface IDisposable

Public MustInherit Class WorkflowDesignerMessageFilter
Implements IDisposable

繼承

Object

WorkflowDesignerMessageFilter

屬性

ObsoleteAttribute

實作

IDisposable

範例

下列程式碼範例示範衍生自 WorkflowDesignerMessageFilter 的自訂設計工具訊息篩選條件。 名稱為 CustomMessageFilter 的類別會覆寫一些基底類別方法，包括 OnMouseDown、OnMouseMove、OnMouseUp、OnMouseDoubleClick、OnMouseEnter、OnMouseHover、OnMouseLeave、OnDragEnter、OnDragOver 和 OnKeyDown。

這個程式碼範例是 DesignerShell.cs 檔案中＜Basic Designer Hosting SDK＞範例的一部分。 如需詳細資訊，請參閱基本Designer裝載。

internal sealed class CustomMessageFilter : WorkflowDesignerMessageFilter
{
    #region Members and Constructor

    private bool mouseDown;
    private IServiceProvider serviceProvider;
    private WorkflowView workflowView;
    private WorkflowDesignerLoader loader;

    public CustomMessageFilter(IServiceProvider provider, WorkflowView workflowView, WorkflowDesignerLoader loader)
    {
        this.serviceProvider = provider;
        this.workflowView = workflowView;
        this.loader = loader;
    }

    #endregion

    #region MessageFilter Overridables

    protected override bool OnMouseDown(MouseEventArgs eventArgs)
    {
        //Allow other components to process this event by not returning true.
        this.mouseDown = true;
        return false;
    }

    protected override bool OnMouseMove(MouseEventArgs eventArgs)
    {
        //Allow other components to process this event by not returning true.
        if (mouseDown)
        {
            workflowView.ScrollPosition = new Point(eventArgs.X, eventArgs.Y);
        }
        return false;
    }

    protected override bool OnMouseUp(MouseEventArgs eventArgs)
    {
        //Allow other components to process this event by not returning true.
        mouseDown = false;
        return false;
    }

    protected override bool OnMouseDoubleClick(MouseEventArgs eventArgs)
    {
        mouseDown = false;
        return true;
    }

    protected override bool OnMouseEnter(MouseEventArgs eventArgs)
    {
        //Allow other components to process this event by not returning true.
        mouseDown = false;
        return false;
    }

    protected override bool OnMouseHover(MouseEventArgs eventArgs)
    {
        //Allow other components to process this event by not returning true.
        mouseDown = false;
        return false;
    }

    protected override bool OnMouseLeave()
    {
        //Allow other components to process this event by not returning true.
        mouseDown = false;
        return false;
    }

    protected override bool OnMouseWheel(MouseEventArgs eventArgs)
    {
        mouseDown = false;
        return true;
    }

    protected override bool OnMouseCaptureChanged()
    {
        //Allow other components to process this event by not returning true.
        mouseDown = false;
        return false;
    }

    protected override bool OnDragEnter(DragEventArgs eventArgs)
    {
        return true;
    }

    protected override bool OnDragOver(DragEventArgs eventArgs)
    {
        return true;
    }

    protected override bool OnDragLeave()
    {
        return true;
    }

    protected override bool OnDragDrop(DragEventArgs eventArgs)
    {
        return true;
    }

    protected override bool OnGiveFeedback(GiveFeedbackEventArgs gfbevent)
    {
        return true;
    }

    protected override bool OnQueryContinueDrag(QueryContinueDragEventArgs qcdevent)
    {
        return true;
    }

    protected override bool OnKeyDown(KeyEventArgs eventArgs)
    {
        if (eventArgs.KeyCode == Keys.Delete)
        {
            ISelectionService selectionService = (ISelectionService)serviceProvider.GetService(typeof(ISelectionService));
            if (selectionService != null && selectionService.PrimarySelection is CodeActivity)
            {
                CodeActivity codeActivityComponent = (CodeActivity)selectionService.PrimarySelection;
                CompositeActivity parentActivity = codeActivityComponent.Parent;
                if (parentActivity != null)
                {
                    parentActivity.Activities.Remove(codeActivityComponent);
                    this.ParentView.Update();
                }
                loader.RemoveActivityFromDesigner(codeActivityComponent);
            }
        }
        return true;
    }

    protected override bool OnKeyUp(KeyEventArgs eventArgs)
    {
        return true;
    }

    protected override bool OnShowContextMenu(Point menuPoint)
    {
        return true;
    }

    #endregion
}

    Friend NotInheritable Class CustomMessageFilter
        Inherits WorkflowDesignerMessageFilter

#Region "Members and Constructor"

        Private mouseDown As Boolean
        Private serviceProvider As IServiceProvider
        Private workflowView As WorkflowView
        Private loader As WorkflowDesignerLoader

        Public Sub New(ByVal provider As IServiceProvider, ByVal workflowView As WorkflowView, ByVal loader As WorkflowDesignerLoader)
            Me.serviceProvider = provider
            Me.workflowView = workflowView
            Me.loader = loader
        End Sub

#End Region

#Region "WorkflowDesignerMessageFilter Overridables"

        Protected Overrides Function OnMouseDown(ByVal eventArgs As System.Windows.Forms.MouseEventArgs) As Boolean
            ' Allow other components to process this event by not returning true.
            mouseDown = True
            Return False
        End Function

        Protected Overrides Function OnMouseMove(ByVal eventArgs As System.Windows.Forms.MouseEventArgs) As Boolean
            ' Allow other components to process this event by not returning true.
            If mouseDown Then
                workflowView.ScrollPosition = New Point(eventArgs.X, eventArgs.Y)
            End If
            Return False
        End Function

        Protected Overrides Function OnMouseUp(ByVal eventArgs As MouseEventArgs) As Boolean
            ' Allow other components to process this event by not returning true.
            mouseDown = False
            Return False
        End Function

        Protected Overrides Function OnMouseDoubleClick(ByVal eventArgs As MouseEventArgs) As Boolean
            mouseDown = False
            Return True
        End Function

        Protected Overrides Function OnMouseEnter(ByVal eventArgs As MouseEventArgs) As Boolean
            ' Allow other components to process this event by not returning true.
            mouseDown = False
            Return False
        End Function

        Protected Overrides Function OnMouseHover(ByVal eventArgs As MouseEventArgs) As Boolean
            ' Allow other components to process this event by not returning true.
            mouseDown = False
            Return False
        End Function

        Protected Overrides Function OnMouseLeave() As Boolean
            ' Allow other components to process this event by not returning true.
            mouseDown = False
            Return False
        End Function

        Protected Overrides Function OnMouseWheel(ByVal eventArgs As MouseEventArgs) As Boolean
            mouseDown = False
            Return True
        End Function

        Protected Overrides Function OnMouseCaptureChanged() As Boolean
            ' Allow other components to process this event by not returning true.
            mouseDown = False
            Return False
        End Function

        Protected Overrides Function OnDragEnter(ByVal eventArgs As DragEventArgs) As Boolean
            Return True
        End Function

        Protected Overrides Function OnDragOver(ByVal eventArgs As DragEventArgs) As Boolean
            Return True
        End Function

        Protected Overrides Function OnDragLeave() As Boolean
            Return True
        End Function

        Protected Overrides Function OnDragDrop(ByVal eventArgs As DragEventArgs) As Boolean
            Return True
        End Function

        Protected Overrides Function OnGiveFeedback(ByVal gfbevent As GiveFeedbackEventArgs) As Boolean
            Return True
        End Function

        Protected Overrides Function OnQueryContinueDrag(ByVal qcdevent As QueryContinueDragEventArgs) As Boolean
            Return True
        End Function

        Protected Overrides Function OnKeyDown(ByVal eventArgs As KeyEventArgs) As Boolean
            If eventArgs.KeyCode = Keys.Delete Then
                Dim selectionService As ISelectionService = CType(serviceProvider.GetService(GetType(ISelectionService)), ISelectionService)
                If selectionService IsNot Nothing AndAlso TypeOf selectionService.PrimarySelection Is CodeActivity Then
                    Dim codeActivityComponent As CodeActivity = CType(selectionService.PrimarySelection, CodeActivity)
                    Dim parentActivity As CompositeActivity = codeActivityComponent.Parent
                    If parentActivity IsNot Nothing Then
                        parentActivity.Activities.Remove(codeActivityComponent)
                        Me.ParentView.Update()
                    End If
                    loader.RemoveActivityFromDesigner(codeActivityComponent)
                End If
            End If
            Return True
        End Function

        Protected Overrides Function OnKeyUp(ByVal eventArgs As KeyEventArgs) As Boolean
            Return True
        End Function

        Protected Overrides Function OnShowContextMenu(ByVal menuPoint As Point) As Boolean
            Return True
        End Function

#End Region

    End Class

備註

注意

此資料討論已被汰換的類型及命名空間。 如需詳細資訊，請參閱 Windows Workflow Foundation 4.5 中即將淘汰的類型。

工作流程設計工具會提供 Strategy 設計模式，以建立可取代的訊息篩選物件來處理事件。

衍生自 WorkflowDesignerMessageFilter 類別，可建立會回應至工作流程設計工具事件 (例如拖曳作業、配置和繪製作業以及其他設計工具事件) 的訊息篩選條件。 若要將自訂訊息篩選條件新增至訊息篩選條件鏈結，請呼叫 AddDesignerMessageFilter 上的 WorkflowView，或覆寫自訂根活動上的 MessageFilters 虛擬屬性，並將自訂訊息篩選條件新增至從基底類別傳回的集合。

建構函式

WorkflowDesignerMessageFilter()

已淘汰. 在衍生類別中實作時，初始化 WorkflowDesignerMessageFilter 的執行個體。

屬性

MessageHitTestContext	已淘汰. 取得 HitTestInfo，而這會描述 WorkflowDesignerMessageFilter 的內容。
ParentView	已淘汰. 取得與 WorkflowView 關聯的 WorkflowDesignerMessageFilter。

方法

Dispose()	已淘汰. 釋放 WorkflowDesignerMessageFilter 使用的資源。
Dispose(Boolean)	已淘汰. 釋放 WorkflowDesignerMessageFilter 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。
Equals(Object)	已淘汰. 判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Finalize()	已淘汰. 藉由在記憶體回收收回物件前呼叫 Dispose(false) 的方法，嘗試釋放資源。
GetHashCode()	已淘汰. 做為預設雜湊函式。 (繼承來源 Object)
GetType()	已淘汰. 取得目前執行個體的 Type。 (繼承來源 Object)
Initialize(WorkflowView)	已淘汰. 使用關聯的 WorkflowDesignerMessageFilter 初始化 WorkflowView。
MemberwiseClone()	已淘汰. 建立目前 Object 的淺層複製。 (繼承來源 Object)
OnDragDrop(DragEventArgs)	已淘汰. 發生於使用者在拖曳作業期間於物件上放開滑鼠按鈕時。
OnDragEnter(DragEventArgs)	已淘汰. 發生於使用者在拖曳作業期間，滑鼠指標進入物件範圍時。
OnDragLeave()	已淘汰. 發生於使用者在拖曳作業期間，滑鼠指標離開物件範圍時。
OnDragOver(DragEventArgs)	已淘汰. 發生於使用者在拖曳作業期間，滑鼠指標在物件範圍內移動時。
OnGiveFeedback(GiveFeedbackEventArgs)	已淘汰. 發生於拖曳作業時。
OnKeyDown(KeyEventArgs)	已淘汰. 發生於按下按鍵時。
OnKeyUp(KeyEventArgs)	已淘汰. 發生於放開按鍵時。
OnLayout(LayoutEventArgs)	已淘汰. 發生於應該可以重新定位子物件時。
OnMouseCaptureChanged()	已淘汰. 發生於透過滑鼠拖曳所選擇的項目變更時。
OnMouseDoubleClick(MouseEventArgs)	已淘汰. 發生於按兩下滑鼠時。
OnMouseDown(MouseEventArgs)	已淘汰. 發生於按一下滑鼠按鈕時。
OnMouseEnter(MouseEventArgs)	已淘汰. 發生於滑鼠指標進入物件的範圍時。
OnMouseHover(MouseEventArgs)	已淘汰. 發生於滑鼠指標在物件上暫停時。
OnMouseLeave()	已淘汰. 發生於滑鼠指標離開物件的範圍時。
OnMouseMove(MouseEventArgs)	已淘汰. 發生於滑鼠指標在物件的範圍內移動時。
OnMouseUp(MouseEventArgs)	已淘汰. 發生於放開滑鼠按鈕時。
OnMouseWheel(MouseEventArgs)	已淘汰. 發生於滑鼠滾輪移動時。
OnPaint(PaintEventArgs, Rectangle, AmbientTheme)	已淘汰. 發生於接收繪製訊息時。
OnPaintWorkflowAdornments(PaintEventArgs, Rectangle, AmbientTheme)	已淘汰. 發生於工作流程應該重新繪製其裝飾時。
OnQueryContinueDrag(QueryContinueDragEventArgs)	已淘汰. 發生於拖曳作業時。
OnScroll(ScrollBar, Int32)	已淘汰. 發生於使用者在工作流程設計工具中捲動時。
OnShowContextMenu(Point)	已淘汰. 發生於工作流程應該顯示操作功能表時。
OnThemeChange()	已淘汰. 發生於工作流程的主題變更時。
ProcessMessage(Message)	已淘汰. 發生於需要處理未經處理的 Win32 訊息時。
ToString()	已淘汰. 傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• 基本Designer裝載