DispatcherFrame Class

Definition

Representa um loop de execução no 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
DispatcherFrame

Examples

O exemplo a seguir mostra como usar um DispatcherFrame para obter resultados semelhantes como o método de DoEvents de Windows FormsWindows Forms.The following example shows how to use a DispatcherFrame to achieve similar results as the Windows FormsWindows 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 objetos normalmente se enquadram em duas categorias:DispatcherFrame objects typically fall into two categories:

  • Execução demorada, quadros de uso geral que são encerrados somente quando instruído a.Long running, general purpose frames that exit only when instructed to. Esses quadros devem ser encerrados quando forem solicitados.These frames should exit when they are requested.

  • A execução curta, quadros muito específicos que são encerrados quando um critério importante é atendido.Short running, very specific frames that exit when an important criteria is met. Esses quadros podem considerar não sair quando solicitados a esperar que seus critérios de saída sejam atendidos.These frames may consider not to exit when they are requested in favor of waiting for their exit criteria to be met. Esses quadros devem ter um tempo limite associado a eles.These frames should have a time-out associated with them.

Uso de texto XAMLXAML Text Usage

Você não pode usar essa classe gerenciada no XAMLXAML.You cannot use this managed class in XAMLXAML.

Constructors

DispatcherFrame()

Inicia uma nova instância da classe DispatcherFrame.Initializes a new instance of the DispatcherFrame class.

DispatcherFrame(Boolean)

Inicializa uma nova instância da classe DispatcherFrame usando o sinalizador de solicitação de saída especificado.Initializes a new instance of the DispatcherFrame class, by using the specified exit request flag.

Properties

Continue

Obtém ou define um valor que indica se este DispatcherFrame deve continuar.Gets or sets a value that indicates whether this DispatcherFrame should continue.

Dispatcher

Obtém o Dispatcher ao qual este DispatcherObject está associado.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)

Methods

CheckAccess()

Determina se o thread de chamada tem acesso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess()

Impõe que o thread de chamada tenha acesso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Applies to

See also