[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        RemoveAppWindowDropZone -- remove a drop zone from an appwindow.

   SYNOPSIS
        success = RemoveAppWindowDropZone(appWindow,dropZone)
          D0                                 A0        A1

        bool removeappwindowdropzone(struct appwindow *,
                                     struct AppWindowDropZone *);

   FUNCTION
        Attempt to remove a drop zone from an appwindow.

   INPUTS
        appWindow -- pointer to an appwindow structure returned by
            workbench.library/addappwindowa. a value of null will be
            ignored.
        dropZone -- pointer to an AppWindowDropZone returned by
            workbench.library/addappwindowdropzonea. a value of null will
            be ignored.

   RESULTS
        success - TRUE if the drop zone could be removed, FALSE otherwise.
            The reason for the failure can be obtained using
            dos.library/ioerr. this routine may fail if the specified drop
            zone is not registered with the appwindow.

   NOTES
        Due to the asynchronous nature of Workbench/user interaction, you
        may receive appicon drop zone messages for zones that you have
        just removed. These messages may arrive in the time between your
        code calling RemoveAppWindowDropZone() and Workbench responding
        to the drop zone removal request. Be prepared to handle this. Once
        a drop zone is removed, it will generate no new AppMessages.

   SEE ALSO
        workbench.library/addappwindowdropzonea