Copyright: DP Migrate Copyright® 1994 Matt Ginzton


DropPop Migrate Utility

version 1.0, shipped with DropPop version 1.2

What it's for

Overview of use

How to migrate:

Individual icons from Program Manager

Complete groups from Program Manager

Individual icons from the Dropper desktop

Configuration

About the author


WHAT ITS FOR
What it's for

DropPop Migrate Utility is provided to ease the process of setting up your existing programs and files into DropPop menus.

You probably already have dozens, or possibly hundreds, of icons in Program Manager groups, placed there either by yourself or by application setup programs.  As a user of Dropper, you also probably have at least several icons on your desktop that you would rather have in DropPop menus.  DropPop Migrate Utility is designed to copy icons from either source into DropPop menus.

DropPop Migrate Utility (or DPMigrate) provides three methods for migrating icons into DropPop menus:

•	Migrate individual icons from Program Manager into DropPop menus.  You choose a Program Manager group, one or more icons from that group, and a target DropPop menu to put the icons into.  Click Migrate and DPMigrate moves them for you.

•	Migrate an entire Program Manager group, and create a new DropPop menu for the icons.  Choose a group, and a name and icon for the new menu.  Click OK, choose where you want the menu to appear, and you'll have a new menu with all the icons from that group.

•	Migrate individual icons from the Dropper desktop.  You choose any icons on the Dropper desktop (except other DropPop menus) and a target DropPop menu, and the icons will be copied into the menu.  If you don't want these icons to show up on the desktop after they're copied into menus, choose Remove from Desktop, and the icons will be moved instead of copied.

For more information, see:

Migrating individual icons from Program Manager

Migrating complete groups from Program Manager

Migrating individual icons from the Dropper desktop


Migration of ProgMan icons

•	From Group:  Choose the ProgMan group that contains the icons that you want to migrate.  Icons from different groups must be migrated in separate steps.

•	Migrate these icons:  Choose the icon(s) you want to migrate.  Clicking on the name of an icon selects or deselects it.  You can also use the All or None buttons to select or deselect all icons in the list.

•	To DropPop menu:  Choose the DropPop menu that you want the icons to end up in.

•	Migrate:  Migrates the selected icons to the selected menu.  After migration, the dialog box will remain until you choose Done, to allow migration of other icons.

•	Done:  Closes the dialog box and returns to the main screen.

•	Help:  Brings up this help screen.


Migration of ProgMan groups

•	Migrate all icons from group:  Choose the Program Manager group that contains the icons you want.  A new DropPop menu will be created, containing all the icons from this group.

•	Menu name:  Type a distinct name for the menu.  Up to 40 characters are allowed.  The menu name will be used for later identification by DropPop and DPMigrate -- for example, the "To DropPop menu" in the other migration options in DPMigrate.

•	Expand to:  When you open the menu, after its creation, which direction should it appear to?  Choose a direction toward the center of the screen from the planned location of the icon, or the menu could display offscreen.

•	Menu icon from:  Type the filename of any Windows icon file, including most EXE, DLL, and ICO files.  (Good sources are PROGMAN.EXE and MORICONS.DLL, both located in the Windows directory.)

•	Prev/Next buttons:  Used to step through the icons in the selected file.

•	Migrate:  Brings up another dialog, where you select the location for the new menu.  The cursor will change to an icon-sized rectangle with an X in the middle.  Click where you want the menu to be, then choose OK; choose Cancel to return to this dialog without creating the menu.  After creating a menu, you will be returned to this dialog, with all fields reset to defaults, so you can create more menus.

•	Cancel:  Returns to the main screen.

•	Help:  Displays this help screen.


Migration from the Dropper desktop

•	Migrate these icons:  A list of all the icons on the Dropper desktop, except other DropPop menus.  (Menus cannot be placed inside other menus with current versions of DropPop.)
The icons will be listed with the caption, if any, at the left, and the filename to the right.
Choose the icon(s) you wish to migrate.  Multiple icons can be selected.  You can use the All or None buttons to select or deselect all the icons shown.

•	To DropPop menu:  Choose the name of the DropPop menu that you want to migrate the chosen icons to.

•	Remove icons from desktop after migration:  If this box is checked, the icons will be migrated to the selected menu and then automatically removed from the desktop.  If not checked, the icons will be migrated but a copy will also remain on the desktop.
(This option only affects the desktop icons; neither choice will change nor delete the actual files on disk.)

•	Migrate:  Moves/copies the selected icons to the target menu.  After migration, the dialog will still be displayed, so you can migrate other icons.

•	Done:  Return to the main screen.

