📄 readme.htm
字号:
<html>
<head>
<meta name="Author" content="Kambiz R. Khojasteh">
<title>Office 97 Assistant Package for Delphi</title>
<style type="text/css">
<!--
a:link {color: #BB0000; text-decoration: none}
a:visited {color: #BB0000; text-decoration: none}
a:hover {color: #FF0000; text-decoration: underline}
a:active {color: #FF0000; text-decoration: underline}
-->
</style>
</head>
<body bgcolor="#FFFFCC">
<basefont face="arial, helvetica, verdana" size="2">
<table border="0" cellspacing="8px" cellpadding="0">
<tr>
<td valign="top">
<font size="+2"><b>Office 97 Assistant Package for Delphi</b></font>
<hr noshade size="1" width="100%">
by Kambiz R. Khojasteh
</td>
<td valign="top">
<sup><b>Version 1.6</b></sup></b>
</td>
</tr>
</table>
<br>
<a name="Table of Contents"><h5>TABLE OF CONTENTS</h5></a>
<ul>
<li><a href="#Description"><b>Description</b></a></li>
<li><a href="#Compatibility"><b>Compatibility</b></a></li>
<li><a href="#Installation"><b>Installation</b></a></li>
<li><a href="#Office Assistant Components"><b>Office Assistant Components</b></a></li>
<ul>
<li><a href="#TAssistant">TAssistant v1.0</a></li>
<ul>
<small>
<li><a href="#TAssistant-Properties"><b>Properties</b></a></li>
<li><a href="#TAssistant-Methods"><b>Methods</b></a></li>
<li><a href="#TAssistant-Events"><b>Events</b></a></li>
</small>
</ul>
<li><a href="#TAssistantPanel">TAssistantPanel v1.0</a></li>
<ul>
<small>
<li><a href="#TAssistantPanel-Properties"><b>Properties</b></a></li>
<li><a href="#TAssistantPanel-Methods"><b>Methods</b></a></li>
<li><a href="#TAssistantPanel-Events"><b>Events</b></a></li>
</small>
</ul>
</ul>
<li><a href="#Type Definitions and Constants"><b>Type Definitions and Constants</b></a></li>
<ul>
<li><a href="#Types">Type Definitions</a></li>
<li><a href="#Constants">Constants</a></li>
</ul>
<li><a href="#Actor Library"><b>Actor Library</b></a></li>
<li><a href="#Actor Editor"><b>Assistant Actor Editor</b></a></li>
<li><a href="#History"><b>Version History</b></a></li>
<li><a href="#Disclaimer"><b>Disclaimer</b></a></li>
<li><a href="#Licence"><b>Licence</b></a></li>
<li><a href="#Credits"><b>Credits</b></a></li>
<li><a href="#Contact Information"><b>Contact Information</b></a></li>
</ul>
<br>
<a name="Description"><h5>DESCRIPTION</h5></a>
<p>
By using <b>Microsoft<sup>®</sup> Agent</b>, application developers can create an
assistant similar to Office 97 Assistant for their applications.
Unfortunately there are some limitations and difficulties for this purpose:
</p>
<p>
The application needs to check for MS Agent ActiveX installation on the local machine and if
it had not installed, downloads it and at least one MS Agent Character from the Microsoft web
site and installs them.
</p>
<p>
I searched the web for a component that acts like Office 97 Assistant but I didn't find
any component that satisfy me. Then I decided to write my own component so those Delphi
programmers can use an assistant in their applications in easier manner with the
most power of it.
</p>
<p>
Office 97 Assistant Package contains two components. By these components you have
an <a href="#TAssistant"><b>Assistant</b></a> with most abilities of Microsoft
Assistant and an <a href="#TAssistantPanel"><b>Assistant Panel</b></a> to create
preview or options dialogs.
</p>
<br>
<a name="Compatibility"><h5>COMPATIBILITY</h5></a>
<p>
Office 97 Assistant Package is built for Borland Delphi 3.0, 4.0, and 5.0.
Because of Delphi 3.0 does not support new features of Delphi 4.0 and 5.0,
when using the package on this version of Delphi consider following notes:
<ol>
<li>Change to <b>BiDiMode</b> property of <a href="#Assistant"><b>TAssistant</b></a>
has no effect.</li>
<li>To play animation by using its index reference, developers must use
<a href="#PlayIndex"><b>PlayIndex</b><a> method instead of <b>Play</b> method.</li>
</ol>
</p>
<br>
<a name="Installation"><h5>INSTALLATION</h5></a>
<p>
<font color="#006666"><b>Note:</b></font>
Office 97 Assistant Package needs <a href="http://www.the-hoskings.freeserve.co.uk/"><b>TOffice97Button</b></a>
component <b>version 1.91 or later</b> written by <a href="mailto:jonathan@the-hoskings.freeserve.co.uk"><b>Jonathan Hosking</b><a>.
</p>
<p>
To install Office 97 Assistant Package follow the procedure below:
</p>
<ol>
<li>Unzip the file <b>ASSIST.ZIP</b> to any directory</li>
<li>Copy files of <a href="http://www.the-hoskings.freeserve.co.uk/"><b>TOffice97Button</b></a> component to the above directory</li>
<li>Click on <b>File|Open</b> menu item</li>
<li>Select the file <b>ASSIST<font color="#006666">X</font>0.DPK</b> from the open dialog and click <b>Open</b><br>(<font color="#006666"><b>X</b></font> is 3, 4, or 5 according to your Delphi version)</li>
<li>Click the <b>Install</b> button on the package window to install the component</li>
<li>Click on <b>File|Close</b> menu item to close the package window</li>
<li>Click on <b>Tools|Environment Options</b> menu item</li>
<li>Go to <b>Library</b> tab</li>
<li>Add the install directory to <b>Library Path</b></li>
<li>Click <b>OK</b> to confirm changes</li>
</ol>
You could also add <b>oaReg.pas</b> into a new or existing package.<br>
<br>
<a name="Office Assistant Components"><h5>OFFICE ASSISTANT COMPONENTS</h5></a>
<p>
Office 97 Assistant Package contains two components:
</p>
<ul>
<li><a href="#TAssistant"><b>TAssistant</b></a></li>
<ul>
<li><a href="#TAssistant-Properties">Properties</a></li>
<li><a href="#TAssistant-Methods">Methods</a></li>
<li><a href="#TAssistant-Events">Events</a></li>
</ul>
<li><a href="#TAssistantPanel"><b>TAssistantPanel</b></a></li>
<ul>
<li><a href="#TAssistantPanel-Properties">Properties</a></li>
<li><a href="#TAssistantPanel-Methods">Methods</a></li>
<li><a href="#TAssistantPanel-Events">Events</a></li>
</ul>
</ul>
<p>
<font color="#006666"><b>Note:</b></font>
Office 97 Assistant Package needs at least one
<a href="#Actor Library"><b>Actor Library</b></a>.
You can download actor libraries from my web site.
</p>
<a name="TAssistant"><b>TAssistant:</b>
<p>
TAssistant is a non-visual component. By placing this component on the main form
of the application and filling its properties you have a powerful assistant. Some
features of this component are:
<ul>
<li>Assistant's actor can be changed.</li>
<li>It has got tips balloon to show tip of the day or any other tips.</li>
<li>Powered by a guide balloon to accept the user search requests and showing
topics of the search result.</li>
<li>Has a MessageDlg that use balloon shape dialogs.</li>
<li>It has got round rectangular and cloud balloons.</li>
<li>Use a separated thread for playing animations.</li>
<li>Can be moved even when a modal balloon is showing.</li>
<li>Uses a queue for waiting animations.</li>
<li>Each queued or playing animation can be stopped.</li>
<li>Has three level of idling.</li>
<li>Plays idle animations automatically.</li>
<li>Idle times can be controlled manually.</li>
<li>Supports <nobr>bi-directional</nobr> languages and can be customized easily for
<nobr>multi-lingual</nobr> applications.</li>
<li>Powered by a large collection of events.</li>
<li>It is able to show animations with transparent background.</li>
<li>Can stretch the animation and keeps its original aspect ratio.</li>
<li>The speed of animations can be modified within the component.</li>
</ul>
The following tables contain the list of all TAssistant properties, methods and events.
</p>
<table border="0" cellpadding="2" cellspacing="2" width="100%">
<caption><a name="TAssistant-Properties"><b>TAssistant Properties</b></a></caption>
<tr>
<td width="25%" bgcolor="#506000"><b><font color="#ffffff"><small>Property Name</small></font></b></td>
<td width="20%" bgcolor="#506000"><b><font color="#ffffff"><small>Data Type</small></font></b></td>
<td bgcolor="#506000"><b><font color="#ffffff"><small>Description</small></font></b></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><b>ActorCopyright <sup><nobr>Read-only</nobr></sup></b></small></td>
<td bgcolor="#F0E000"><small><b>Strings</b></small></td>
<td bgcolor="#F0E000"><small>Contains the actor's copyright string of the currently loaded <a href="#Actor Library">actor library</a>.</small></td>
</tr>
<tr><a name="ActorLibrary-a"></a>
<td bgcolor="#FFEE00"><small><b>ActorLibrary</b></small></td>
<td bgcolor="#FFEE00"><small><b>String</b></small></td>
<td bgcolor="#FFEE00"><small>Specifies the filename of the currently loaded <a href="#Actor Library">actor library</a>.</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><b>ActorName <sup><nobr>Read-only</nobr></sup></b></small></td>
<td bgcolor="#F0E000"><small><b>Strings</b></small></td>
<td bgcolor="#F0E000"><small>Contains the actor's name of the currently loaded <a href="#Actor Library">actor library</a>.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><b>ActorVersion <sup><nobr>Read-only</nobr></sup></b></small></td>
<td bgcolor="#FFEE00"><small><b>Strings</b></small></td>
<td bgcolor="#FFEE00"><small>Contains the version number of the currently loaded <a href="#Actor Library">actor library</a>.</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><b>Animations <sup><nobr>Read-only</nobr></sup></b></small></td>
<td bgcolor="#F0E000"><small><b><a href="#TAnimation">TAnimation</a></b></small></td>
<td bgcolor="#F0E000"><small>This property is an array of animations data that indexed from 0 to AnimationCount-1.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><b>AnimationCount <sup><nobr>Read-only</nobr></sup></b></small></td>
<td bgcolor="#FFEE00"><small><b>Word</b></small></td>
<td bgcolor="#FFEE00"><small>Contains the number of animations in the currently loaded <a href="#Actor Library">actor library</a>.</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><b>AutoIdle</b></small></td>
<td bgcolor="#F0E000"><small><b>Boolean</b></small></td>
<td bgcolor="#F0E000"><small>Controls whether the assistant plays the idle animations automatically.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><b>AutoSize</b></small></td>
<td bgcolor="#FFEE00"><small><b>Boolean</b></small></td>
<td bgcolor="#FFEE00"><small>Determines whether the assistant resizes to accommodate the actor it loads.</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><b>Balloon</b></small></td>
<td bgcolor="#F0E000"><small><b>TBalloonOptions</b></small></td>
<td bgcolor="#F0E000"><small>Contains the balloon properties.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><img width="10" height="10" hspace="4"><b>Balloon.BorderColor</b></small></td>
<td bgcolor="#FFEE00"><small><b>TColor</b></small></td>
<td bgcolor="#FFEE00"><small>Specifies the border color of the balloon.</small></td>
</tr>
<tr>
<td bgcolor="#F0E000"><small><img width="10" height="10" hspace="4"><b>Balloon.Color</b></small></td>
<td bgcolor="#F0E000"><small><b>TColor</b></small></td>
<td bgcolor="#F0E000"><small>Specifies the background color of the balloon.</small></td>
</tr>
<tr>
<td bgcolor="#FFEE00"><small><img width="10" height="10" hspace="4"><b>Balloon.Font</b></small></td>
<td bgcolor="#FFEE00"><small><b>TFont</b></small></td>
<td bgcolor="#FFEE00"><small>Controls the attributes of text written on the balloon.</small></td>
</tr>
<tr><a name="Office2000Look"></a>
<td bgcolor="#F0E000"><small><img width="10" height="10" hspace="4"><b>Balloon.Office2000Look</b></small></td>
<td bgcolor="#F0E000"><small><b>Boolean</b></small></td>
<td bgcolor="#F0E000"><small>Determines if an Office 2000 look is applied to balloons.</small></td>
</tr>
<tr><a name="BalloonAnchor"></a>
<td bgcolor="#FFEE00"><small><b>BalloonAnchor</b></small></td>
<td bgcolor="#FFEE00"><small><b>TCustomForm</b></small></td>
<td bgcolor="#FFEE00"><small>Determines the form that arrow of balloon points to it. This property helps you to control position of balloon when assistant is not visible. As default when assistant is hidden and balloon is visible, balloon is centered to desktop and <a href="#BalloonPos">BalloonPos</a> property has bpCenter value.</small></td>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -