Dispatcher.PushFrame(DispatcherFrame) Metode

Definisi

Ruang nama:

System.Windows.Threading

Rakitan:

WindowsBase.dll

Memasukkan perulangan eksekusi.

public:
 static void PushFrame(System::Windows::Threading::DispatcherFrame ^ frame);

public static void PushFrame(System.Windows.Threading.DispatcherFrame frame);

static member PushFrame : System.Windows.Threading.DispatcherFrame -> unit

Public Shared Sub PushFrame (frame As DispatcherFrame)

Parameter

frame

DispatcherFrame

Bingkai untuk diproses oleh dispatcher.

Pengecualian

ArgumentNullException

frame adalah null.

InvalidOperationException

HasShutdownFinished adalah true

-atau-

frame berjalan pada yang berbeda Dispatcher.

-atau-

Pemrosesan dispatcher telah dinonaktifkan.

Contoh

Contoh berikut menunjukkan cara menggunakan untuk mencapai hasil yang DispatcherFrame sama dengan metode Windows Forms DoEvents .

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

Keterangan

mewakili DispatcherFrame perulangan yang memproses item kerja yang tertunda.

Dispatcher memproses antrean item kerja dalam perulangan. Perulangan disebut sebagai bingkai. Perulangan awal biasanya dimulai oleh aplikasi dengan memanggil Run.

PushFrame memasukkan perulangan yang diwakili oleh parameter frame. Pada setiap perulangan perulangan, Dispatcher akan memeriksa Continue properti pada DispatcherFrame kelas untuk menentukan apakah perulangan harus dilanjutkan atau apakah harus berhenti.

DispatcherFrame Continue memungkinkan properti diatur secara eksplisit dan menghormati HasShutdownStarted properti pada Dispatcher. Ini berarti ketika Dispatcher mulai dimatikan, bingkai yang menggunakan implementasi default DispatcherFrame akan keluar, yang memungkinkan semua bingkai berlapis keluar.

Lihat juga

• ExitAllFrames()