readme.htm

Delphi 窗口状态记录控件

	
	<li>
		<code>ChangeLog.txt</code> &ndash; component's change log.
	</li>

	<li>
		<code>Demos\DemoReadMe.htm</code> &ndash; read me file explianing use of
		demo programs.
	</li>
	
	<li>
		<code>Demos\WdwStateDemos.bpg</code> &ndash; demo project group file.
	</li>
	
	<li>
		<code>Demos\1\StandardDemo.dpr</code> &ndash; demo 1 project file.
	</li>
	
	<li>
		<code>Demos\1\StandardDemo.res</code> &ndash; icon resource for demo 1.
	</li>

	<li>
		<code>Demos\1\FmDemo.pas/.dfm</code> &ndash; 1st demo's main window form
		and source.
	</li>
	
	<li>
		<code>Demos\1\FmDemoDlg.pas/.dfm</code> &ndash; 1st demo's modal dialog
		form and source.
	</li>

	<li>
		<code>Demos\2\StandAloneDemo.dpr</code> &ndash; demo 2 project file.
	</li>

	<li>
		<code>Demos\2\StandAloneDemo.res</code> &ndash; icon resource for demo
		2.
	</li>
	
	<li>
		<code>Demos\2\FmMain.pas/.dfm</code> &ndash; 2nd demo's main window form
		and source.
	</li>
	
</ul>

<p>
	You can now proceed to install the components and property editor using the
	<strong>emphasised</strong> files above. Installation methods vary between
	Delphi versions, so follow the instructions that apply to your version
	below. Note that <code><strong>$(DELPHI)</strong></code> represents the
	path where the appropriate version of Delphi was installed. Similarly
	<code><strong>$(BDS)</strong></code> refers to the installation path of a
	version of the Borland Development System.
</p>

<ul>
	<li><a href="#bds">Installation with Delphi 2005 &amp; 2006</a></li>
	<li><a href="#d3">Installation with Delphi 3 to 7</a></li>
</ul>



<h3 id="bds">Installation with Delphi 2005 &amp; 2006</h3>

<p>
	The components must be installed into a Delphi Win32 design package. It is
	assumed that you will be installing into an existing package. You may decide
	to install into the &quot;user&quot; package:
	<code>$(BDS)\Lib\dclusr.dpk</code>.
</p>

<ol class="spaced">

	<li>
		Decide upon a suitable location into which to install the components.
		This may be a subdirectory of your <code>Borland Studio Projects</code>
		or <code>$(BDS)\lib</code> folders.
	</li>
	
	<li>
		Copy <code>PJWdwState.pas</code> and <code>PJWdwState.dcr</code> to the
		chosen installation folder. If you wish to also install the
		<var>HKEY</var> property editor for use with <var>TPJRegWdwState</var>
		you should copy <code>PJHKEYPropEdit.pas</code> to the same location.
	</li>

	
	<li>
		Start the Development System (selecting the Delphi Win32 personality if
		appropriate) then:

		<ul>

			<li>
				Open the required package. Select <em>File | Open</em> menu and
				choose a suitable package source file.
			</li>

			<li>
				The package will now be displayed in the Project Manager with a
				<code>.bpl</code> extension. Right click the package's entry and
				select <em>Add</em> to display the <em>Add</em> dialog box.
				Enter the full path to <code>PJWdwState.pas</code> in the
				<em>Unit file name</em> edit box (use the <em>Browse</em> button
				to navigate to the file). Click <em>OK</em> to add the component
				to the package.
			</li>
			
			<li>
				If required repeat the previous step for
				<code>PJHKEYPropEdit.pas</code>.
			</li>

			<li>
				Back in the Project Manager, check that
				<code>PJWdwState.pas</code> and <code>PJWdwState.dcr</code> and,
				if appropriate, <code>PJHKEYPropEdit.pas</code>, appear under
				the package's <em>Contains</em> node. If so, right click the
				package's entry again and select <em>Compile</em>. If the
				resulting compilation succeeds a message should be displayed
				confirming that <var>TPJWdwState</var>,
				<var>TPJRegWdwState</var> and <var>TPJUserWdwState</var> have
				been registered. The components should now appear in the
				&quot;DelphiDabbler&quot; section of the Tool Palette. (Note
				this will only appear when a form is selected in the designer).
				If you have installed <code>PJHKEYPropEdit.pas</code> the
				property editor will be used by the Object Inspector when a
				property of type <var>HKEY</var> is selected.
			</li>
			
			<li>
				If the components do not appear the package may not have been
				installed. Install it from the Project Manager by selecting the
				package's <em>Install</em> right click menu option.
			</li>

			<li>
				Close the package project using the <em>File | Close</em> menu
				item. Accept any prompt that offers to save the package project.
			</li>
			
		</ul>
		
	</li>

	<li>
		If you wish you can now delete <code>PJWdwState.pas</code> and, if used,
		<code>PJHKEYPropEdit.pas</code>, from the chosen installation folder.
	</li>

	
	<li>
		The supplied help file cannot be integrated with the IDE's help system.
		However it can be used independently of the IDE, albeit with reduced
		functionality.
	</li>

	<li>
		The demo programs can be loaded into Delphi and compiled and run as
		required.
	</li>

</ol>


<h3 id="d3">Installation with Delphi 3 to 7</h3>

