dataobj.h

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)

Construye un objeto de formato de datos para uno de los formatos de datos estándar o un objeto de datos vacío (utilizar SetType() o SetId() más adelante en este caso).

Nota: En wxPerl utilizar Wx::Bitmap->newNative(format).

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.