readme.htm

Office 97 中『小帮手』

<td bgcolor="#506000"><b><font color="#ffffff"><small>Methods</small></font></b></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small>
<b>procedure AdjustClientSize;</b><br>
Sets the client size of the control to size of the loaded <a href="#Actor Library">actor library</a>.
</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small>
<b>constructor Create(AOwner: TComponent);</b><br>
Creates and initializes a new TAssistantPanel.
</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small>
<b>destructor Destroy; </b><br>
Destroys an instance of TAssistantPanel.
</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small>
<b>function GestureAt(X, Y: Integer): <a href="#TRequestID">TRequestID</a>;</b><br>
Plays the gesture animation according to the screen coordinate specified by X and Y parameters.
The function returns a unique id for played animation or zero on error.
</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small>
<b>function GlanceAt(X, Y: Integer): <a href="#TRequestID">TRequestID</a>;</b><br>
Plays the glance animation according to the screen coordinate specified by X and Y parameters.
The function returns a unique id for played animation or zero on error.
</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small>
<b>function IsValid(RequestID: <a href="#TRequestID">TRequestID</a>): Boolean;</b><br>
If the specified RequestID is a playing or queued animation, the function returns true.
</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small>
<b>function LookAt(X, Y: Integer): <a href="#TRequestID">TRequestID</a>;</b><br>
Plays the look animation according to the screen coordinate specified by X and Y parameters.
The function returns a unique id for played animation or zero on error.
</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small>
<a name="PlayIndex"></a>
<Font Color="#008888">Delphi 4.0, 5.0:</Font><br>
<b>function Play(Index: Word): <a href="#TRequestID">TRequestID</a>;</b><br>
<Font Color="#008888">Delphi 3.0:</Font><br>
<b>function PlayIndex(Index: Word): <a href="#TRequestID">TRequestID</a>;</b><br>
Plays the animation specified by the animation's index.
The function returns a unique id for played animation or zero on error.
</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small>
<Font Color="#008888">Delphi 3.0, 4.0, 5.0:</Font><br>
<b>function Play(Name: String): <a href="#TRequestID">TRequestID</a>;</b><br>
<Font Color="#008888">Delphi 3.0:</Font><br>
<b>function PlayName(Name: String): <a href="#TRequestID">TRequestID</a>;</b><br>
Plays the animation specified by the animation's name.
The function returns a unique id for played animation or zero on error.
</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small>
<Font Color="#008888">Delphi 3.0, 4.0, 5.0:</Font><br>
<b>function Play(Action: <a href="#TActorAction">TActorAction</a>): <a href="#TRequestID">TRequestID</a>;</b><br>
<Font Color="#008888">Delphi 3.0:</Font><br>
<b>function PlayAction(Action: <a href="#TActorAction">TActorAction</a>): <a href="#TRequestID">TRequestID</a>;</b><br>
Plays randomly one of animations associated to the action.
The function returns a unique id for played animation or zero on error.
</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small>
<b>procedure Stop(RequestID: <a href="#TRequestID">TRequestID</a>);</b><br>
Stops the specified animation if it is playing or removes it from queue if it is
queued.
</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small>
<b>procedure StopAll;</b><br>
Stops the current playing animation and empties the animation queue.
</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small>
<b>function WaitFor(RequestID: <a href="#TRequestID">TRequestID</a>): Boolean;</b><br>
Waits for specified animation until its playing terminate. If the specified animation
has an infinite loop, the function returns immediately with a false result.
</small></td>
</tr>
</table>

<br>

