GetData (Método)

Recupera los datos del objeto DataObject de la operación de arrastrar y colocar de OLE. Sólo está disponible en tiempo de ejecución.

oDataObject.GetData(nFormat | cFormat [, @ArrayName])

Parámetros

• nFormat | cFormat
  Especifica el formato de los datos que se van a obtener. La tabla siguiente muestra los valores para cada formato de datos y una descripción de cada formato de datos. DataObject admite automáticamente los formatos siguientes (hay más formatos disponibles, pero requieren programación adicional para su uso). Para obtener más información acerca de los formatos de datos disponibles, vea la documentación de Visual C++® en Microsoft Developer Network.

  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, disponible sólo en Windows NT 4.0 o posterior.
  CF_FILES o CF_HDROP	15	Un identificador que identifica una lista de archivos, como un conjunto de archivos arrastrados desde el Explorador de Windows.
  CF_LOCALE	16	Un controlador del identificador de configuración regional asociado al texto del Portapapeles.
  CFSTR_OLEVARIANTARRAY	"Matriz Variant OLE"	Una matriz de Visual FoxPro. Se pueden transferir múltiples valores con este formato en una única operación de arrastrar y colocar. Por ejemplo, este formato se puede usar para arrastrar un conjunto de elementos de un cuadro de lista a otro.
  CFSTR_OLEVARIANT	"Variant OLE"	Un Variant de Visual FoxPro. 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 a un objeto de Visual FoxPro.

  * Definido en FOXPRO.H.

• @ArrayName
  Especifica el nombre de la matriz en la que se almacenan los datos cuando pueden contener múltiples valores. Los únicos formatos de datos en los que los datos pueden contener múltiples valores son CF_FILES, CF_HDROP y CFSTR_OLEVARIANTARRAY. Por ejemplo, puede arrastrar un conjunto de archivos desde el Explorador de Windows a un cuadro de lista de Visual FoxPro. Use el método GetData del evento OLEDragDrop del cuadro de lista para colocar los nombres de los archivos en una matriz y, a continuación, use el método AddItem de un bucle FOR … ENDFOR para agregar el contenido de la matriz al cuadro de lista.

  La matriz debe existir antes de que pueda especificar su nombre en el método GetData. Si la matriz existe y no es suficientemente grande para contener los datos, Visual FoxPro aumentará automáticamente el tamaño de la matriz. Si la matriz es mayor de lo necesario, Visual FoxPro reducirá su tamaño.

Observaciones

El valor devuelto por el método GetData está determinado por el formato de los datos especificados con nFormat o cFormat. Se devuelve Falso (.F.) si el DataObject no contiene datos en el formato especificado en nFormat o cFormat. Se devuelve Verdadero (.T.) cuando los datos están en formato de múltiples valores como CF_FILES, CF_HDROP o CFSTR_OLEVARIANTARRAY. Se devuelven los datos de DataObject cuando están en un formato de valor único como CF_TEXT, CFSTR_OLEVARIANT o CFSTR_VFPSOURCEOBJECT.

El evento OLESetData para un origen de arrastre se desencadena si el formato de datos que especifique con nFormat o cFormat existe, pero no hay datos en DataObject para ese formato. (El método SetFormat se puede usar para especificar un formato de datos antes de que se coloquen los datos correspondientes en el DataObject con el método SetData.)

Vea también

ClearData (Método) | GetFormat (Método) | Técnica de arrastrar y colocar OLE | OLESetData (Evento) | SetData (Método) | SetFormat (Método)

Se aplica a: DataObject (Objeto)