<p>
	The components must be installed into a design package. It is assumed that
	you will be installing into an existing package. You may wish to use the
	&quot;user&quot; package named <code>dclusr.dpk</code> or
	<code>dclusrXX.dpk</code> (where <code>XX</code> is a version number). This
	package can be found in <code>$(DELPHI)\Lib</code>. 
</p>

<ol class="spaced">

	<li>
		Decide upon a suitable location into which to install the components.
		This may be a subdirectory of your <code>$(DELPHI)\lib</code> folder.
	</li>
	
	<li>
		Copy <code>PJWdwState.pas</code> and <code>PJWdwState.dcr</code> to the
		chosen installation folder. If you wish to also install the
		<var>HKEY</var> property editor for use with <var>TPJRegWdwState</var>
		you should copy <code>PJHKEYPropEdit.pas</code> to the same location.
	</li>
	
	<li>	
		Start Delphi then:
		
		<ul>
			
			<li>
				Choose the <em>Component | Install Component</em> menu option to
				display the <em>Install Component</em> dialog box. Ensure the
				<em>Into existing package</em> tab is selected. Enter the full
				path to <code>PJWdwState.pas</code> in the <em>Unit file
				name</em> edit box (use the adjacent <em>Browse</em> button to
				navigate to the file). If required, repeat the previous step for
				<code>PJHKEYPropEdit.pas</code>. Choose the required package from the
				<em>Package description</em> combo box, or by navigating to the
				package using <em>Browse</em>. Click <em>OK</em> to confirm your
				selections. 
			</li>

			<li>
				A confirmation dialog box may displayed, querying whether it is
				OK to rebuild and reinstall the package. Click <em>Yes</em> to
				proceed.
			</li>
			
			<li>
				The package will now be built and a dialog box should be
				displayed stating that the <var>TPJWdwState</var>,
				<var>TPJRegWdwState</var> and <var>TPJUserWdwState</var>
				components have been installed. Click <em>OK</em> to dismiss the
				dialog box.
			</li>

			<li>
				The components will appear on the &quot;DelphiDabbler&quot;
				palette. If you have installed <code>PJHKEYPropEdit.pas</code>
				the property editor will be used by the Object Inspector when a
				property of type <var>HKEY</var> is selected.
			</li>

		</ul>

	</li>

	<li>
		If you wish you can now delete <code>PJWdwState.pas</code> and, if used,
		<code>PJHKEYPropEdit.pas</code>, from the chosen installation folder.
	</li>

	<li>
		The provided help file can be integrated with the IDE's OpenHelp system.
		Delphi 6 and 7 also require the use of the supplied <code>.als</code>
		file. The simplest way to install help is to use my
		<a href="http://www.delphidabbler.com/software?id=chi">Component Help
		Installer Expert</a> (v2.2.1 or later). If you prefer to install
		manually,
		<a href="http://www.delphidabbler.com/articles?article=15">this
		article</a> explains the process.
	</li>

	<li>
		The demo program can be loaded into Delphi and compiled and run as
		required. <span class="highlight">Please note</span> that the first
		demo does not compile or run with Delphi 3.
	</li>

</ol>



<p class="gototop">
	&raquo; <a href="#contents">Contents</a>
</p>

<h2 id="changelog">
	Change log
</h2>

<p>
	A complete change log is provided in a text file that is included in the
	download.
</p>


<p class="gototop">
	&raquo; <a href="#contents">Contents</a>
</p>

<h2 id="license">
	License
</h2>

<p>
	This source code is subject to the Mozilla Public License Version 1.1 (the
	&quot;License&quot;); you may not use this program except in compliance
	with the License. You may obtain a copy of the License at
	<a href="http://www.mozilla.org/MPL/.">http://www.mozilla.org/MPL/</a>.
</p>

<p>
	Software distributed under the License is distributed on an &quot;AS
	IS&quot; basis, WITHOUT WARRANTY OF ANY KIND, either express or implied.
	See the License for the specific language governing rights and limitations
	under the License.
</p>

<p>
	The Original Code is Window State Components.
</p>

<p>
	The Initial Developer of the Original Code is Peter Johnson
	(<a href="http://www.delphidabbler.com/">http://www.delphidabbler.com/)</a>.
</p>

<p>
	Portions created by the Initial Developer are Copyright &copy; 1999-2007
	Peter Johnson. All Rights Reserved.
</p>

<p>
	Contributor(s):
</p>

<div class="indent">
	Stefan Winter<br />
	Enrico Bortolazzi<br />
	Bruce J Miller
</div>

<p>
	All relevant trademarks are acknowledged.
</p>


<p class="gototop">
	&raquo; <a href="#contents">Contents</a>
</p>

<h2 id="author">
	About the Author
</h2>

<p>
	I'm Peter Johnson &ndash; a hobbyist programmer living in Ceredigion in West
	Wales,  UK, writing write mainly in Delphi. My programs are available for
	download from:
	<a href="http://www.delphidabbler.com/">http://www.delphidabbler.com/</a>.
</p>



<div class="endnotes">

	<div class="comments">
		Please
		<a href="http://www.delphidabbler.com/contact">
		let me know</a> if you have any comments about the components, if you
		have found a bug, or you want to suggest any updates.
	</div>

	<div class="copyright">
		This info sheet is copyright &copy; 2005, P D Johnson,
		<a href="http://www.delphidabbler.com/">
		www.delphidabbler.com</a>
	</div>

</div>

</body>

</html