SDL_messagebox.h

Función SDL_ShowSimpleMessageBox

Sintaxis

int SDL_ShowSimpleMessageBox(Uint32 flags, const char *title, const char *message, SDL_Window *window);

Descripción

Muestra una cuadro de mensaje modal simple.

Parámetros

flags: Un valor SDL_MessageBoxFlags.
title: Un texto UTF-8 con el título.
message: Un texto UTF-8 con el mensaje.
window: La ventana padre, o NULL si no la tiene.

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, esta función es preferible a SDL_ShowMessageBox.

Las banderas pueden ser cualquiera de las siguientes:

SDL_MESSAGEBOX_ERROR: diálogo de error.
SDL_MESSAGEBOX_WARNING: diálogo de advertencia.
SDL_MESSAGEBOX_INFORMATION: diálogo informativo.

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.