From: <mie...@us...> - 2009-08-09 19:48:33
|
Revision: 5075 http://oorexx.svn.sourceforge.net/oorexx/?rev=5075&view=rev Author: miesfeld Date: 2009-08-09 19:48:26 +0000 (Sun, 09 Aug 2009) Log Message: ----------- Deprecate the ooDialog assignWindow() method. Modified Paths: -------------- docs/trunk/oodialog/basedialog.sgml docs/trunk/oodialog/dialogcontrolc.sgml docs/trunk/oodialog/plainuserdialogc.sgml Property Changed: ---------------- docs/trunk/ docs/trunk/oodialog/ Property changes on: docs/trunk ___________________________________________________________________ Modified: svn:mergeinfo - /docs/branches/4.0.0/trunk:4444-4445,4448,4450,4574,4640,4654,4661,4819,4927,4934-4937,4962,5046-5047 + /docs/branches/4.0.0/trunk:4444-4445,4448,4450,4574,4640,4654,4661,4819,4927,4934-4937,4962,5046-5047,5071,5074 Property changes on: docs/trunk/oodialog ___________________________________________________________________ Modified: svn:mergeinfo - /docs/branches/4.0.0/trunk:4444 /docs/branches/4.0.0/trunk/oodialog:4445,4448,4450,4574,4640,4654,4661,4819,4927,4934-4937,4962,5046-5047 + /docs/branches/4.0.0/trunk:4444 /docs/branches/4.0.0/trunk/oodialog:4445,4448,4450,4574,4640,4654,4661,4819,4927,4934-4937,4962,5046-5047,5071,5074 Modified: docs/trunk/oodialog/basedialog.sgml =================================================================== --- docs/trunk/oodialog/basedialog.sgml 2009-08-09 19:01:44 UTC (rev 5074) +++ docs/trunk/oodialog/basedialog.sgml 2009-08-09 19:48:26 UTC (rev 5075) @@ -234,8 +234,8 @@ <entry><link linkend="mthAddUserMsg">addUserMsg</link></entry> </row> <row> -<entry>AssignWindow</entry> -<entry><link linkend="assignwindow">AssignWindow</link></entry> +<entry>assignWindow <emphasis role="bold">(deprecated)</emphasis></entry> +<entry><link linkend="assignwindow">assignWindow</link> <emphasis role="bold">(deprecated)</emphasis></entry> </row> <row> <entry>AsyncMessageHandling</entry> @@ -8197,6 +8197,22 @@ </variablelist> </section> +<section id="assignwindow"><title>assignWindow <emphasis role="bold">(deprecated)</emphasis></title> +<indexterm> + <primary>deprecated</primary> + <secondary>BaseDialog class</secondary> + <tertiary>assignWindow</tertiary> +</indexterm> +<note><title>Note</title><para> + This method is deprecated and always returns 0, <emphasis role="italic">the connection + failed</emphasis>. To work with a dialog or dialog control object, construct the proper ooDialog + object. To control a window not owned by your program use the <emphasis role="italic">find</emphasis>() + method of the <emphasis role="italic">WindowsManger</emphasis>. The <emphasis + role="italic">WindowsManager</emphasis> class is part of the <emphasis + role="italic">WinSystm.cls</emphasis> package. +</para></note> +</section> + <section id="h000246"><title>SetWindowTitle</title> <indexterm><primary>SetWindowTitle</primary></indexterm> <programlisting> Modified: docs/trunk/oodialog/dialogcontrolc.sgml =================================================================== --- docs/trunk/oodialog/dialogcontrolc.sgml 2009-08-09 19:01:44 UTC (rev 5074) +++ docs/trunk/oodialog/dialogcontrolc.sgml 2009-08-09 19:48:26 UTC (rev 5075) @@ -133,10 +133,6 @@ <entry><link linkend="assignfocus">AssignFocus</link></entry> </row> <row> -<entry>AssignWindow</entry> -<entry><link linkend="assignwindow">AssignWindow</link></entry> -</row> -<row> <entry>CaptureMouse</entry> <entry><link linkend="capturemouse">CaptureMouse</link></entry> </row> @@ -1886,63 +1882,8 @@ </para></note> </section> -<section id="assignwindow"><title>AssignWindow</title> -<indexterm><primary>AssignWindow</primary></indexterm> -<programlisting> -<![CDATA[ ->>-aDialogControl~AssignWindow(--hwnd--)----------------------->< - - -]]> -</programlisting> - -<para>The AssignWindow method connects a dialog or dialog -control with an existing object of the PlainBaseDialog or DialogControl class. -Note that the connected dialog or dialog control might not support all methods -provided by the DialogControl class.</para> -<variablelist> -<varlistentry><term><emphasis role="bold">Note Well:</emphasis></term> -<listitem><para>The <computeroutput>AssignWindow</computeroutput> method is used -internally to connect Rexx objects (a <computeroutput>DialogControl -</computeroutput> object) to the underlying Windows dialog control. It is not -recommended that the programmer use this method unless he throughly understands -the ooDialog framework. Otherwise, using this method has the potential for -causing unpredictable behavior. -</para></listitem></varlistentry> -<varlistentry><term><emphasis role="bold">Arguments:</emphasis></term> -<listitem><para>The only argument is: -<variablelist> -<varlistentry><term>hwnd</term> -<listitem><para>The handle to the dialog or dialog control that you want to assign to -the DialogControl object. -</para></listitem></varlistentry> -</variablelist> -</para></listitem></varlistentry> -<varlistentry><term><emphasis role="bold">Return value:</emphasis></term> -<listitem><para>The handle to the dialog or dialog control that has been assigned, or -0 if the connection failed. -</para></listitem></varlistentry> -<varlistentry><term><emphasis role="bold">Example:</emphasis></term> -<listitem><para>The following example searches the desktop for a dialog with the title "Monitoring -Applications", connects it to the object <computeroutput>dlgc</computeroutput> of the DialogControl -class, and then hides the dialog: -<programlisting> -<![CDATA[ -dlgc = .DialogControl~new -... -whnd = FindWindow("Monitoring Application") -if whnd \= 0 then do - dlgc~AssignWindow(whnd) - dlgc~Display("HIDE") -end -]]> -</programlisting> -</para></listitem></varlistentry> -</variablelist> </section> -</section> - <section id="eventDialogControl"><title>Connect Event Methods</title> <indexterm><primary>connect event methods</primary> <secondary>DialogControl class</secondary></indexterm> Modified: docs/trunk/oodialog/plainuserdialogc.sgml =================================================================== --- docs/trunk/oodialog/plainuserdialogc.sgml 2009-08-09 19:01:44 UTC (rev 5074) +++ docs/trunk/oodialog/plainuserdialogc.sgml 2009-08-09 19:48:26 UTC (rev 5075) @@ -368,10 +368,6 @@ <entry><link linkend="mthAddWhiteRect">addWhiteRect</link></entry> </row> <row> -<entry>AssignWindow</entry> -<entry><link linkend="assignwindow">AssignWindow</link></entry> -</row> -<row> <entry>AutoDetection</entry> <entry><link linkend="h001439">AutoDetection</link></entry> </row> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |