DispatcherFrame DispatcherFrame DispatcherFrame DispatcherFrame Class

Definition

Dispatcher 内の実行ループを表します。 Represents an execution loop in the Dispatcher.

public ref class DispatcherFrame : System::Windows::Threading::DispatcherObject
public class DispatcherFrame : System.Windows.Threading.DispatcherObject
type DispatcherFrame = class
    inherit DispatcherObject
Public Class DispatcherFrame
Inherits DispatcherObject
Inheritance
DispatcherFrameDispatcherFrameDispatcherFrameDispatcherFrame

Examples

次の例は、使用する方法を示します、DispatcherFrameと同様の結果を実現するために、 Windows フォームWindows Forms DoEventsメソッド。The following example shows how to use a DispatcherFrame to achieve similar results as the Windows フォームWindows Forms DoEvents method.

[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)]
public void DoEvents()
{
    DispatcherFrame frame = new DispatcherFrame();
    Dispatcher.CurrentDispatcher.BeginInvoke(DispatcherPriority.Background,
        new DispatcherOperationCallback(ExitFrame), frame);
    Dispatcher.PushFrame(frame);
}

public object ExitFrame(object f)
{
    ((DispatcherFrame)f).Continue = false;
   
    return null;
}
<SecurityPermissionAttribute(SecurityAction.Demand, Flags := SecurityPermissionFlag.UnmanagedCode)>
Public Sub DoEvents()
	Dim frame As New DispatcherFrame()
	Dispatcher.CurrentDispatcher.BeginInvoke(DispatcherPriority.Background, New DispatcherOperationCallback(AddressOf ExitFrame), frame)
	Dispatcher.PushFrame(frame)
End Sub

Public Function ExitFrame(ByVal f As Object) As Object
	CType(f, DispatcherFrame).Continue = False

	Return Nothing
End Function

Remarks

DispatcherFrame オブジェクトは、通常、2 つのカテゴリに分類されます。DispatcherFrame objects typically fall into two categories:

  • 実行時間の長い、一般的な目的のフレームに指示があった場合に終了します。Long running, general purpose frames that exit only when instructed to. 要求されたとき、これらのフレームが終了する必要があります。These frames should exit when they are requested.

  • 短時間実行され、特定の非常には、重要な条件が満たされたときに、その終了をフレームです。Short running, very specific frames that exit when an important criteria is met. これらのフレームは、独自の終了条件が満たされているを待つを優先して要求されたときに終了しないを検討してください。These frames may consider not to exit when they are requested in favor of waiting for their exit criteria to be met. これらのフレームには、タイムアウトが関連付けられている必要があります。These frames should have a time-out associated with them.

XAML テキストの使用状況XAML Text Usage

このマネージ クラスを使用することはできませんXAMLXAMLします。You cannot use this managed class in XAMLXAML.

Constructors

DispatcherFrame() DispatcherFrame() DispatcherFrame() DispatcherFrame()

DispatcherFrame クラスの新しいインスタンスを初期化します。 Initializes a new instance of the DispatcherFrame class.

DispatcherFrame(Boolean) DispatcherFrame(Boolean) DispatcherFrame(Boolean) DispatcherFrame(Boolean)

指定した終了要求フラグを使用して、DispatcherFrame クラスの新しいインスタンスを初期化します。 Initializes a new instance of the DispatcherFrame class, by using the specified exit request flag.

Properties

Continue Continue Continue Continue

この DispatcherFrame を続行するかどうかを示す値を取得または設定します。 Gets or sets a value that indicates whether this DispatcherFrame should continue.

Dispatcher Dispatcher Dispatcher Dispatcher

この Dispatcher が関連付けられている DispatcherObject を取得します。 Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)

Methods

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。 Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。 Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。 Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。 Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。 Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。 Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

呼び出し元のスレッドがこの DispatcherObject にアクセスできるように強制します。 Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Applies to

See Also