DispatcherFrame Classe

Definição

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
Herança
DispatcherFrame

Exemplos

O exemplo a seguir mostra como usar um DispatcherFrame para obter resultados semelhantes como o Windows FormsWindows Forms DoEvents método.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

Comentários

DispatcherFrameos 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.

Construtores

DispatcherFrame()

Inicializa 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.

Propriedades

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.

(Herdado de DispatcherObject)

Métodos

CheckAccess()

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

(Herdado de DispatcherObject)
Equals(Object)

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

(Herdado de Object)
GetHashCode()

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

(Herdado de Object)
GetType()

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

(Herdado de Object)
MemberwiseClone()

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

(Herdado de Object)
ToString()

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

(Herdado de Object)
VerifyAccess()

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

(Herdado de DispatcherObject)

Aplica-se a

Veja também