•	Help:  Displays this help screen.


Overview

DropPop Migrate Utility (or DPMigrate) can move either individual icons or complete groups of icons from Program Manager, or individual icons from the Dropper desktop.  Let's assume you want to do some of each:

Moving icons from Program Manager:

1	You must have at least one DropPop menu existing before you can use this option, since it only migrates to existing menus.  If you haven't already, set up DropPop and get a feel for it.  (Drop a DropPop icon on the desktop, and click on the resulting icon.)

2	Launch DPMigrate and choose "Migrate icons from a ProgMan group onto an existing DropPop menu," then click Migrate.

3	Choose the Program Manager group you want to migrate icons from, from the listbox next to "From group."

4	Click on each icon you want to migrate, in the large listbox.  You can also use All to highlight all the icons, or None to unhighlight them all.  You can select multiple icons.

5	Choose a DropPop menu from the last drop-down listbox.  The line underneath will show how many icons can fit in this menu (due to the DropPop limit of 26 icons per menu).

6	Choose Migrate and the icons will be copied to the selected DropPop menu.  At this point, you can either choose Done and return to the main screen, or repeat the process with other Program Manager groups and icons.

Moving groups from Program Manager:

1	This is the only DPMigrate option that creates a new menu.  So, you can use this whether or not you have existing DropPop menus.

2	Launch DPMigrate and choose "Migrate an entire ProgMan group into a new DropPop menu," then choose Migrate.

3	Choose a Program Manager group to migrate.  All the icons in the group will be migrated.

4	Enter a name for the new menu.  The name will be used by DPMigrate and DropPop to identify the menu.  The name must be under 40 characters and must be unique.

5	Choose a direction for the new menu to expand to.  Keep in mind that if you choose Expand Left put the menu icon on the left edge of the screen, the menu will happily display itself offscreen.  (Recommendation: choose a direction toward the center of the screen from where you plan to put the icon.)

6	Unless you like the default icon, enter the name of any file containing Windows icons (most EXE, DLL and ICO files, especially PROGMAN.EXE and MORICONS.DLL) under "Menu icon from."  You can use the Prev and Next buttons to step through the icons contained in the file.  If you don't enter a valid name, the default menu icon will be used.

7	Choose Migrate.  Another dialog will display with coordinate values and OK and Cancel buttons, and the cursor will change to an icon-sized box with an X in the center.  Click anywhere onscreen to set the location for the menu that will be created.  Then choose OK.

8	The menu will be created.  At this point you can press Cancel to return to the main screen, or repeat these steps to create additional menus from other ProgMan groups.

Moving icons from the Dropper desktop:

1	You must have at least one DropPop menu existing before you can use this option, since it only migrates to existing menus.  If you haven't already, set up DropPop and get a feel for it.  (Drop a DropPop icon on the desktop, and click on the resulting icon.)

2	Launch DPMigrate and choose "Migrate icons from the Dropper desktop to an existing DropPop menu," then choose Migrate.  You will be asked whether you want to save the state of the desktop, unless you have turned off this confirmation in DropPop.  (If you don't save, information may be incorrect, and you won't be able to automatically remove migrated icons from the desktop.)

3	Choose the Dropper icons that you want to migrate from the large listbox.  You can select multiple icons.  You can use All to select the whole list, or None to deselect the whole list.

4	Choose the target DropPop menu from the drop-down listbox.  The line underneath will show the remaining capacity of the selected menu.

5	If you want the icons to disappear from the desktop after migration, so that the only copy will be in the DropPop menu, enable Remove from Desktop.  (This won't affect the files represented by the icons, just the Dropper desktop.)

6	Choose Migrate.  The selected icons will be copied or moved.

7	Click Done to return to the main screen, or repeat the above steps for other DropPop menus.


Configuration

Actually, there's not that much to configure in DropPop Migrate Utility.

What is changeable is controlled by the DropPop Preferences dialog (once you have at least one DropPop menu set up, open it and choose Config, Preferences.)  If you have not set up DropPop, the options will default as follows:

•	Use of 3D dialogs -- will default to off, but will use whatever setting DropPop is set to.

•	Confirmation before killing and reloading Dropper and/or saving Dropper settings -- will default to on, unless you have turned it off in DropPop.


About the author

DropPop and DropPop Migrate Utility are both freeware.  (I'm a 17-year-old high school student with nothing better to do...)  I would, however, appreciate any and all comments.  Send any input to:

Matt Ginzton
2135 Lakeshore Drive
Sagle, ID   83860

CompuServe: 73304,445
Internet: 73304.445@compuserve.com