Direct Manipulation on PM Applications

For PM applications, the Workplace Shell sends DM_ messages to PM windows using the standard or enhanced direct manipulation protocols. The Workplace Shell will drag source objects rendered as OBJECT or as OS2FILE and will accept source objects rendered in the same way. The Workplace Shell also will send a DM_PRINTOBJECT message to items dropped on the printer object.

Users can drag source objects over windows that an object creates. When this occurs, the Workplace Shell sends DM_ messages to these windows. Therefore, window procedures associated with the windows that the object creates must be able to process DM_ messages.

Target objects are not necessarily able to process every type of source object that is dropped on them. They are, however, capable of processing more than one type of dropped source object. Printer objects, for example, cannot print binary files, but they can print both text and graphics files. Because of differing capabilities, each target object should determine if it can process the source object being dropped on it. The following table shows the direct manipulation messages that are sent to target objects and the methods that are invoked by the Workplace Shell:

кФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФТФФФФФФФФФФТФФФФФФФФФФФФФФФФФФП
ГDescription    ГMethod Name      ГInvoked OnГMessage Name      Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФХФФФФФФФФФФХФФФФФФФФФФФФФФФФФФД
ГFormat drag    ГwpFormatDragItem ГSource    ГNone              Г
Гinformation    Г                 Г          Г                  Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФХФФФФФФФФФФХФФФФФФФФФФФФФФФФФФД
ГRequest        ГwpRender         ГSource    ГDM_RENDER         Г
Гrendering      Г                 Г          Г                  Г
Гformat         Г                 Г          Г                  Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФХФФФФФФФФФФХФФФФФФФФФФФФФФФФФФД
ГRendering      ГwpRenderComplete ГTarget    ГDM_RENDERCOMPLETE Г
Гrequest        Г                 Г          Г                  Г
Гcompleted      Г                 Г          Г                  Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФХФФФФФФФФФФХФФФФФФФФФФФФФФФФФФД
ГObjects being  ГwpDragOver       ГTarget    ГDM_DRAGOVER       Г
Гdragged over   Г                 Г          Г                  Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФХФФФФФФФФФФХФФФФФФФФФФФФФФФФФФД
ГObject has beenГwpDrop           ГSource    ГDM_DROP           Г
Гdropped        Г                 Г          Г                  Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФХФФФФФФФФФФХФФФФФФФФФФФФФФФФФФД
ГDrag/Drop is   ГwpEndConversationГTarget    ГDM_ENDCONVERSATIONГ
Гcomplete       Г                 Г          Г                  Г
РФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФСФФФФФФФФФФСФФФФФФФФФФФФФФФФФФй

The "Source" and "Target" windows in the following diagram represent windows that have been subclassed, via CnrOwnerSubclassProc, by the Workplace Shell:

                      кФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
                      Г       Source                           Target        Г
                      РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй
                                Г                                Г
        User begins drag        Г                                Г
         (WM_BEGINDRAG ФФФФФФФФ>Г                                Г
               or               Г                                Г
           WM_PICKUP)           Г                                Г
                                Г                                Г
                                Г                                Г
                  wpFormatDragItem(sourceobject)                 Г
                                Г                                Г
                                Г          DM_DRAGOVER           Г
                              .>ГФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФ>Г
                              . Г                                Г
                              . Г                    wpDragOver(targetobject)
                              . Г                                Г
                              . Г         DDR_  response         Г
                              ..Г<ФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФГ
                                Г                                Г
        User ends drag          Г                                Г
         (WM_ENDDRAG)ФФФФФФФФФФ>Г                                Г
                                Г            DM_DROP             Г
                                ГФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФ>Г
                                Г                                Г
                                Г                      wpDrop(targetobject)
                                Г                                Г
                             ... If source rendering is indicated ...
                                Г                                Г
                                Г                                Г
                                Г        DM_RENDERPREPARE        Г
                                Г         (If necessary)         Г
                                Г<ФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФГ<.
                                Г                                Г .
                                Г           DM_RENDER            Г .
                                Г         (If supported)         Г .
                                Г<ФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФГ .
                                Г                                Г .
                      wpRender(sourceobject)                     Г .
                                Г                                Г .
                                Г        DM_RENDERCOMPLETE       Г .
                                ГФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФ>Г .
                                Г                                Г..
                                Г                                Г
                                Г                 wpRenderComplete(targetobject)
                                Г                                Г
                                Г                                Г
                                Г                                Г
                                Г                                Г
                                Г        DM_ENDCONVERSATION      Г
                                Г<ФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФГ
                                Г                                Г
                  wpEndConversation(sourceobject)

[Back] [Next]