Power GUI Programming with VisualAge C++/powergui.iso/trialva/ibmcppw/bin/ibmpcni.hlp

OS/2 Help File | 1996-01-12 | 15.1 KB | 472 lines

ΓòÉΓòÉΓòÉ 1. Resource Image Conversion Utility Introduction ΓòÉΓòÉΓòÉ

The Resource Image Conversion Utility utility allows you to open a bitmap
(.BMP), cursor (.CUR), icon (.ICO) or pointer (.PTR) file for viewing and
conversion.

It allows you to save the images either in OS/2 or Windows format.

It also allows you to save individual images from cursor (.CUR), icon (.ICO) or
pointer (.PTR) file as single images or as part of a group of images.


ΓòÉΓòÉΓòÉ 2. Help for File Action Bar Menu ΓòÉΓòÉΓòÉ

The File action bar menu consists of the following menu items:

     Open
     Save
     Select filename


ΓòÉΓòÉΓòÉ 3. Help for File Open Menu Item ΓòÉΓòÉΓòÉ

The File Open... menu item allows you to open a bitmap (.BMP), cursor (.CUR),
icon (.ICO) or pointer (.PTR) file for viewing and conversion.  The Open File
dialog will be displayed from which you can select the file to view and
convert.


ΓòÉΓòÉΓòÉ 4. Help for Save Menu Item ΓòÉΓòÉΓòÉ

The Save menu item is used to save bitmap, cursor, icon or pointer in the
format selected in the Format action bar menu. The names under which the
converted images are saved are taken from the entry fields beside each image.
If the mode selected within the Mode action bar menu is Group, the entry field
above the images is used.


ΓòÉΓòÉΓòÉ 5. Help for Select Filename Menu Item ΓòÉΓòÉΓòÉ

The Select filename... menu item allows you to select a bitmap (.BMP), cursor
(.CUR), icon (.ICO) or pointer (.PTR) to use within the entry field you have
selected.  The Select Filename dialog will be displayed from which you can
select the filename to use.


ΓòÉΓòÉΓòÉ 6. Help for Options Action Bar Menu ΓòÉΓòÉΓòÉ

The Options action bar menu consists of the following menu item:

     Icon/cursor/pointer preselection


ΓòÉΓòÉΓòÉ 7. Help for Icon/cursor/pointer Preselection Menu Item ΓòÉΓòÉΓòÉ

You can specify which icon/pointer types should be pre-selected through this
menu item.

The Icon/Cursor/Pointer Preselection Options dialog will allow you to configure
the utility to preselect only those types you wish to convert.

Note:  The selections from this option also control how the command line
       resource conversion utility selects icons and pointers to be converted
       and saved.


ΓòÉΓòÉΓòÉ 8. Help for Format Action Bar Menu ΓòÉΓòÉΓòÉ

The Format action bar menu consists of the following menu items:

     OS/2
     Windows


ΓòÉΓòÉΓòÉ 9. Help for OS/2 Menu Item ΓòÉΓòÉΓòÉ

You can specify that the format of the bitmap (.BMP), cursor (.CUR), icon
(.ICO) or pointer (.PTR) file you have opened as an OS/2 2.x file through the
OS/2 menu item.


ΓòÉΓòÉΓòÉ 10. Help for Windows Menu Item ΓòÉΓòÉΓòÉ

You can specify that the format of the bitmap (.BMP), cursor (.CUR), icon
(.ICO) or pointer (.PTR) file you have opened as a Windows file through the
Windows menu item.

Note:  This is the default


ΓòÉΓòÉΓòÉ 11. Help for Mode Action Bar Menu ΓòÉΓòÉΓòÉ

The Mode action bar menu consists of the following menu items:

     Group
     Items


ΓòÉΓòÉΓòÉ 12. Help for Group Menu Item ΓòÉΓòÉΓòÉ

