Dispatcher.PushFrame(DispatcherFrame) Yöntem

Tanım

Ad Alanı:

System.Windows.Threading

Bütünleştirilmiş Kod:

WindowsBase.dll

Yürütme döngüsü girer.

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)

Parametreler

frame

DispatcherFrame

Dağıtıcının işlemesi için çerçeve.

Özel durumlar

ArgumentNullException

frame, null'e eşittir.

InvalidOperationException

HasShutdownFinished eşittir true

-veya-

frame farklı Dispatcherbir üzerinde çalışıyor.

-veya-

Dağıtıcı işleme devre dışı bırakıldı.

Örnekler

Aşağıdaki örnekte, Windows Forms DoEvents yöntemiyle benzer sonuçlar elde etmek için 'DispatcherFramenin nasıl kullanılacağı gösterilmektedir.

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

Açıklamalar

A DispatcherFrame , bekleyen iş öğelerini işleyen bir döngünün temsil eder.

Dağıtıcı iş öğesi kuyruğu bir döngüde işler. Döngü, çerçeve olarak adlandırılır. İlk döngü genellikle çağrılarak Runuygulama tarafından başlatılır.

PushFrame parametresiyle frametemsil edilen bir döngü girer. döngünün her yinelemesinde, Dispatcher döngünün Continue devam edip etmeyeceğini veya durması gerekip gerekmediğini belirlemek için sınıfındaki DispatcherFrame özelliğini denetler.

DispatcherFrameözelliğin Continue açıkça ayarlanmasına izin verir ve üzerindeki Dispatcherözelliğine HasShutdownStarted saygı gösterir. Bu, kapatmaya başladığında, varsayılan DispatcherFrame uygulamayı kullanan çerçevelerin çıkılacağı ve bu sayede iç içe yerleştirilmiş tüm çerçevelerin çıkılacağı anlamına gelirDispatcher.

Ayrıca bkz.

• ExitAllFrames()