DispatcherFrame DispatcherFrame DispatcherFrame DispatcherFrame Class

定義

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
継承
DispatcherFrameDispatcherFrameDispatcherFrameDispatcherFrame

次の例は、を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

注釈

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.

コンストラクター

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.

プロパティ

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)

メソッド

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)

適用対象

こちらもご覧ください