You can specify that the cursor (.CUR), icon (.ICO) or pointer (.PTR) file you
have opened be treated as a group or array of images.  Both OS/2 and Windows
support multiple images within cursor (.CUR), icon (.ICO) or pointer (.PTR)
files.

When in group mode, only one entry field will be present within the main window
whereas when in item mode, each image will be associated with an entry field
thereby allowing you to save individual images.

Also, when in group mode, each image will be associated with a check box. The
check will display the size of the image and the number of colors.

By checking the check box, the image will be included in the file saved.  By
not checking the check box, the image will be excluded from the file saved.

Note:  This is the default


ΓòÉΓòÉΓòÉ 13. Help for Items Menu Item ΓòÉΓòÉΓòÉ

You can specify that the cursor (.CUR), icon (.ICO) or pointer (.PTR) file you
have opened be treated as a set of individual images.  Both OS/2 and Windows
support multiple images within cursor (.CUR), icon (.ICO) or pointer (.PTR)
files.

When in item mode, each image will be associated with an entry field thereby
allowing you to save individual images whereas when in group mode, only one
entry field will be present within the main window.


ΓòÉΓòÉΓòÉ 14. Help for Help Action Bar Menu ΓòÉΓòÉΓòÉ

The Help action bar menu consists of the following menu items:

     Help index
     General help
     Using help
     Keys help
     Product information


ΓòÉΓòÉΓòÉ 15. Help for Help Index Menu Item ΓòÉΓòÉΓòÉ

Select Help index on the Help pull-down to see the help index for the Resource
Image Conversion Utility.


ΓòÉΓòÉΓòÉ 16. Help for General Help Menu Item ΓòÉΓòÉΓòÉ

Select General help on the Help pull-down to see the extended help information
for the Resource Image Conversion Utility.


ΓòÉΓòÉΓòÉ 17. Help for Using Help Menu Item ΓòÉΓòÉΓòÉ

The Using help menu item contains items you can use to get different types of
online help for the Resource Image Conversion Utility.

Press the Enter key to access the items on the Help pull-down.


ΓòÉΓòÉΓòÉ 18. Help for Keys Help Menu Item ΓòÉΓòÉΓòÉ

Select Keys help on the Help pull-down for help on the keys you use to perform
a specific task, When you select this item, you see a list of key groups.
Double click on one of the groups to see the keys you use to perform the task.


ΓòÉΓòÉΓòÉ 19. Help for Product Information Menu Item ΓòÉΓòÉΓòÉ

The Product information... menu item cause the Product Information dialog to be
displayed.  This dialog contains the current version number of the utility and
the copyright notice.


ΓòÉΓòÉΓòÉ 20. Help for Resource Image Conversion Utility ΓòÉΓòÉΓòÉ

The Resource Image Conversion Utility main window is used to display the images
of bitmap (.BMP), cursor (.CUR), icon (.ICO) or pointer (.PTR) file selected
through the File Open menu.

Each image contained within the selected file will be displayed showing the
size of the image and the number of colors.

You can specify the format of the output through the Format action bar menu.
The default format is Windows..

When you have selected a bitmap (.BMP) file, each image will be preceeded by an
entry field.  It is within this entry field that you entry the name of the file
that you wish to save the converted image. The size of the image and the number
of colors is displayed to the immediate right.

Once you have entered the name of the file to save each converted image to and
select the File Save menu item, only those images that have file specified will
be saved to the file.

When you have selected a cursor (.CUR), icon (.ICO) or pointer (.PTR) file, the
images will be displayed in one of two ways depending on the mode. If the mode
is Group, then one entry field will be displayed above all the images and the
images will each be shown with a check box that states the size and number of
colors.  Each check box will be checked when the images are first displayed.

Once you have entered the name of the file to save the converted images to and
select the File Save menu item, only those images that have their associated
check boxes checked will be saved to the file.

If the mode is Items, then each image will be displayed preceded by an entry
field.  It is within this entry field that you entry the name of the file that
you wish to save the converted image. The size of the image and the number of
colors is displayed to the immediate right.