<table border="0" cellpadding="2" cellspacing="2" width="100%">
<caption><a name="TAssistantPanel-Events"><b>TAssistantPanel Events</b></a></caption>
<tr>
<td width="25%" bgcolor="#506000"><b><font color="#ffffff"><small>Event Name</small></font></b></td>
<td width="20%" bgcolor="#506000"><b><font color="#ffffff"><small>Type</small></font></b></td>
<td bgcolor="#506000"><b><font color="#ffffff"><small>Description</small></font></b></td>
</tr>
<tr><a name="OnCanResize"></a>
<td bgcolor="#F0E000"><small><b>OnCanResize</b></small></td>
<td bgcolor="#F0E000"><small><b>TCanResizeEvent</b></small></td>
<td bgcolor="#F0E000"><small>Occurs when an attempt is made to resize the control.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><b>OnChange</b></small></td>
<td bgcolor="#FFEE00"><small><b>TNotifyEvent</b></small></td>
<td bgcolor="#FFEE00"><small>Occurs whenever the
<a href="#ActorLibrary-ap">ActorLibrary</a> changes.</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><b>OnClick</b></small></td>
<td bgcolor="#F0E000"><small><b>TNotifyEvent</b></small></td>
<td bgcolor="#F0E000"><small>Occurs when the user clicks on the control.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><b>OnConstrainedResize</b></small></td>
<td bgcolor="#FFEE00"><small><b>TConstrainedResizeEvent</b></small></td>
<td bgcolor="#FFEE00"><small>Occurs immediately after <a href="#OnCanResize">OnCanResize</a>.</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><b>OnDblClick</b></small></td>
<td bgcolor="#F0E000"><small><b>TNotifyEvent</b></small></td>
<td bgcolor="#F0E000"><small>Occurs when the user double-clicks on the control.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><b>OnDragDrop</b></small></td>
<td bgcolor="#FFEE00"><small><b>TDragDropEvent</b></small></td>
<td bgcolor="#FFEE00"><small>Occurs when the user drops an object being dragged.</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><b>OnDragOver</b></small></td>
<td bgcolor="#F0E000"><small><b>TDragDropEvent</b></small></td>
<td bgcolor="#F0E000"><small>Occurs when the user drags an object over the control.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><b>OnEndDrag</b></small></td>
<td bgcolor="#FFEE00"><small><b>TEndDragEvent</b></small></td>
<td bgcolor="#FFEE00"><small>Occurs when the dragging of an object ends, either by dropping the object or by canceling the dragging.</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><b>OnIdle</b></small></td>
<td bgcolor="#F0E000"><small><b><a href="#TIdleEvent">TIdleEvent</a></b></small></td>
<td bgcolor="#F0E000"><small>This event triggered when the control needs to play an idle animation.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><b>OnMouseDown</b></small></td>
<td bgcolor="#FFEE00"><small><b>TMouseEvent</b></small></td>
<td bgcolor="#FFEE00"><small>Occurs when the user presses a mouse button with the mouse pointer over the control.</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><b>OnMouseMove</b></small></td>
<td bgcolor="#F0E000"><small><b>TMouseMoveEvent</b></small></td>
<td bgcolor="#F0E000"><small>Occurs when the user moves the mouse pointer while the mouse pointer is over the control.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><b>OnMouseUp</b></small></td>
<td bgcolor="#FFEE00"><small><b>TMouseEvent</b></small></td>
<td bgcolor="#FFEE00"><small>Occurs when the user releases a mouse button that was pressed with the mouse pointer over the control.</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><b>OnPlayStart</b></small></td>
<td bgcolor="#F0E000"><small><b><a href="#TPlayEvent">TPlayEvent</a></b></small></td>
<td bgcolor="#F0E000"><small>This event just triggered when an animation begins to play.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><b>OnPlayStop</b></small></td>
<td bgcolor="#FFEE00"><small><b><a href="#TPlayEvent">TPlayEvent</a></b></small></td>
<td bgcolor="#FFEE00"><small>This event triggered when an animation terminates.</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><b>OnResize</b></small></td>
<td bgcolor="#F0E000"><small><b>TNotifyEvent</b></small></td>
<td bgcolor="#F0E000"><small>Occurs immediately after the control is resized.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><b>OnStartDrag</b></small></td>
<td bgcolor="#FFEE00"><small><b>TStartDragEvent</b></small></td>
<td bgcolor="#FFEE00"><small>Occurs when the user begins to drag the control or an object it contains by left-clicking on the control and holding the mouse button down.</small></td>
</tr>
</table>
<br>

<br>
<a name="Type Definitions and Constants"><h5>TYPE DEFINITIONS AND CONSTANTS</h5></a>
<p>
Here, is a list of type definitions and constants that declared and used by Office 97
Assistant package. The multi-lingual application developers can change string constants
to the appropriate language.
</p>

