paweld/lazarus
1
0
Fork 0
mirror of https://gitlab.com/freepascal.org/lazarus/lazarus.git synced 2025-08-13 06:09:14 +02:00
Code Issues Packages Projects Releases Wiki Activity

Docs: LCL/forms. Updates TApplication.GetParams to fix incorrect descriptions for arguments.

Browse Source
This commit is contained in:
dsiders 2024-04-05 04:33:37 +01:00
parent b1fb44a88e
commit 37f11d9720
1 changed files with 28 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
docs/xml/lcl/forms.xml
View File

@ -15271,37 +15271,53 @@ Called from the <var>BeforeFinalization</var> routine which is used as the
</element> </element>
<element name="TApplication.GetParams"> <element name="TApplication.GetParams">
<short>Returns the command line argument at the specified position.</short> <short>
Returns the command line argument at the specified ordinal position.
</short>
<descr> <descr>
<p> <p>
<var>GetParams</var> is an overridden <var>String</var> function in <var>GetParams</var> is an overridden <var>String</var> function in
<var>TApplication</var> used to get the argument at the specified position in TApplication and is used to get the argument at the specified position in the
the command line. It re-implements the read access specifier for the property command line. It re-implements the read access specifier for the Params
from the ancestor class, and does not call the inherited method. property from the ancestor class (TCustomApplication), and does not call the
inherited method.
</p> </p>
<p> <p>
<var>Index</var> is the ordinal position for the requested parameter value. <var>Index</var> is the ordinal position for the requested parameter value.
Index must be in the range <b>0..<var>ParamCount</var>-1</b> or an Index should be in the range <b>0..<var>ParamCount</var></b>. Values in Index
<var>EListError</var> exception is raised. Position <b>0</b> contains the outside this range cause an empty string ('') to be returned for a parameter
name of the executable file for the application. value.
</p> </p>
<p> <p>
The return value contains the UTF-8-encoded <var>String</var> with the value In most cases, the parameter at position <b>0</b> contains the name and
for the parameter at the specified position. It is retrieved using the optional path to the executable file for the application. For cross-platform
<var>ParamStrUTF8</var> routine for the position in Index. compatibility, use the ExeName property to get the path and name for the binary
instead. Subsequent index positions contain any command line arguments passed
to the executable.
</p>
<p>
The return value contains the UTF-8-encoded string with the value for the
parameter at the specified position, or an empty string when not present. The
value is retrieved using the <var>ParamStrUTF8</var> routine for the position
in Index.
</p> </p>
</descr> </descr>
<seealso> <seealso>
<link id="#lazutils.lazutf8.ParamStrUTF8">ParamStrUTF8</link> <link id="#lazutils.lazutf8.ParamStrUTF8">ParamStrUTF8</link>
<link id="#fcl.custapp.TCustomApplication.Params">TCustomApplication.Params</link> <link id="#fcl.custapp.TCustomApplication.Params">TCustomApplication.Params</link>
<link id="#fcl.custapp.TCustomApplication.ParamCount">TCustomApplication.ParamCount</link> <link id="#fcl.custapp.TCustomApplication.ParamCount">TCustomApplication.ParamCount</link>
<link id="#rtl.system.ParamStr">ParamStr</link>
</seealso> </seealso>
</element> </element>
<element name="TApplication.GetParams.Result"> <element name="TApplication.GetParams.Result">
<short>String with the parameter value, or an empty string.</short> <short>
String with the requested parameter value, or an empty string when not found.
</short>
</element> </element>
<element name="TApplication.GetParams.Index"> <element name="TApplication.GetParams.Index">
<short>Ordinal position for the requested parameter value.</short> <short>
Ordinal position for the requested parameter value.
</short>
</element> </element>
<element name="TApplication.Create"> <element name="TApplication.Create">