Once you have entered the name of the file to save each converted image to and
select the File Save menu item, only those images that have file specified will
be saved to the file.


ΓòÉΓòÉΓòÉ 21. Help for Open File Dialog ΓòÉΓòÉΓòÉ

The Open File dialog allows you to select a bitmap (.BMP), cursor (.CUR), icon
(.ICO) or pointer (.PTR) file to view within the Resource Image Conversion
Utility main window.  You can then save the image or images in OS/2 or Windows
formats.

You can enter within the entry field labeled File name the file you wish to
open.

You can quickly select a file for viewing by double clicking the mouse pointer
on the file listed.  Alternately, you can select the file, upon which the name
will be automatically placed within the File name entry field. You can then
click the mouse pointer on the Open push button. This will cause the file to be
loaded and the images displayed within the Resource Image Conversion Utility
main window.


ΓòÉΓòÉΓòÉ 22. Help for Icon/Cursor/Pointer Preselection Options Dialog ΓòÉΓòÉΓòÉ

The Icon/Cursor/Pointer Preselection Options dialog allows you to configure the
conversion utility to preselect only those types of icons and pointers you want
to convert.

For Windows, you can select from the following: 32 x 16 - 2 colors 32 x 32 - 2
colors 16 x 16 - 16 colors 32 x 32 - 16 colors

 For OS/2, you can select from the following: 16 x 16 - 16 colors 20 x 20 - 16
 colors 32 x 32 - 16 colors 40 x 40 - 16 colors 64 x 64 - 16 colors 16 x 16 - 2
 colors 20 x 20 - 2 colors 32 x 16 - 2 colors 32 x 32 - 2 colors 40 x 40 - 256
 colors 64 x 64 - 256 colors

 By default, all are preselected.  Therefore, when you have selected an icon or
 cursor or pointer, the check box for each type contained within the icon or
 cursor or pointer will be checked automatically.

 If you do not want a particular type to be preselected, you only need to
 uncheck the item within this dialog.

 Note:  The selections from this option also control how the command line
        resource conversion utility selects icons and pointers to be converted
        and saved.


ΓòÉΓòÉΓòÉ 23. Help for Filename Selection Dialog ΓòÉΓòÉΓòÉ

The Filename Selection dialog allows you to select a filename of a bitmap
(.BMP), cursor (.CUR), icon (.ICO) or pointer (.PTR) file to  be placed in an
image entry field of the main window.

You can enter within the entry field labeled File name the file you wish to
use.

You can quickly select a file for viewing by double clicking the mouse pointer
on the file listed.  Alternately, you can select the file, upon which the name
will be automatically placed within the File name entry field. You can then
click the mouse pointer on the OK push button. This will cause the filename to
be placed in the entry field within the Resource Image Conversion Utility main
window.


ΓòÉΓòÉΓòÉ <hidden> Help for Accelerator Keys ΓòÉΓòÉΓòÉ

The following accelerator keys are defined for use within Resource Image
Conversion Utility:

 Key:           Function:

 Ctrl+B         Select filename

 Ctrl+G         Mode Group

 Ctrl+I         Mode Items

 Ctrl+O         File Open

 Ctrl+P         Preselect image

 Ctrl+S         File Save

 Ctrl+W         Format Windows

 Ctrl+2         Format OS/2


ΓòÉΓòÉΓòÉ 24. Help for Keys ΓòÉΓòÉΓòÉ

Double click on one of the following groups to get help for keys that do a
specific task:

     Accelerator keys
     Cursor movement keys
     Text selection keys
     Action bar keys
     Menu keys
     Dialogue keys
     System keys.


ΓòÉΓòÉΓòÉ <hidden> Help for Action bar keys ΓòÉΓòÉΓòÉ

