Clase wxDataFormat
Un wxDataFormat es una encapsulación de un manejador de formato específico de la plataforma que es utilizado por el sistema para el portapapeles y las operaciones de arrastrar y soltar.
Las aplicaciones normalmente solo están interesadas en, por ejemplo, pegar datos del portapapeles si los datos están en un formato que el programa entiende y un formato de datos es algo que identifica de forma única este formato.
A nivel de sistema, un formato de datos es normalmente solo un número (CLIPFORMAT bajo Windows o Atom bajo X11, por ejemplo) y los formatos estándar son, de hecho, solo números que pueden ser convertidos implícitamente a wxDataFormat. Los formatos estándar son:
wxDF_INVALID | Un formato no válido - utilizado como argumento por defecto para las funciones que toman un argumento wxDataFormat a veces. |
wxDF_TEXT | Formato de texto (wxString). |
wxDF_BITMAP | Un mapa de bits (wxBitmap). |
wxDF_METAFILE | Un metafile (wxMetafile, solo Windows). |
wxDF_UNICODETEXT | Formato de texto Unicode (wxString). |
wxDF_FILENAME | Una lista de nombres de archivo. |
wxDF_HTML | Una cadena HTML. Actualmente sólo es válido en Mac y MSW. |
wxDF_PNG | Un archivo PNG. Sólo es válido en MSW. Esta constante está disponible desde wxWidgets 3.1.5. |
Como se mencionó anteriormente, estos formatos estándar se pueden pasar a cualquier función que tome como argumento wxDataFormat porque wxDataFormat tiene una conversión implícita de ellos (o, para ser precisos del tipo wxDataFormat::NativeFormat que es el tipo utilizado por la plataforma subyacente para los formatos de datos).
Aparte de los formatos estándar, la aplicación también puede utilizar formatos personalizados que se identifican por sus nombres (cadenas) y no por identificadores numéricos. Aunque internamente el formato personalizado debe ser creado (o registrado) primero, no hay que preocuparse por ello porque se hace automáticamente la primera vez que se crea el objeto wxDataFormat correspondiente a un nombre de formato dado. La única implicación de esto es que se debe evitar tener objetos wxDataFormat globales con constructores no predeterminados porque sus constructores se ejecutan antes de que el programa tenga tiempo de realizar todas las inicializaciones necesarias y, por tanto, ¡un intento de registrar el formato del portapapeles en este momento normalmente conducirá a un fallo!
Funciones miembro
wxDataFormat()
wxDataFormat::wxDataFormat(wxDataFormatId format = wxDF_INVALID)
wxDataFormat()
wxDataFormat::wxDataFormat(const wxString & format)
Construye un objeto de formato de datos para un formato personalizado identificado por su nombre format.
Nota: En wxPerl utilizar Wx::Bitmap->newUser(format).
GetId()
wxString wxDataFormat::GetId() const
Devuelve el nombre de un formato personalizado (esta función fallará para un formato estándar).
GetType()
wxDataFormatId wxDataFormat::GetType() const
Devuelve el número específico de la plataforma que identifica el formato.
SetId()
void wxDataFormat::SetId(const wxString & format)
Establece que el formato sea el formato personalizado identificado por el nombre dado.
SetType()
void wxDataFormat::SetType(wxDataFormatId type)
Establece el formato al valor dado, que debe ser una de las constantes wxDF_XXX.
Operadores
operator!=()
bool wxDataFormat::operator!=(const wxDataFormat & format) const
Devuelve true si los formatos son diferentes.
operator!=()
bool wxDataFormat::operator!=(wxDataFormatId format) const
Devuelve true si los formatos son diferentes.
operator==()
bool wxDataFormat::operator==(const wxDataFormatId & format) const
Devuelve true si los formatos son iguales.
operator==()
bool wxDataFormat::operator==(wxDataFormatId format) const
Devuelve true si los formatos son iguales.