<?xml version="1.0" encoding="UTF-8"?>
<!--

Documentation for LCL (Lazarus Component Library) and LazUtils (Lazarus 
Utilities) are published under the Creative Commons Attribution-ShareAlike 4.0 
International public license.

https://creativecommons.org/licenses/by-sa/4.0/legalcode.txt
https://gitlab.com/freepascal.org/lazarus/lazarus/-/blob/main/docs/cc-by-sa-4-0.txt

Copyright (c) 1997-2025, by the Lazarus Development Team.

-->
<fpdoc-descriptions>
<package name="LCL">
<!--
====================================================================
DBLogDlg
====================================================================
-->
<module name="DBLogDlg">
<short>
Contains forms and routines used to implement a database login dialog.
</short>
<descr>
<p>
<file>dblogdlg.pas</file> contains the <var>TLoginDialog</var> dialog form 
used to capture the user name and password used to login to a database. The 
<var>LoginDialogEx</var> routine is provided to create, configure, and 
execute a TLogInDialog instance.
</p>
</descr>

<!-- used units -->
<element name="System"/>
<element name="Classes"/>
<element name="SysUtils"/>
<element name="Forms"/>
<element name="Controls"/>
<element name="StdCtrls"/>
<element name="ButtonPanel"/>
<element name="DB"/>

<element name="TLoginDialog">
<short>Implements a database login dialog form.</short>
<descr>
<p>
<var>TLoginDialog</var> is a <var>TForm</var> descendant which implements a 
database login form. TLoginDialog contains labels and edits used to display 
and/or edit Database Name, User Name, and Password values. Database Name is 
read-only and cannot be changed on the form. The User Name can optionally be 
read-only. It also has a button panel with Login and Cancel buttons.
</p>
<p>
Use <var>LoginDialogEx</var> to create, configure, and display an instance of 
TLoginDialog using the arguments passed to the routine.
</p>
</descr>
<seealso>
<link id="LoginDialogEx"/>
</seealso>
</element>

<element name="TLoginDialog.lDatabaseName">
<short>Label used to display the Database Name for the dialog form.</short>
<descr/>
<seealso/>
</element>

<element name="TLoginDialog.lDatabase">
<short>Label for the Database Name field.</short>
<descr/>
<seealso/>
</element>

<element name="TLoginDialog.lUserName">
<short>Label for the User Name field.</short>
<descr/>
<seealso/>
</element>

<element name="TLoginDialog.lPassword">
<short>Label for the Password field.</short>
<descr/>
<seealso/>
</element>

<element name="TLoginDialog.eUserName">
<short>Edit control used to enter the User Name.</short>
<descr/>
<seealso/>
</element>

<element name="TLoginDialog.ePassword">
<short>Edit control used to enter the Password.</short>
<descr/>
<seealso/>
</element>

<element name="TLoginDialog.BtnPanel">
<short>Button Panel for the OK and Cancel buttons on the dialog.</short>
<descr/>
<seealso/>
</element>

<element name="TLoginDialog.Create">
<short>Constructor for the class instance.</short>
<descr/>
<seealso/>
</element>
<element name="TLoginDialog.Create.TheOwner">
<short>Owner of the class instance.</short>
</element>

<element name="LoginDialogEx">
<short>Creates, configures, and displays a TLoginDialog dialog form.</short>
<descr>
<p>
<var>LoginDialogEx</var> is a <var>Boolean</var> function used to create, 
configure, and display a <var>TLoginDialog</var> dialog form. The return 
value contains <b>True</b> when the <var>ModalResult</var> for the form 
display contains the value <var>mrOk</var>.
</p>
<p>
LoginDialogEx creates an instance of TLoginDialog, and sets the values in the 
controls used on the form. The arguments in <var>ADatabaseName</var>, 
<var>AUserName</var>, and <var>APassword</var> are assigned to the 
corresponding controls. <var>UserNameReadOnly</var> indicates whether the 
edit control for UserName can be modified; the default value is <b>False</b>.
</p>
<p>
LoginDialogEx calls <var>ShowModal</var> to display the form as a modal 
dialog, and captures the <var>ModalResult</var>. When ModalResult contains 
<var>mrOk</var>, the return value is set to <b>True</b>.
</p>
<p>
LoginDialogEx frees the form instance prior to exiting from the routine.
</p>
</descr>
<seealso/>
</element>
<element name="LoginDialogEx.Result">
<short><b>True</b> when the ModalResult for the form is mrOk.</short>
</element>
<element name="LoginDialogEx.ADatabaseName">
<short>Database name displayed on the form.</short>
</element>
<element name="LoginDialogEx.AUserName">
<short>User name edited on the form.</short>
</element>
<element name="LoginDialogEx.APassword">
<short>Password edited on the form.</short>
</element>
<element name="LoginDialogEx.UserNameReadOnly">
<short><b>True</b> if the User Name cannot be changed in the form.</short>
</element>

<element name="rsDBLogDlgCaption">
<short>Resource string with the Caption displayed on the dialog form.</short>
<descr/>
<seealso/>
</element>

<element name="rsDBLogDlgDatabase">
<short>Resource string for the Database label.</short>
<descr/>
<seealso/>
</element>

<element name="rsDBLogDlgUserName">
<short>Resource string for the User Name label.</short>
<descr/>
<seealso/>
</element>

<element name="rsDBLogDlgPassword">
<short>Resource string for the Password label.</short>
<descr/>
<seealso/>
</element>

<element name="rsDBLogDlgLogin">
<short>Resource string with the caption for the OK button.</short>
<descr/>
<seealso/>
</element>

</module>
<!-- DBLogDlg -->
</package>
</fpdoc-descriptions>
