SetFormat (Método)

Incluye un formato de datos en el DataObject en una operación de arrastrar y colocar de OLE. Sólo está disponible en tiempo de ejecución.

oDataObject.SetFormat(nFormat | cFormat)

Parámetros

• nFormat | cFormat
  Especifica el formato de los datos incluidos en el DataObject. La tabla siguiente muestra una lista de valores correspondientes a algunos formatos de datos comunes, con una descripción de cada formato. También puede crear su propio formato especificando una cadena de caracteres única para cFormat.

  Formato de datos*	nFormat | cFormat	Descripción
  CF_TEXT	1	Formato de texto.
  CF_OEMTEXT	7	Formato de texto que contiene caracteres del juego de caracteres OEM.
  CF_UNICODETEXT	13	Formato de texto Unicode, sólo disponible en Windows NT 4.0 o en una versión posterior.
  CF_FILES o CF_HDROP	15	Un controlador que identifica una lista de archivos, como un conjunto de archivos arrastrados desde el Explorador de Windows.
  CFSTR_OLEVARIANTARRAY	"Matriz Variant OLE"	Una matriz. Se pueden transferir varios valores en una sola operación de arrastrar y colocar con este formato. Por ejemplo, este formato se puede usar para arrastrar un conjunto de elementos de un cuadro de lista a otro.
  CFSTR_OLEVARIANT	"Variant OLE"	Variant. Todos los tipos de datos de Visual FoxPro se representan como Variant. Este formato se puede usar para arrastrar y colocar datos de Visual FoxPro sin perder el tipo de datos.
  CFSTR_VFPSOURCEOBJECT	"Objeto de origen de VFP"	Una referencia al objeto de origen de arrastre de Visual FoxPro.

  * Definido en FOXPRO.H.

Observaciones

Se puede incluir un formato de datos en el DataObject antes de colocar los datos correspondientes en él. Si coloca un formato de datos en el DataObject sin los datos correspondientes y ejecuta el método GetData en el evento OLEDragDrop, se ejecutará el evento OLESetData para el origen de arrastrar y colocar. El origen de arrastre puede entonces colocar los datos en el DataObject con el método SetData en el evento OLESetData.

Se puede mejorar el rendimiento de las operaciones de arrastrar y colocar de OLE colocando sólo los formatos de datos en el DataObject cuando se coloca una gran cantidad de datos, cuando se utilizan formatos de datos que no son compatibles de forma nativa con Visual FoxPro o cuando se utiliza un gran número de formatos.

El método SetFormat sólo se puede ejecutar en los eventos OLEStartDrag y OLESetData.

Vea también

ClearData (Método) | GetData (Método) | GetFormat (Método) | Introducción a arrastrar y colocar OLE | OLEDragDrop (Evento) | OLESetData (Evento) | OLEStartDrag (Evento) | SetData (Método)

Se aplica a: DataObject (Objeto)