Use these keys to select the System icon and action bar items.

 Key:           Function:

 F10            Switches between the action bar and the design area.

 Shift+Esc      Switches between the System icon and the design area.

 Right          Highlights the next action bar item or the System icon.

 Left           Highlights the previous action bar item or the System icon.

 Enter          Accesses the pull-down of the highlighted action bar item or
                System icon.

 Mnemonic       The mnemonic key is the key corresponding with the underlined
                letter in the action bar items.  It accesses the pull-down of
                the action bar item containing the mnemonic.

 Escape         Returns to the design area.


ΓòÉΓòÉΓòÉ <hidden> Help for Menu keys ΓòÉΓòÉΓòÉ

Use these keys to select pull-down items.

 Key:           Function:

 Up             Moves up one pull-down item.

 Down           Moves down one pull-down item.

 Enter          Selects the highlighted pull-down item.

 Mnemonic       The mnemonic key is the key corresponding with the underlined
                letter in the pull-down items.  It selects the pull-down item
                containing the mnemonic.

 Escape         Closes the pull-down.


ΓòÉΓòÉΓòÉ <hidden> Help for dialogue keys ΓòÉΓòÉΓòÉ

Use these keys to select dialogue box items.

 Key:          Function:

 Tab           Moves to the next control group on the dialog.

 Shift+Tab     Moves to the previous control group on the dialog.

 Right         Moves to the next button on the dialog.

 Left          Moves to the previous button on the dialog.

 Up            Moves up one item in a selection box.

 Down          Moves down one item in a selection box.

 Page Up       Scrolls up one page in a selection box with scroll bars.

 Page Down     Scrolls down one page in a selection box with scroll bars.

 Spacebar      Switches a check box on and off.

 Enter         Starts the activity for the selected pushbutton.

 Escape        Exits the dialog.


ΓòÉΓòÉΓòÉ <hidden> Help for System keys ΓòÉΓòÉΓòÉ

Use these keys to switch between, move, and size Presentation Manager windows.

 Key:                Function:

 Alt+Tab             Switches to the next Presentation Manager window.

 Alt+Shift+Tab       Switches to the previous Presentation Manager window.

 Alt+Esc             Switches to the next application (including
                     non-Presentation Manager applications).

 Ctrl+Esc            Switches to the Task List.

 Alt+F4              Closes the active window.

 Alt+F5              Restores the active window.

 Alt+F7              Moves the active window.

 Alt+F8              Sizes the active window.

 Alt+F9              Minimizes the active window.

 Alt+F10             Maximizes the active window.


ΓòÉΓòÉΓòÉ <hidden> Help for Cursor movement keys ΓòÉΓòÉΓòÉ

Use these keys to move the cursor in an entry field.

 Key:          Function:

 Up            Moves the cursor up one line.

 Down          Moves the cursor down one line.

 Right         Moves the cursor right one character.

 Left          Moves the cursor left one character.

 Ctrl+Right    Moves the cursor to the beginning of the next word.

 Ctrl+Left     Moves the cursor to the beginning of the previous word.

 Home          Moves the cursor to the beginning of the current line.

 End           Moves the cursor to the end of the current line.

 Ctrl+Home     Moves the cursor to the beginning of the first line in the file.

 Ctrl+End      Moves the cursor to the end of the last line in the file.

 Page Up       Scrolls the window or dialogue up one window.

 Page Down     Scrolls the window or dialogue down one window.


ΓòÉΓòÉΓòÉ <hidden> Help for Text selection keys ΓòÉΓòÉΓòÉ

Use these keys to select text and extend existing selected areas of text.

CAUTION:
 If an area of text is selected, pressing any character key, the Backspace key,
or the Delete key deletes the selected text from the entry field.

 Key:                Function:

 Shift+arrow         Selects text or extends a selection in the direction of
                     the arrow.

 Shift+Home          Selects text or extends a selection to the beginning of
                     the current line.

 Shift+End           Selects text or extends a selection to the end of the
                     current line.

 Shift+Ctrl+Right    Selects text or extends a selection to the beginning of
                     the next word.

 Shift+Ctrl+Left     Selects text or extends a selection to the beginning of
                     the previous word.