
.*---------------------------------------------------------------
.* A sample IPF file -- source for a help (.HLP) file.
.*---------------------------------------------------------------

:userdoc.

.nameit symbol=product text='%TITLE%'
.*--------------------------------
:h1 id=mainwin res=100.&product.
:i1.general help
:i1.about the &product.
:p.
This is general help for the &product..
:p.
The &product. uses the IBM User Interface Class Library (ICLUI) to
implement features that are common to most
:link reftype=fn refid=IBMtrade.Presentation Manager:elink.
(PM) programs, like a menu bar containing 
:link reftype=hd refid=file.File:elink. and
:link reftype=hd refid=edit.Edit:elink. 
and :hp2.Help:ehp2. action bar items.  You can use the &product.
as a template from which to build your own ICLUI applications.
Compare this code with the code from the Basic PM Application in
the Project Smartz catalog to see how much easier it is to implement
a user-interface with ICLUI.
:p.
The &product. is fully help-enabled, and uses string resources,
instead of string literals, to facilitate translation.
:p.
To use the &product., open a file by selecting 
:link reftype=hd refid=open.Open:elink. from
the :hp2.File:ehp2. pull-down.  The file is opened, and then immediately closed.
Subsequently, any menu item you select is displayed as text in the client 
window.
.*--------------------------------
:fn id=IBMtrade.
:p.
A trademark of the IBM Corporation.
:efn.
.*--------------------------------
:h1 id=file res=110.File
:i1.file
:p.
Help for :hp2.File:ehp2..
.*--------------------------------
:h2 id=open res=130.Open
:i1.open
:i1.opening files
:p.
Help for :hp2.Open:ehp2. menu item.
.*--------------------------------
:h2 id=opendlg res=135.File open
:i1.file open dialog
:i1 id=dialog.dialog
:i2 refid=dialog.file open
:p.
Help for :hp2.File open:ehp2. dialog.
:p.
Enter the name of the file to open in the :hp2.Open filename:ehp2.
entry field.
.*--------------------------------
:h2 id=save res=140.Save
:i1.save
:p.
Help for :hp2.Save:ehp2..
.*--------------------------------
:h2 id=saveas res=150.Save as
:i1.save as
:p.
Help for :hp2.Save as:ehp2. menu item.
.*--------------------------------
:h2 id=savedlg res=155.Save as
:i1.save as dialog
:i2 refid=dialog.save as
:p.
Help for :hp2.Save as:ehp2. dialog.
:p.
Enter the name of the file to save in the :hp2.Save as filename:ehp2.
entry field.
.*--------------------------------
:h2 id=print res=160.Print
:i1.print
:p.
Help for :hp2.Print:ehp2..
.*--------------------------------
:h2 id=close res=170.Close
:i1.close
:p.
Help for :hp2.Close:ehp2..
.*--------------------------------
:h1 id=edit res=180.Edit
:i1.edit
:p.
Help for :hp2.Edit:ehp2..
.*--------------------------------
:h2 id=undo res=190.Undo 
:i1.undo
:p.
Help for :hp2.Undo:ehp2..
.*--------------------------------
:h2 id=copy res=200.Copy
:i1.copy
:p.
Help for :hp2.Copy:ehp2..
.*--------------------------------
:h2 id=cut res=210.Cut
:i1.cut
:p.
Help for :hp2.Cut:ehp2..
.*--------------------------------
:h2 id=paste res=220.Paste
:i1.paste
:p.
Help for :hp2.Paste:ehp2..
.*--------------------------------
:h2 id=find res=230.Find 
:i1.find
:p.
Help for :hp2.Find:ehp2..
.*--------------------------------
:h2 id='findnext' res=240.Find next
:i1.find next
:p.
Help for :hp2.Find next:ehp2..
.*
.*****************************************************
.*  Help for messages
.*****************************************************
.*
.*--------------------------------
:h1 hide id='msg1' res=8000.Message Help
:p.
The file you selected could not be opened for one or
more of the following reasons&colon.
:ul compact.
:li.The file could not be found.  It may have been deleted, renamed,
or moved.
:li.There are too many open files.  If this is the case, increase
the FILES= number in your CONFIG.SYS.
:li.Access to the file was denied.  Check the file's attributes and
make sure that you have write access to the file.
:li.The file may be in use by another process.  Stop all processes
that could be using the file and try opening the file again.
:li.The disk is full.
:eul.
:p.
Check that none of the above conditions is true
and try the opening the file again.
.*--------------------------------
:h1 hide id='msg2' res=8010.Message Help
:p.
This action is invalid until you have opened a file.  Open
a file by selecting :hp2.Open...:ehp2. from the :hp2.File:ehp2.
pull-down menu.
.*--------------------------------
:h1 hide id='msg3' res=8020.Message Help
:p.
Help is not available due to one or more of the
following reasons&colon.
:ul compact.
:li.The HELP.HLP file is not present on the HELP path.  Ensure
that the \HELP directory is present along your HELP path, and that
the HELP.HLP file exists.
:li.The HELP.HLP file is corrupted.
:eul.



:euserdoc.











