Clase wxEventLoopBase

Envía el siguiente evento en la cola de eventos del sistema de ventanas.

Bloquea hasta que aparece un evento si no hay ninguno actualmente (utilizar Pending() si no se desea).

Esto puede usarse para programar bucles de eventos, por ejemplo

while (evtloop->Pending())
    evtloop->Dispatch();

Valor de retorno

false si el bucle de eventos debe detenerse y true en caso contrario.

Envía un evento sin esperar más tiempo del especificado.

Si se recibe un evento antes de que expire el tiempo de espera especificado, se procesa y la función devuelve 1 normalmente o 0 si el bucle de eventos debe terminar. En caso contrario, es decir, si expira el tiempo de espera, la función devuelve -1 sin procesar ningún evento.

Parámetros

timeout

Tiempo máximo de espera de los eventos en milisegundos.

Valor de retorno

1 si se ha procesado un evento, 0 si el bucle de eventos debe salir o -1 si el tiempo de espera ha expirado.

Sale del bucle que se está ejecutando con el código de salida dado.

El bucle saldrá, es decir, su método Run() volverá, durante la siguiente iteración del bucle de eventos.

Hay que tener en cuenta que este método solo se puede utilizar si este bucle de eventos es el que se está ejecutando actualmente, es decir, si su método IsRunning() devuelve verdadero. Si este no es el caso, se dispara un fallo de assert y no se hace nada, ya que no se puede salir inmediatamente de los bucles de eventos externos. Utilizar ScheduleExit() si se desea salir de este bucle aunque no se esté ejecutando.

Devuelve el bucle de eventos actualmente activo (en ejecución).

Puede devolver NULL si no hay ningún bucle de eventos activo (por ejemplo, durante el inicio o el cierre de la aplicación).

Devuelve true si la categoría de evento dada está permitida dentro de una llamada a YieldFor() (es decir, compara la categoría dada con la última máscara pasada a YieldFor()).

Devuelve true si este es el bucle principal ejecutado por wxApp::OnRun().

Utilízarlo para comprobar si el bucle de eventos se ha creado correctamente antes de usarlo.

Devuelve true si este bucle de eventos se está ejecutando actualmente.

Hay que tener en cuenta que incluso si este bucle de eventos no ha terminado todavía, pero acaba de generar un bucle de eventos anidado (por ejemplo, modal), este método devolverá false.

Devuelve true si se llama desde dentro de Yield() o desde dentro de YieldFor().

Esta función es llamada antes de que el bucle de eventos termine, tanto si esto ocurre normalmente (debido a la llamada a Exit()) o anormalmente (debido a una excepción lanzada desde dentro del bucle).

La implementación por defecto llama a wxAppConsole::OnEventLoopExit.

Devuelve true si hay algún evento disponible.

Si este método devuelve true, la llamada a Dispatch() no se bloqueará.

Esta función virtual es llamada cuando la aplicación se vuelve inactiva y normalmente sólo envía wxIdleEvent a todas las partes interesadas.

Debe devolver true si se necesitan más eventos de inactividad, false en caso contrario.

Inicia el bucle de eventos, devuelve el código de salida cuando finaliza.

Lógicamente, este método llama a Dispatch() en un bucle hasta que devuelve false y también se encarga de generar eventos inactivos durante cada iteración del bucle. Sin embargo, no todas las implementaciones de esta clase lo hacen realmente así (por ejemplo, wxGTK no lo hace) por lo que no se debería confiar en que Dispatch() sea llamado desde dentro de esta función.

Valor de retorno

El argumento pasado a Exit() que termina este bucle de eventos.

Programa una salida del bucle con el código de salida dado.

Este método es similar a Exit() pero puede ser llamado incluso si este bucle de eventos no es el que se está ejecutando actualmente - y si es el bucle activo, entonces funciona exactamente de la misma manera que Exit().

El bucle saldrá tan pronto como el flujo de control vuelva a él, es decir, después de que cualquier bucle anidado termine.

Establece el bucle de eventos actualmente activo (en ejecución).

Llamado por wxEventLoopActivator, utilizar una instancia de esta clase en lugar de llamar a este método directamente para asegurarse de que el bucle de eventos previamente activo se restaura.

Resulta en una llamada a wxAppConsole::OnEventLoopEnter.

Llamado por wxWidgets para despertar el bucle de eventos incluso si está actualmente bloqueado dentro de Dispatch().

Asegura que los eventos inactivos se envíen de nuevo.

Cede el control a los mensajes pendientes en el sistema de ventanas.

Esto puede ser útil, por ejemplo, cuando un proceso que consume mucho tiempo escribe en una ventana de texto. Sin una cesión ocasional, la ventana de texto no se actualizará correctamente, y en sistemas con multitarea cooperativa, otros procesos no responderán.

Sin embargo, hay que tener cuidado, ya que ceder puede permitir al usuario realizar acciones que no son compatibles con la tarea actual. Deshabilitar elementos de menú o menús enteros durante el procesamiento puede evitar la reentrada no deseada de código: véase wxSafeYield para una función mejor.

Hay que tener en cuenta que Yield() no vaciará los registros de mensajes. Esto es intencionado ya que llamar a Yield() se hace normalmente para actualizar rápidamente la pantalla y hacer aparecer un cuadro de diálogo de mensajes puede ser indeseable. Si desea vaciar los mensajes de registro inmediatamente (de lo contrario se hará durante la siguiente iteración del bucle inactivo), llamar a wxLog::FlushActive.

Si el parámetro onlyIfNeeded es true y el control de flujo ya está dentro de Yield(), es decir, IsYielding() devuelve true, el método simplemente devuelve false y no hace nada.

Funciona como Yield() con onlyIfNeeded == true, excepto que permite al llamador especificar una máscara de los valores wxEventCategory que indica qué eventos deben ser procesados y cuáles deben ser "retrasados" (es decir, procesados por el bucle principal más tarde).

Hay que tener en cuenta que esta es una alternativa más segura a Yield(), ya que garantiza que solo se procesarán los eventos que le interesen; es decir, este método ayuda a evitar reentradas no deseadas.

Hay que tener en cuenta que actualmente solo wxMSW y wxGTK soportan el rendimiento selectivo de eventos nativos procedentes del conjunto de herramientas GUI subyacente. Los eventos de wxWidgets enviados utilizando wxEvtHandler::AddPendingEvent o wxEvtHandler::QueueEvent son procesados selectivamente por todos los ports.