<table border="0" cellpadding="2" cellspacing="2" width="100%">
<caption><a name="Types"><b>Type Definitions</b></a></caption>
<tr>
<td bgcolor="#506000"><b><font color="#ffffff"><small>Type Definitions</small></font></b></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small>
<b><a name="TRequestID">TRequestID</a> = Cardinal;</b><br>
This type holds a unique id for playing or queued animations. By this id you can stop
or wait for the animation.
</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small>
<b><a name="TBalloonKind">TBalloonKind</a> = (bkNone, bkMessage, bkTips, bkGuide, bkSpeak, bkThink);</b>
<table width="100%" border="0" cellpadding="0" cellspacing="5">
<tr><td width="15%"><small>bkNone</small></td><td><small>Indicates the balloon is not visible</small></td></tr>
<tr><td width="15%"><small>bkMessage</small></td><td><small>Indicates the visible balloon had shown by <a href="#MessageDlg">MessageDlg</a> method</small></td></tr>
<tr><td width="15%"><small>bkTips</small></td><td><small>Indicates the visible balloon had shown by <a href="#ShowTips">ShowTips</a> method</small></td></tr>
<tr><td width="15%"><small>bkGuide</small></td><td><small>Indicates the visible balloon had shown by <a href="#ShowGuide">ShowGuide</a> method</small></td></tr>
<tr><td width="15%"><small>bkSpeak</small></td><td><small>Indicates the visible balloon had shown by <a href="#Speak">Speak</a> method</small></td></tr>
<tr><td width="15%"><small>bkThink</small></td><td><small>Indicates the visible balloon had shown by <a href="#Think">Think</a> method</small></td></tr>
</table>
</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small>
<b><a name="TBalloonPos">TBalloonPos</a> = (bpCenter, bpTopLeft, bpTopRight, bpRightTop,
bpRightBottom, bpBottomRight, bpBottomLeft, bpLeftBottom, bpLeftTop);</b><br>
<table width="100%" border="0" cellpadding="0" cellspacing="5">
<tr><td width="15%"><small>bpCenter</small></td><td><small>The balloon centered to the Windows Desktop</small></td></tr>
<tr><td width="15%"><small>bpTopLeft</small></td><td><small>The balloon placed on top of the assistant window and aligned to left of it</small></td></tr>
<tr><td width="15%"><small>bpTopRight</small></td><td><small>The balloon placed on top of the assistant window and aligned to right of it</small></td></tr>
<tr><td width="15%"><small>bpRightTop</small></td><td><small>The balloon placed on right of the assistant window and aligned to top of it</small></td></tr>
<tr><td width="15%"><small>bpRightBottom</small></td><td><small>The balloon placed on right of the assistant window and aligned to bottom of it</small></td></tr>
<tr><td width="15%"><small>bpBottomRight</small></td><td><small>The balloon placed on bottom of the assistant window and aligned to left of it</small></td></tr>
<tr><td width="15%"><small>bpBottomLeft</small></td><td><small>The balloon placed on bottom of the assistant window and aligned to right of it</small></td></tr>
<tr><td width="15%"><small>bpLeftBottom</small></td><td><small>The balloon placed on left of the assistant window and aligned to top of it</small></td></tr>
<tr><td width="15%"><small>bpLeftTop</small></td><td><small>The balloon placed on left of the assistant window and aligned to bottom of it</small></td></tr>
</table>
</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small>
<b><a name="TBgMode">TBgMode</a> = (bmNone, bmTiled, bmCentered, bmStretched);</b><br>
<table width="100%" border="0" cellpadding="0" cellspacing="5">
<tr><td width="15%"><small>bmNone</small></td><td><small>The background image will be ignored</small></td></tr>
<tr><td width="15%"><small>bmTiled</small></td><td><small>The background image will be tiled on the control</small></td></tr>
<tr><td width="15%"><small>bmCentered</small></td><td><small>The background image will be displayed on the center of the control</small></td></tr>
<tr><td width="15%"><small>bmStretched</small></td><td><small>The background image will be stretched to the client size of the control</small></td></tr>
</table>
</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small>
<b><a name="TExitType">TExitType</a> = (etNone, etAnimation, etExitBranch);</b><br>
<table width="100%" border="0" cellpadding="0" cellspacing="5">
<tr><td width="15%"><small>etNone</small></td><td><small>Indicates the animation does not have a return animation</small></td></tr>
<tr><td width="15%"><small>etAnimation</small></td><td><small>Indicates the animation has a return animation</small></td></tr>
<tr><td width="15%"><small>etExitBranch</small></td><td><small>Indicates the animation returns by using exit branches</small></td></tr>
</table>
Office 97 Assistant Package plays the return animation automatically.
</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small>
<b><a name="TTipsDl