254 lines
8.1 KiB
Plaintext
254 lines
8.1 KiB
Plaintext
|
{\rtf1
|
||
|
{\comment ************************************************************
|
||
|
*
|
||
|
* This is a simple RTF help file. It was constructed with a regular
|
||
|
* text editor, and using normal RTF syntax to define the various
|
||
|
* things that the Help Compiler knows how to interpret, and turn into
|
||
|
* a proper WinHelp file.
|
||
|
*
|
||
|
* Where necessary and appropriate, there will be comments like this
|
||
|
* one to assist you in understanding what this help file is doing.
|
||
|
*
|
||
|
**********************************************************************
|
||
|
}
|
||
|
|
||
|
{\comment ************************************************************
|
||
|
*
|
||
|
* Before we do anything else, we need to define the font table that we
|
||
|
* will be using, I will then set the default font to '0' (Arial)
|
||
|
* and the font size to 16
|
||
|
*
|
||
|
**********************************************************************
|
||
|
}
|
||
|
|
||
|
{\fonttbl
|
||
|
\f0\fswiss Arial;
|
||
|
\f1\froman Times New Roman;
|
||
|
\f2\fmodern Courier New;
|
||
|
\f3\fswiss MS Sans Serif;
|
||
|
\f4\froman MS Serif;
|
||
|
}
|
||
|
\deff0
|
||
|
\fs18
|
||
|
|
||
|
{\comment ************************************************************
|
||
|
*
|
||
|
* Now lets get started. Here is the first topic of this help file. It
|
||
|
* is normal for this to be the CONTENTS page.
|
||
|
*
|
||
|
**********************************************************************
|
||
|
}
|
||
|
|
||
|
{\comment ************************************************************
|
||
|
* CONTENTS
|
||
|
**********************************************************************
|
||
|
}
|
||
|
\keepn
|
||
|
{\comment ************************************************************
|
||
|
* The WinHelp compiler turns 'footnotes' into the special index tags
|
||
|
* used to organize the popups and jumps throughout your help file.
|
||
|
**********************************************************************
|
||
|
}
|
||
|
|
||
|
{\comment ************************************************************
|
||
|
* WinHelp used 'footnotes' to keep track of various aspects about a
|
||
|
* particular help page. The three most common footnote types are
|
||
|
* "#", "$", and "K".
|
||
|
* --------------------------------------------------------------------
|
||
|
* # Specifies a context string. The text parameter can be any
|
||
|
* combination of letters and digits but must not contain spaces.
|
||
|
* Uppercase and lowercase characters are treated as equivalent
|
||
|
* characters (case-insensitive). The context string can be used
|
||
|
* with the \v statement in other topics to create links to this
|
||
|
* topic. (I'll talk about this later). The Context string should be
|
||
|
* unique to this help file, and is never actually seen by the user.
|
||
|
* --------------------------------------------------------------------
|
||
|
* $ Specifies a topic title. Windows Help uses the topic title to
|
||
|
* identify the topic in the Search and History dialog boxes. The
|
||
|
* text parameter can be any combination of characters including
|
||
|
* spaces.
|
||
|
* --------------------------------------------------------------------
|
||
|
* K Specifies a keyword. Windows Help displays all keywords in the
|
||
|
* Help file in the Search dialog box and allows a user to choose
|
||
|
* a topic to view by choosing a keyword. The text parameter can be
|
||
|
* any combination of characters including spaces. If the first
|
||
|
* character is the letter K, it must be preceded with an extra
|
||
|
* space or a semicolon. More than one keyword can be given by
|
||
|
* separating the keywords with semicolons (;). A topic cannot
|
||
|
* contain keywords unless it also has a topic title.
|
||
|
**********************************************************************
|
||
|
}
|
||
|
|
||
|
#{\footnote CONTENTS}
|
||
|
${\footnote Contents}
|
||
|
K{\footnote Contents}
|
||
|
\{bmc generic.bmp\} {\comment : Here we include the bitmap image}
|
||
|
{
|
||
|
\b
|
||
|
\fs32
|
||
|
\tab
|
||
|
GENERIC: A Windows Application
|
||
|
}
|
||
|
\par
|
||
|
\pard
|
||
|
|
||
|
\sb150
|
||
|
|
||
|
GENERIC is a sample application to illustrate the 'minimum' functionality
|
||
|
that should be expected of a well behaved Win32 application. Other
|
||
|
then that, this application has virtually no actual functionality of
|
||
|
its own. This makes it easier for you to use this as a starting point
|
||
|
for your own application development, or investigation of the Win32
|
||
|
API.\par
|
||
|
|
||
|
You are now looking at the \"WinHelp\" file for Generic. It illustrates
|
||
|
a few of the aspects of a simple Help file for an application.
|
||
|
|
||
|
This is the Contents page of the help file, and should give a very quick
|
||
|
overview of the application, as well as provide a useful outline of
|
||
|
the contents of this file so the user can easily navigate through the
|
||
|
information it contains.
|
||
|
|
||
|
\par
|
||
|
\{bmc help.bmp\}
|
||
|
\par
|
||
|
|
||
|
{\comment ************************************************************
|
||
|
* Hot Spots:
|
||
|
* Here is where we actually end up using the 'Context String' data
|
||
|
* that we specify in footnotes. There are two important parts of
|
||
|
* this. First, is the 'label' for the footnote, which is followed
|
||
|
* by the 'destination'. The 'label' must have some sort of underline
|
||
|
* style associated with it. A double underline (as used here) means
|
||
|
* that this is a 'jump' hotspot, which means WinHelp will jump to
|
||
|
* the help topic indicated by the destination. A single underline
|
||
|
* would cause a 'popup' hotspot, which means a popup window is
|
||
|
* brought up temporarily with the help topic data. The 'destination'
|
||
|
* must immediately follow the 'label', and uses the \v attribute
|
||
|
* which would normally make the text 'invisible' or 'hidden' So
|
||
|
* in the first example below, the user would see 'Introduction' on
|
||
|
* their help page, and when they click on it, it jumps to the
|
||
|
* topic with a '#' footnote label of 'INTRODUCTION'. To create
|
||
|
* popup hotspots instead of \uldb, use \ul or \strike.
|
||
|
**********************************************************************
|
||
|
}
|
||
|
\tab{\uldb Introduction{\v INTRODUCTION}}\par
|
||
|
\tab{\uldb First Application Topic{\v FIRST_TOPIC}}\par
|
||
|
\tab{\uldb Second Application Topic{\v SECOND_TOPIC}}\par
|
||
|
\tab{\uldb Third Application Topic{\v THIRD_TOPIC}}\par
|
||
|
\tab{\uldb Fourth Application Topic{\v FOURTH_TOPIC}}\par
|
||
|
|
||
|
\pard
|
||
|
\page
|
||
|
|
||
|
{\comment ************************************************************
|
||
|
* INTRODUCTION
|
||
|
**********************************************************************
|
||
|
}
|
||
|
\keepn
|
||
|
#{\footnote INTRODUCTION}
|
||
|
${\footnote Introduction}
|
||
|
K{\footnote Introduction}
|
||
|
\{bmc generic.bmp\} {\comment : Here we include the bitmap image}
|
||
|
{
|
||
|
\b
|
||
|
\fs32
|
||
|
\tab
|
||
|
GENERIC: A Windows Application
|
||
|
}
|
||
|
\par\pard
|
||
|
\sb100
|
||
|
Generic is intended as an application that essentially has no
|
||
|
functionality, other then that which should be expected from {\i any}
|
||
|
Windows application. As such, it should be considered an illustration
|
||
|
of the {\i minimum} functionality that your application should contain.
|
||
|
|
||
|
\par
|
||
|
\pard
|
||
|
|
||
|
\page
|
||
|
|
||
|
{\comment ************************************************************
|
||
|
* BRIEFINTRO
|
||
|
**********************************************************************
|
||
|
}
|
||
|
\keepn
|
||
|
#{\footnote BRIEFINTRO}
|
||
|
This is an extremely minimal application that illustrates features
|
||
|
that should be common to all Windows Applications.
|
||
|
\par
|
||
|
\pard
|
||
|
\page
|
||
|
|
||
|
{\comment ************************************************************
|
||
|
* First Topic
|
||
|
**********************************************************************
|
||
|
}
|
||
|
\keepn
|
||
|
#{\footnote FIRST_TOPIC}
|
||
|
${\footnote Topics}
|
||
|
K{\footnote Topics: First}
|
||
|
{\fs24\b First Application Topic}
|
||
|
\par\pard
|
||
|
\sb100
|
||
|
[Text to be included at a later time]
|
||
|
\par
|
||
|
\pard
|
||
|
|
||
|
\page
|
||
|
|
||
|
{\comment ************************************************************
|
||
|
* Second Topic
|
||
|
**********************************************************************
|
||
|
}
|
||
|
\keepn
|
||
|
#{\footnote SECOND_TOPIC}
|
||
|
${\footnote Topics}
|
||
|
K{\footnote Topics: Second}
|
||
|
{\fs24\b Second Application Topic}
|
||
|
\par\pard
|
||
|
\sb100
|
||
|
[Text to be included at a later time]
|
||
|
\par
|
||
|
\pard
|
||
|
|
||
|
\page
|
||
|
|
||
|
{\comment ************************************************************
|
||
|
* Third Topic
|
||
|
**********************************************************************
|
||
|
}
|
||
|
\keepn
|
||
|
#{\footnote THIRD_TOPIC}
|
||
|
${\footnote Topics}
|
||
|
K{\footnote Topics: Third}
|
||
|
{\fs24\b Third Application Topic}
|
||
|
\par\pard
|
||
|
\sb100
|
||
|
[Text to be included at a later time]
|
||
|
\par
|
||
|
\pard
|
||
|
|
||
|
\page
|
||
|
|
||
|
{\comment ************************************************************
|
||
|
* Fourth Topic
|
||
|
**********************************************************************
|
||
|
}
|
||
|
\keepn
|
||
|
#{\footnote FOURTH_TOPIC}
|
||
|
${\footnote Topics}
|
||
|
K{\footnote Topics: Fourth}
|
||
|
{\fs24\b Fourth Application Topic}
|
||
|
\par\pard
|
||
|
\sb100
|
||
|
[Text to be included at a later time]
|
||
|
\par
|
||
|
\pard
|
||
|
|
||
|
\page
|
||
|
|
||
|
|
||
|
{\comment *** End of RTF File *** }
|
||
|
}
|