Clase wxAppTraits
La clase wxAppTraits define varios aspectos configurables de una wxApp.
Se puede acceder a ella usando la función wxApp::GetTraits() y se puede crear una wxAppTraits propia sobrescribiendo la función wxApp::CreateTraits().
hay que tener en cuenta que wxAppTraits es una clase abstracta ya que contiene muchas funciones virtuales puras. De hecho, por defecto, wxWidgets crea un objeto wxConsoleAppTraits para las aplicaciones de consola (es decir, aquellas aplicaciones enlazadas únicamente con la librería wxBase - ver la página Lista de Librerías) y un objeto wxGUIAppTraits para las aplicaciones GUI. Ambas clases derivan de wxAppTraits y representan implementaciones concretas de la interfaz wxAppTraits.
Funciones miembro
CreateConfig()
virtual wxConfigBase* wxAppTraits::CreateConfig()
Llamado por wxWidgets para crear el objeto de configuración por defecto para la aplicación.
La versión por defecto crea una clase wxRegConfig basada en el registro en MSW y wxFileConfig en el resto de plataformas.
Los métodos wxApp::GetAppName y wxApp::GetVendorName se utilizan para determinar la clave del registro o el nombre del fichero.
CreateEventLoop()
virtual wxEventLoopBase* wxAppTraits::CreateEventLoop()
Utilizado por wxWidgets para crear el bucle de eventos principal utilizado por wxApp::OnRun().
La implementación por defecto de este método en wxGUIAppTraits devuelve el bucle de eventos GUI específico de la plataforma. La versión en wxConsoleAppTraits devuelve un bucle de eventos específico de consola que puede ser usado para manejar eventos de temporizador y socket en programas de consola bajo Unix y MSW o NULL bajo las otras plataformas donde los bucles de eventos de consola no están soportados todavía.
CreateFontMapper()
virtual wxFontMapper* wxAppTraits::CreateFontMapper()
Crea el objeto mapeador de fuentes global utilizado para la asignación de codificaciones/charset.
CreateLogTarget()
virtual wxLog* wxAppTraits::CreateLogTarget()
CreateMessageOutput()
virtual wxMessageOutput* wxAppTraits::CreateMessageOutput()
Crea el objeto global utilizado para imprimir mensajes.
CreateRenderer()
virtual wxRendererNative* wxAppTraits::CreateRenderer()
Devuelve el renderizador a utilizar para dibujar los controles genéricos (el valor devuelto puede ser NULL en cuyo caso se utiliza el renderizador por defecto para la plataforma actual); esto se utiliza sólo en modo GUI y siempre devuelve NULL en consola.
Nota: el puntero devuelto debe ser borrado por el llamante.
GetAssertStackTrace()
virtual wxString wxAppTraits::GetAssertStackTrace()
Función auxiliar muy útil para la implementación de ShowAssertDialog() en clases derivadas.
Devuelve el marco de pila como un wxString plano (y posiblemente vacío).
Esta función solo está disponible cuando wxUSE_STACKWALKER es 1.
GetDesktopEnvironment()
virtual wxString wxAppTraits::GetDesktopEnvironment() const
Este método devuelve el nombre del entorno de escritorio que se está ejecutando actualmente en un escritorio Unix.
Actualmente solo se soportan "KDE" o "GNOME" y el código utiliza el nombre del proveedor del protocolo de sesión X11 para averiguar qué entorno de escritorio se está ejecutando. De lo contrario, el método devuelve una cadena vacía y en todas las demás plataformas.
GetStandardPaths()
virtual wxStandardPaths& wxAppTraits::GetStandardPaths()
Devuelve el objeto wxStandardPaths de la aplicación.
Normalmente es el mismo para wxBase y wxGUI excepto en el caso de wxMac y wxCocoa.
Nota: La referencia devuelta es a una clase wxStandardPathsBase pero puede considerarse equivalente a wxStandardPaths (que está documentada).
GetToolkitVersion()
virtual wxPortId wxAppTraits::GetToolkitVersion( int * major = NULL, int * minor = NULL, int * micro = NULL ) const
Devuelve el ID del port wxWidgets utilizado por el programa en ejecución y eventualmente rellena los punteros dados con los valores de los dígitos mayor, menor y micro del toolkit nativo utilizado actualmente.
Los números de versión devueltos son por tanto detectados en tiempo de ejecución y no en tiempo de compilación (excepto cuando esto no es posible p.e. wxMotif).
Por ejemplo, si su programa está usando el port wxGTK esta función devolverá wxPORT_GTK y pondrá en los punteros dados las versiones de la librería GTK en uso. Ver wxPlatformInfo para más detalles.
Si una micro versión no está disponible tendrá el valor 0.
HasStderr()
virtual bool wxAppTraits::HasStderr()
Devuelve true si fprintf(stderr) va a alguna parte, false en caso contrario.
IsUsingUniversalWidgets()
virtual bool wxAppTraits::IsUsingUniversalWidgets() const
Devuelve true si la librería fue construida como wxUniversal.
Siempre devuelve false para aplicaciones wxBase-only.
SafeMessageBox()
Muestra un cuadro de mensaje con el texto y título dados si es posible.
En algunos ports, p.e. wxMSW, siempre se mostrará un cuadro de mensaje, mientras que en los otros solo se hará si la GUI está disponible (p.e. la pantalla X11 se abrió con éxito para ports basados en X11) y la función simplemente devuelve false sin hacer nada en caso contrario.
Esta función es segura en el sentido de que siempre puede ser llamada, incluso antes de crear wxApp, de forma similar a wxSafeShowMessage() que se implementa llamando a esta función y luego registrando el mensaje en el flujo de error estándar si devuelve false.
Parámetros
- text
- El texto a mostrar al usuario.
- title
- El título del cuadro de mensaje mostrado al usuario.
Valor de retorno
true si se ha mostrado el cuadro de mensaje o false en caso contrario.
ShowAssertDialog()
virtual bool wxAppTraits::ShowAssertDialog(const wxString & msg)
Muestra el diálogo de aserción con el mensaje especificado en modo GUI o simplemente imprime la cadena a stderr en modo consola.
Devuelve true para suprimir afirmaciones posteriores, false para continuar como antes.