Clase wxTextDataObject
wxTextDataObject es una especialización de wxDataObjectSimple para datos de texto.
Jerarquía:
Se puede utilizar sin cambios para pegar datos en el wxClipboard o en un wxDropSource. Un usuario puede desear derivar una nueva clase de esta clase para proporcionar texto bajo demanda con el fin de minimizar el consumo de memoria cuando se ofrecen datos en varios formatos, como texto plano y RTF porque por defecto el texto se almacena en una cadena en esta clase, pero también podría generarse cuando se solicite. Para ello habrá que sobreescribir GetTextLength() y GetText().
Hay que tener en cuenta que si ya se tiene el texto dentro de una cadena, no se conseguirá ninguna ganancia de eficiencia sobreescribiendo estas funciones porque copiar wxStrings ya es una operación muy eficiente (los datos no se copian realmente porque wxStrings dispone de contador de referencias).
Funciones miembro
wxTextDataObject()
wxTextDataObject::wxTextDataObject(const wxString & text = wxEmptyString)
Constructor, se puede utilizar para inicializar el texto (de lo contrario se debe utilizar más tarde SetText()).
GetAllFormats()
virtual void wxTextDataObject::GetAllFormats( wxDataFormat * formats, wxDataObject::Direction dir = wxDataObject::Get ) const
Devuelve todos los formatos soportados por wxTextDataObject.
Bajo wxMac y wxGTK son wxDF_TEXT y wxDF_UNICODETEXT, bajo otros ports devuelve sólo uno de los dos, dependiendo del modo de compilación.
Implementa wxDataObject.
GetFormat()
const wxDataFormat& wxTextDataObject::GetFormat() const
Devuelve el formato preferido soportado por este objeto.
Es wxDF_TEXT o wxDF_UNICODETEXT dependiendo de la plataforma y del modo de compilación (es decir, de wxUSE_UNICODE).
GetFormatCount()
virtual size_t wxTextDataObject::GetFormatCount(wxDataObject::Direction dir = wxDataObject::Get) const
Devuelve 2 bajo wxMac y wxGTK, donde los datos de texto procedentes del portapapeles pueden ser proporcionados como ANSI (wxDF_TEXT) o como texto Unicode (wxDF_UNICODETEXT, pero sólo cuando wxUSE_UNICODE==1).
Devuelve 1 en otras plataformas (p.ej. wxMSW) o cuando se construye en modo ANSI (wxUSE_UNICODE==0).
Implementa wxDataObject.
GetText()
virtual wxString wxTextDataObject::GetText() const
Devuelve el texto asociado con el objeto de datos.
Es posible que se desee anular este método al ofrecer datos bajo demanda, pero esto no es requerido por las funciones internas de wxWidgets. Utilizar este método para obtener datos en forma de texto del wxClipboard.
GetTextLength()
virtual size_t wxTextDataObject::GetTextLength() const
Devuelve el tamaño de los datos.
Por defecto, devuelve el tamaño de los datos de texto establecidos en el constructor o mediante SetText(). Esto se puede sobreescribir para proporcionar datos de tamaño de texto bajo demanda. Se recomienda devolver la longitud del texto más 1 para un cero final, pero no es estrictamente necesario.
SetText()
virtual void wxTextDataObject::SetText(const wxString & strText)
Establece el texto asociado al objeto de datos.
Este método se ejecuta cuando el objeto de datos recibe los datos y, por defecto, copia el texto en la variable miembro. Si desea procesar el texto sobre la marcha, se puede anular esta función.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de vwxDataObjectSimple" y wxDataObject.