Извлекает данные из объекта OLE drag-and-drop DataObject. Доступно только в run time.

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

Параметры

nFormat| cFormat

Указывает формат извлекаемых данных. В приведенной ниже таблице перечислены значения для каждого формата данных и описание каждого формата. DataObject автоматически поддерживает нижеприведенные форматы. automatically supports the following formats (доступно большее количество форматов, но для их использования может потребоваться дополнительное программирование). Для получения подробной информации о доступных форматах данных смотрите документацию по Visual C++® на Microsoft Developer Network.

 
Data формат* nFormat| cFormat Описание

CF_TEXT

1

Текстовый формат.

CF_OEMTEXT

7

Текстовый формат, содержащий символы в наборе OEM.

CF_UNICODETEXT

13

Текстовый формат в Unicode

NoteNote

Доступен только для версий Visual FoxPro запущенный на NT 4.0 или позднее.

CF_FILES or CF_HDROP

15

Дескриптор, который идентифицирует список файлов такой, как набор файлов, перетащенных из Windows Explorer.

CF_LOCALE

16

Десриптор идентификатора локали, ассоциированной с текстом в clipboard.

CFSTR_OLEVARIANTARRAY

"OLE Variant Array"

Массив Visual FoxPro. Множество величин могут перенесены в простой операции перетаскивания (drag and drop) при использования этого формата.

Например, этот формат может быть использован для перетаскивания набора элементов из одного элемента управления listbox в другой элемент управления listbox.

CFSTR_OLEVARIANT

"OLE Variant"

Visual FoxPro variant. Все типы данных в Visual FoxPro представлены как variants. Этот формат может быть использован для перетаскивания данных Visual FoxPro без потери типа данных.

CFSTR_VFPSOURCEOBJECT

"VFP Source Object"

Ссылка на объект Visual FoxPro.

* Определено в FOXPRO.H.

@ArrayName

Указывает имя массива, в котором будут храниться данные, когда перетаскиваемые данные могут содержать множество значений. Единственными форматами данных, в которых данные могут содержать множество значений являются CF_FILES, CF_HDROP и CFSTR_OLEVARIANTARRAY. Например, вы можете перетащить набор файлов из Windows Explorer в элемент управления listbox Visual FoxPro. Используйте метод GetData в событии OLEDragDrop элемента управления listbox для размещения имет файлов в массив, затем используйте метод AddItem в цикле FOR ... ENDFOR для ввода содержимого массива в listbox.

Массив должен существовать до того, как вы укажете его имя в методе GetData. Если массив существует, но недостаточно велик, чтобы принять данные, Visual FoxPro автоматически увеличит его размер. Если размер массива больше, чем требуется для размещения данных, Visual FoxPro уберет лишние элементы массива.

Expand imageПримечания

Применяется к объекту : DataObject

Значение, возвращаемое методом GetData определяется форматом данных, определенного в nFormat или cFormat. Если DataObject не содержит данных в указанном вами в nFormat или cFormat формате, то будет возвращшено False (.F.). Когда данные представляют собой формат множественного значения такой, как CF_FILES, CF_HDROP или CFSTR_OLEVARIANTARRAY то будет возвращено True (.T.). Когда данные представляют собой формат единичного значения, такой, как CF_TEXT, CFSTR_OLEVARIANT или CFSTR_VFPSOURCEOBJECT то на объекте DataObject возвращаются данные.

Событие OLESetData для источника операции drag срабатывает, если существуют данные в формате, указанном вами в nFormat or cFormat, но в объекте DataObject не существует данных в этом формате. (Метод SetFormat может быть использован для указания формата данных до того, как соответствующие данные будут помезены в DataObject методом SetData.)

Expand image Смотрите также