Función SDL_ShowMessageBox

Sintaxis

int SDL_ShowMessageBox(const SDL_MessageBoxData *messageboxdata, int *buttonid);

Descripción

Crea un cuadro de mensaje modal.

Parámetros

messageboxdata

Estructura SDL_MessageBoxData con título, texto y otras opciones.

buttonid

El puntero al que debe copiarse el identificador definido por el usuario del botón pulsado.

Valor de retorno

Devuelve 0 si tiene éxito o un código de error negativo si falla. Ver SDL_GetError.

Observaciones

Si las necesidades no son complejas, puede ser más fácil utilizar SDL_ShowSimpleMessageBox.

Esta función debe ser llamada en el hilo que creó la ventana padre, o en el hilo principal si el cuadro de mensaje no tiene padre. Bloqueará la ejecución de ese subproceso hasta que el usuario pulse un botón o cierre el cuadro de mensaje.

Esta función puede ser llamada en cualquier momento, incluso antes de SDL_Init(). Esto la hace útil para informar de errores como un fallo al crear un renderizador o un contexto OpenGL.

En X11, SDL despliega su propio cuadro de diálogo con primitivas X11 en lugar de un toolkit formal como GTK+ o Qt.

Hay que tener en cuenta que si SDL_Init() fallara porque no hay ningún objetivo de vídeo disponible, es probable que esta función falle por las mismas razones. Si esto preocupa, comprobar el valor de retorno de esta función y volver a escribir en stderr si se puede.