Implementing Drag-Drop Insertion of OLE Objects

만료된 KB 콘텐츠 고지 사항

이 문서는 Microsoft에서 더 이상 지원하지 않는 제품에 대해 작성되었습니다. 따라서 이 문서는 “있는 그대로" 제공되며 더 이상 업데이트되지 않습니다.

Summary

An OLE client application can support the drag-drop feature provided by the SHELL.DLL component of Microsoft Windows version 3.1. The drag-drop feature supports dragging a file from the Windows File Manager and dropping it on any registered drag-drop recipient. If the user drops a file onto an OLE client application and the application manages that file type, the application opens the file for editing. If the OLE client application does not manage that file type, it can create an embedded object for the dropped file.

More Information

When an OLE client creates an embedded object from a dropped file, it inserts a packaged object that refers to the dropped file. The OLE server for a packaged object (an object of the Package class) is the Microsoft Windows Object Packager (PACKAGER.EXE) application. Packager supports associating a command line, a file, or an object with an icon.

A packaged object can contain either embedded or linked objects. When the user double-clicks a packaged object, Windows invokes the application associated with the packaged object and specifies the object on the application's command line. For example, when the user double-clicks a package object labeled BOOTLOG.TXT, Packager calls the WinExec function to start Notepad and specifies BOOTLOG.TXT as the command-line argument.

If an application can accept dropped files, it must call the DragAcceptFiles function. Once an application registers itself, the user can drag an object from the File Manager onto the application. When the user drops a file, the application receives a WM_DROPFILES message. When the client calls the DragQueryFile function, Windows provides the number and names of the dropped files. The DragQueryPoint function provides the location in the application's window where the user dropped the files.

The recommended procedure to provide drag-drop support in an OLE client application is as follows:

  • Call the DragAcceptFiles function during application initialization. Specify the handle of a container document window for the hwnd parameter and specify TRUE for the fAccept parameter to indicate that the window will accept dropped files.
  • When the application receives a WM_DROPFILES message, perform the following five steps:

    • Call the DragQueryFile function to determine how many files are dropped.
    • Call the DragQueryFile function to obtain the names of the dropped files.
    • Call the OleCreateFromFile function once for each dropped file to create a package for each dropped file. Specify "Package" as the object class for each new object.
    • Check the value returned from OleCreateFromFile and act accordingly.
    • Call the DragFinish function to free the memory used to store the names of the dropped files.
The Code to insert a drag-drop object in an application might resemble the following:

char       szFile[80];      // Used to store name of dropped file
OLESTATUS OleStatus; // Code returned from OLE functions
WORD wNumFiles, cb;

case WM_DROPFILES:
// Retrieve number of dropped files
wNumFiles = DragQueryFile((HANDLE)wParam, 0xFFFF, NULL, 0);

// Simple case of one dropped file; more than one can be dropped
if (wNumFiles == 1)
{
cb = DragQueryFile((HANDLE)wParam, 0, szFile, 80);

// If no characters copied, there were no files
if (cb == 0)
return(0L);

// Call OleCreateFromFile to insert a Package object containing
// the dropped file as an embedded object or call
// OleCreateLinkFromFile to insert a Package object containing a
// link to the dropped file.
OleStatus = OleCreateFromFile("StdFileEditing", lpOleClient,
"Package", (LPSTR)szFile, lhDoc, lpszUniqueName, lplpObject,
olerender_draw, 0);

// Follow the procedure to create an object from the clipboard

DragFinish((HANDLE)wParam);
}
속성

문서 ID: 86270 - 마지막 검토: 1999. 10. 27. - 수정: 1

피드백