From a3d4d06bf13683b15fdb9a961239bacac84819d3 Mon Sep 17 00:00:00 2001 From: juha Date: Fri, 20 Mar 2020 10:15:35 +0000 Subject: [PATCH] Docs: New documentation files for LCL. Issue #36785, patch from Don Siders. git-svn-id: trunk@62778 - --- .gitattributes | 6 + docs/xml/lcl/calcform.xml | 642 ++++++++++++++++++++++++++++++++ docs/xml/lcl/calendarpopup.xml | 269 +++++++++++++ docs/xml/lcl/dblogdlg.xml | 157 ++++++++ docs/xml/lcl/finddlgunit.xml | 126 +++++++ docs/xml/lcl/replacedlgunit.xml | 132 +++++++ docs/xml/lcl/timepopup.xml | 371 ++++++++++++++++++ 7 files changed, 1703 insertions(+) create mode 100644 docs/xml/lcl/calcform.xml create mode 100644 docs/xml/lcl/calendarpopup.xml create mode 100644 docs/xml/lcl/dblogdlg.xml create mode 100644 docs/xml/lcl/finddlgunit.xml create mode 100644 docs/xml/lcl/replacedlgunit.xml create mode 100644 docs/xml/lcl/timepopup.xml diff --git a/.gitattributes b/.gitattributes index 1b7f5f851d..3647e773f0 100644 --- a/.gitattributes +++ b/.gitattributes @@ -6288,7 +6288,9 @@ docs/xml/lcl/arrow.xml svneol=LF#text/xml eol=lf docs/xml/lcl/asyncprocess.xml svneol=native#text/plain docs/xml/lcl/buttonpanel.xml svneol=native#text/plain docs/xml/lcl/buttons.xml svneol=native#text/xml +docs/xml/lcl/calcform.xml -text svneol=native#text/plain docs/xml/lcl/calendar.xml svneol=LF#text/xml eol=lf +docs/xml/lcl/calendarpopup.xml -text svneol=native#text/plain docs/xml/lcl/checklst.xml svneol=LF#text/xml eol=lf docs/xml/lcl/clipbrd.xml svneol=LF#text/xml eol=lf docs/xml/lcl/colorbox.xml svneol=LF#text/xml eol=lf @@ -6310,6 +6312,7 @@ docs/xml/lcl/dbactns.xml svneol=LF#text/xml eol=lf docs/xml/lcl/dbctrls.xml svneol=LF#text/xml eol=lf docs/xml/lcl/dbextctrls.xml svneol=native#text/plain docs/xml/lcl/dbgrids.xml svneol=LF#text/xml eol=lf +docs/xml/lcl/dblogdlg.xml -text svneol=native#text/plain docs/xml/lcl/defaulttranslator.xml svneol=LF#text/xml eol=lf docs/xml/lcl/dialogs.xml svneol=LF#text/xml eol=lf docs/xml/lcl/dialogs/displaymessagebox.pas svneol=native#text/pascal @@ -6325,6 +6328,7 @@ docs/xml/lcl/extctrls/statusbar.pas svneol=native#text/plain docs/xml/lcl/extdlgs.xml svneol=LF#text/xml eol=lf docs/xml/lcl/extgraphics.xml svneol=LF#text/xml eol=lf docs/xml/lcl/filectrl.xml svneol=LF#text/xml eol=lf +docs/xml/lcl/finddlgunit.xml svneol=native#text/plain docs/xml/lcl/forms.xml svneol=LF#text/xml eol=lf docs/xml/lcl/forms/tapplication_queueasynccall.pas svneol=native#text/plain docs/xml/lcl/fpmake.xml svneol=native#text/plain @@ -6410,6 +6414,7 @@ docs/xml/lcl/postscriptunicode.xml svneol=native#text/plain docs/xml/lcl/printers.xml svneol=LF#text/xml eol=lf docs/xml/lcl/propertystorage.xml svneol=LF#text/xml eol=lf docs/xml/lcl/registerlcl.xml svneol=native#text/plain +docs/xml/lcl/replacedlgunit.xml -text svneol=native#text/plain docs/xml/lcl/rubberband.xml svneol=LF#text/xml eol=lf docs/xml/lcl/shellctrls.xml svneol=native#text/plain docs/xml/lcl/spin.xml svneol=LF#text/xml eol=lf @@ -6417,6 +6422,7 @@ docs/xml/lcl/stdactns.xml svneol=LF#text/xml eol=lf docs/xml/lcl/stdctrls.xml svneol=LF#text/xml eol=lf docs/xml/lcl/stdctrls/tcustomcheckbox_allowgrayed.pas svneol=native#text/plain docs/xml/lcl/themes.xml svneol=native#text/plain +docs/xml/lcl/timepopup.xml -text svneol=native#text/plain docs/xml/lcl/tmschema.xml svneol=native#text/plain docs/xml/lcl/toolwin.xml svneol=LF#text/xml eol=lf docs/xml/lcl/utrace.xml svneol=LF#text/xml eol=lf diff --git a/docs/xml/lcl/calcform.xml b/docs/xml/lcl/calcform.xml new file mode 100644 index 0000000000..666987a107 --- /dev/null +++ b/docs/xml/lcl/calcform.xml @@ -0,0 +1,642 @@ + + + + + + Contains classes and types used in TCalculatorForm + + + + + + + + + + + + + + + + + + Defines the default number of digits of precision used for values in TCalculatorForm + + + + + + + + Specifies an event handler signalled for Key events occurring in TCalculatorForm + + + + + + Key value examined in the event handler + + + + + Specifies an event handler signalled when the display in TCalculatorForm is changed + + + + + + + + +

+ TCalculatorState is an enumerated type with values that represent the status for keys/operations in the calculator. TCalculatorState is the type used to implement the Status property in TCalculatorPanel. +

+ + + + + + + Value on the First key press + + + Value after the oepration for the key has been applied successfully + + + Value when the operation resulted in an error + + + + + +

+ TCalculatorLayout is an enumerated type with values that represent the layout for keys and panels on a calculator form. TCalculatorLayout is passed as an argument to the CreateCalculatorForm routine, and to methods in TCalculatorForm and TCalculatorPanel. +

+ + + + + + + Use the content from the TCalcuatorDialog layout property + + + The default layout with larger button sizes and more whitespace + + + The compact layout with smaller button sizes + + + + + Implements a panel used for buttons and the value display in a calculator form + + + + + + + + + + + + + + + + + + + + + + + + + Sets the value for the text property + + + + + + + New value for the property + + + + Ensures that Text is updated and displayed when Status is csFirst + + + + + + + Performs actions for a key press not handled by a button in the calculator panel + + + + + + + + + + Clears the display and operator in the calculator panel + + + + + + + Updates the calculator panel to reflect an error condition, and signals OnError + + + + + + + + Sets the Text in the calculator panel to the specified value, and signals OnDisplayChange + + + + + + Double value formatted and assigned to the Text property + + + + Gets the Double value represented in the Text property + + + + + + + + + Finds the calculator button which handles the specified key character + +

+ Key contains a character value to locate in the button captions on the panel. Keys which are not represented by buttons, like Enter (#13) and Escape (#27), are translated to the value used for the target button. In addition, when ',' is used as the decimal separator on the system, it is translated into the '.' decimal notation. +

+

+ FindButton iterates through the Controls on the panel to locate the button using the associated Key. The return value is Nil when a button is not located for the value in Key. +

+ + + + + + Button which handles the Key, or Nil when no button is available for Key + + + + Key character to locate in the buttons for the calculator panel + + + + Translates a mouse click on a button to the character key used in CalcKey + + + + + Calculator button for the button click notification + + + + + + ErrorBeep is an empty implementation in the current LCL version. + + + + + + Sets the display text for the associated control and signals OnTextChange + + + + + + + Initializes and configures the calculator panel using the specified layout + + + + + + + + + + + + + Locates the button using the specified Key and perform its Click method + + CalcKey is called when a button is located using the specified Key. + + + + + Object for the KeyPress event + + + Key value captured in the panel + + + + Loads the value in Text into the Clipboard as a text value + + + + + + + Pastes text from the Clipboard into the text display for the calculator panel + + + + + + + Gets the minumum number of precision digits allowable for the panel + + + + + + + + + + Updates the Memory indicator to reflect a non-zero value in the Memory property + + + + + + + Contains the Double value representing the Text in the panel + + + + + + Contains the Double value stored in the memory fopr the calculator + + + + + + + Maximum number of digits of precision allowed for the Double value in the calculator + + + + + + + + Indicates if a beep occurs when an error condition is detected in the calculator panel + + + + + + + + Contains the status or state for the calculator panel + + + + + + + + Character representing the last operator entered in the calculator panel + + + + + + Text representation for the Double value in the calculator + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Color for the calculator panel + + + + + + + Implements the form used to display a calculator in a TCalculatorDialog + + + + + + + + + + + + + + + + Performs actions needed to handle OnKeyPress events in the calculator form + + + + + + Object for the event notification + + + Key handled in the event handler + + + + Implements a copy menu item in the pop-up menu for the form + + + + + Object for the event notification + + + + Gets the value for the Value property + + + + + Value for the property + + + + Implements a paste menu item in the pop-up menu for the form + + + + + + + + + Sets the value for the Value property + + + + + New value for the property + + + + Performs actions needed when the OK button is clicked + + + + + + + + + Performs actions needed when the Cancel button is clicked + + + + + Object for the event notification + + + + Performs actions needed for a key received in the calculator form + + + + + Object for the event notification + + + Key examined in the method + + + + Performs actions needed when the calculator display is changed + + + + + Object for the event notification + + + + Initializes the calculator form using the specified layout + + + + + Layout applied to the calculator form instance + + + + Constructor for the class instance + + + + + Owner of the class instance + + + TCalculatorLayout used for the form instance + + + + Value displayed or returned from the calculator + + + + + + + + + + + + Panel with the calculator keys, operators,memory buttons, et. al. + + + + + + Panel for the display area on the calculator form + + + + + + Label used to display the value in the panel + + + + + + Event handler signalled to handle keys press on the calculator form + + + + + + Event handler signalled when the calculator display has been changed + + + + + + Creates and configures a new TCalculatorForm instance + + + + + + + + Form instance created in the method + + + Owner for the new form instance + + + Layout for the calculator panel in the form instance + + + + + + + + Color for the numeric digit buttons in a calculator + + + + + + Color for the Memory button in a calculator + + + + + + Color for the Clear button in a calculator + + + + + + Color for the OK button in a calculator + + + + + + Color for the Cancel button in a calculator + + + + + + Color for miscellaneous "other" buttons in a calculator + + + + + + Color for text on the display area for a calculator + + + + + + Color for the background of the display area in a calculator + + + + + + Font name used for buttons and displays in a calculator + + + + + + Font size used for buttons and displays in a calculator + + + + + + Font style used for buttons and displays in a calculator + + + + + + + + diff --git a/docs/xml/lcl/calendarpopup.xml b/docs/xml/lcl/calendarpopup.xml new file mode 100644 index 0000000000..d5bd9e63e8 --- /dev/null +++ b/docs/xml/lcl/calendarpopup.xml @@ -0,0 +1,269 @@ + + + + + + Implements a pop-up form with a TCalendar control for TDateEdit + + + + + + + + + + + + + + + + + Specifies an event handler signalled when a date is selected on a pop-up calendar form + + +

+ TReturnDateEvent specifies an event handler signalled when a date is selected on a pop-up calendar form. TReturnDateEvent is the type used to implement the OnReturnDate event handler in TCalendarPopupForm. Applications must implement an object procedure used to respond to the event notification. It is passed as an argument to the ShowCalendarPopup routine. +

+ + + + + + + + Object for the event notification; normally the pop-up calendar form + + + TDateTime value for the date selected on the calendar form + + + + + Implements a non-modal pop-up form used to select a date from a TCalendar control + + +

+ TCalendarPopupForm is a TForm descendant which implements a non-modal pop-up form used to select a date with a TCalendar control. It includes the OnReturnDate event handler to perform the actions needed when a date is selected using the Calendar control. +

+

+ TCalendarPopupForm is used as the non-modal dialog executed when the Button for the TDateEdit control is clicked. +

+

+ Use the ShowCalendarPopup routine to create, configure, and display a pop-up calendar form. +

+ + + + + + + + + + + TCalendar control used to select a date on the form + +

+ Calendar is a TCalendar member which contains the calendar control displayed on the form. It allows selection of date, and calls the ReturnDate method when the Month, Day, or Year in the control is changed using either the mouse or the keyboard. Calendar is configured in the Initialize method using the TDateTime and TDisplaySettings provided as arguments. +

+

+ Use the ShowCalendarPopup routine to provide the date/time value and display settings needed in the pop-up calendar form. +

+ + + + + + + + + + + + + + Performs actions needed when a double click mouse event occurs in the Calendar control + + +

+ CalendarDblClick ensures that the mouse event is within the bounds for the Calendar control by calling its HitTest method. When the mouse event occurs on the Month or Year calendar parts, the ReturnDate method is called to signal the OnReturnDate event handler and close the form. +

+ + + + + + + + + + + + + + + Implements the OnKeyDown event handler for the Calendar control + +

+ CalendarKeyDown is a procedure which implements the OnKeyDown event handler for the Calendar control. The method ensures that the key down virtual key code represented by Key and Shift is applied to the Calendar control, and includes: +

+
+
VK_RETURN, VK_SPACE
+
+ Calls ReturnDate to apply the selected date value in Month view, and signals the OnReturnDate event handler. +
+
VK_ESCAPE
+
Calls Close to close the form.
+
+

+ If the virtual key code is handled in the method, the value in Key is set to zero (0). Otherwise, it is retained for use in event handlers at the Form or Application level. +

+ + + + + + + + + + + Object for the event notification; the Calendar control in this case + + + Virtual key code examined in the method + + + Virtual key modifier examined in the method + + + + Implements the OnClose event handler for the form + +

+ Ensures that the FormDeactivate method is removed from the registered OnDeactivate handlers in Application. The value in CloseAction is set to caFree in the method. +

+ + + + + Object for the event notification + + + Close action to perform on exit from the event handler + + + + Implements the OnCreate event handler for the form + + + + + Object for the event notification + + + + Implements the OnDeactivate event handler for the form + +

+ Ensures that the FormDeactivate method is added to the OnDeactivate handlers in Application. +

+ + + + + Object for the event notification + + + + + + + + Configures the Calendar control in the pop-up form + +

+ Applies the values in the ADate and DisplaySettings arguments to the Calendar control. +

+ + + + + Date value assigned to the Calendar control + + + Display settings applied to the Calendar control + + + + + Ensures that the form and the calling control are visible on the current monitor + + + + + + Coordinates where the pop-up form is displayed + + + + + Signals the OnReturnDate event handler using the DateTime value in the Calendar control + + +

+ Calls Close to close the form if it has not already been executed. +

+ + + + + + Creates, configures, and displays a TCalendarPopupForm instance + +

+ ShowCalendarPopup is a procedure used to create, configure, and display a TCalendarPopupForm instance. ShowCalendarPopup stores arguments to the routine in properties for the pop-up calendar form, and calls its Initialize method to configure the Calendar control. +

+

+ ShowCalendarPopup calls the Show in the form to make it visible, and calls KeepInView to ensure that the form is fully visible on the current monitor. +

+ + + + + + + + + + + + + Coordinates where the pop-up calendar form is displayed + + + Initial date displayed in the Calendar for the form + + + Display settings applied to the Calendar control + + + Event handler signalled when a new date value is selected + + + Event handler signalled when the pop-up form is shown or hidden + + + The control which creates the pop-up and captures its return value + + + + + + diff --git a/docs/xml/lcl/dblogdlg.xml b/docs/xml/lcl/dblogdlg.xml new file mode 100644 index 0000000000..869275ac75 --- /dev/null +++ b/docs/xml/lcl/dblogdlg.xml @@ -0,0 +1,157 @@ + + + + + + Contains forms and routines used to implement a database login dialog + + + + + + + + + + + + + + Implements a database login dialog form + +

+ TLoginDialog is a TForm 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. +

+

+ Use LoginDialogEx to create, configure, and display an instance of TLoginDialog using the arguments passed to the routine. +

+ + + + + + + + Label used to display the Database Name for the dialog form + + + + + + Label for the Database Name field + + + + + + + Label for the User Name field + + + + + + Label for the Password field + + + + + + Edit control used to enter the User Name + + + + + + Edit control used to enter the Password + + + + + + Button Panel for the OK and Cancel buttons on the dialog + + + + + + Constructor for the class instance + + + + + Owner of the class instance + + + + Creates, configures, and displays a TLoginDialog dialog form + +

+ LoginDialogEx is a Boolean function used to create, configure, and display a TLoginDialog dialog form. The return value contains True when the ModalResult for the form display contains the value mrOk. +

+

+ LoginDialogEx creates an instance of TLoginDialog, and sets the values in the controls used on the form. The arguments in ADatabaseName, AUserName, and APassword are assigned to the corresponding controls. UserNameReadOnly indicates whether the edit control for UserName can be modified; the default value is False. +

+

+ LoginDialogEx calls ShowModal to display the form as a modal dialog, and captures the ModalResult. When ModalResult contains mrOk, the return value is set to True. +

+

+ LoginDialogEx frees the form instance prior to exiting from the routine. +

+ + + + + True when the ModalResult for the form is mrOk + + + Database name displayed on the form + + + User name edited on the form + + + Password edited on the form + + + True if the User Name cannot be changed in the form + + + + Resource string with the Caption displayed on the dialog form + + + + + + Resource string for the Database label + + + + + + Resource string for the User Name label + + + + + + Resource string for the Password label + + + + + + Resource string with the caption for the OK button + + + + + + + + diff --git a/docs/xml/lcl/finddlgunit.xml b/docs/xml/lcl/finddlgunit.xml new file mode 100644 index 0000000000..da3254d179 --- /dev/null +++ b/docs/xml/lcl/finddlgunit.xml @@ -0,0 +1,126 @@ + + + + + + + +

+ Only the .lfm file is used by the LCL (dialogs.pp). This unit is itself is not compiled into the LCL. This form is used to design the .lfm file. +

+

+ The source code is a copy of ../lcl/include/finddialog.inc. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/xml/lcl/replacedlgunit.xml b/docs/xml/lcl/replacedlgunit.xml new file mode 100644 index 0000000000..5af6e2fb43 --- /dev/null +++ b/docs/xml/lcl/replacedlgunit.xml @@ -0,0 +1,132 @@ + + + + + + + +

+ Only the .lfm file is used by the LCL (dialogs.pp). This unit is itself is not compiled into the LCL. This form is used to design the .lfm file. +

+

+ The source code is a copy of ../lcl/include/finddialog.inc. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/xml/lcl/timepopup.xml b/docs/xml/lcl/timepopup.xml new file mode 100644 index 0000000000..8c3696116c --- /dev/null +++ b/docs/xml/lcl/timepopup.xml @@ -0,0 +1,371 @@ + + + + + + Contains Forms, Types, and routines used to display a pop-up for TTimeEdit + + + + + + + + + + + + + + + + + + + + + + Specifies an event handler signalled to get a time return value + +

+ TReturnTimeEvent specifies an event handler signalled to validate or assign a time value. It is an object procedure which must be implemented in an application to respond to the event notification. +

+

+ Sender is the object generating the event notification. +

+

+ ATime is a TDateTime value which contains the time value used in the event handler. Only the time portion of the type is significant. +

+

+ TReturnTimeEvent is the type passed as an argument to the ShowTimePopup routine, and implemented as a private member in TTimePopupForm. +

+ + + + + + + + Object for the event notification + + + Time value examined or updated in the event handler + + + + Implements a form displayed to capture a time value + +

+ TTimePopupForm implements a form displayed to capture and return a time value. +

+

+ The form contains grids with Hour and Minute values which can be selected to form the time value. The Minutes displayed in the grid are in either 5 minute or 30 minute intervals, depending on the layout selected using the SetLayout method; Simple layout uses a 5 minute interval and is the default layout for the form. +

+

+ It uses an internal TReturnTimeEvent handler to validate or update the time value. There are also internal members used to track the control associated with the form, and the coordinates where the form is displayed. These internals are assigned using values passed as arguments to the ShowTimePopup routine. +

+ + + + + + + + + + + + + + + + Implements the OnDblClick event handler for grids controls on the form + +

+ Calls ReturnTime to signal the OnReturnTime event handler (when assigned) and close the form. +

+ + + + + + + + + Object for the event notification + + + + Implements the OnKeyDown event handler for grid controls on the form + +

+ GridsKeyDown ensures that the virtual key in Key and Shift is applied, when required. GridsKeyDown calls for form methods for the following: +

+
+
VK_ESC
+
Calls the close method to close the Form.
+
VK_RETURN, VK_SPACE
+
Call ReturnTime to validate/update the time value, and close the Form.
+
+

+ When Key is handled in the method, it is set to zero (0). Otherwise, it is retained for use in Form or Application key events. +

+ + + + + Object for the event notification + + + Virtual key code examined in the method + + + Key Modifier examined in the method + + + + + Sets the canvas text style for a grid on the form + + +

+ GridPrepareCanvas ensures that the Canvas used to draw grid controls (TStringGrid) on the form has been initialized. GridPrepareCanvas sets the text layout and alignment needed for the Canvas property in the control. +

+

+ Sender contains the grid control updated in the method. All other parameters are ignored in the current implementation. +

+ + + + + Control updated in the method + + + Ignored + + + Ignored + + + Ignored + + + + + Implements the OnClick event handler for the MoreLessBtn button on the form + + + + + + + Object for the event notification + + + + + + + + + + + Ensures that the DoubleBuffered property is updated with the current value from the widget set class + + + + + + + Calculates the total height for the Hours and Minutes grids on the form + + + + + Gets a TDateTime value for the selected cells in Hours and Minutes grids + + Calls EncodeTime to get the return value for the selected cells. + + + + + + TDateTime value for the selected cells; only the time portion of the value is relevant + + + + + Initializes the form using the origin and time values specified + + Calls KeepInView to ensure that the form origin remains visible on the current monitor. Called from the ShowTimePopup routine. + + + + + Upper left coordinates for the form + + + Initial time value displayed on the form + + + + Ensures that form remains visible on the current monitor + +

+ KeepInView ensures that form remains visible on the current monitor. KeepInView tries to put the form on a "nice" place on the screen and make sure the entire form is visible. TheCaller typically will be a TTimeEdit control, and uses the following logic: +

+
    +
  • Places the form right under Caller control. If it does not fit...
    • +
  • Place the form above the Caller control. If it does not fit...
    • +
  • Sets the top coordinate to 0 and allows covering the Caller control.
    • +
+ + + + + Upper left coordinates where the form is displayed + + + + Validates the current time value for the form + +

+ ReturnTime is a procedure used to validate and possibly update the current time value for the form. GetTime is called to get the time value using the selected cells in the Hour and Minute grids. +

+

+ ReturnTime signals the internal TReturnTimeEvent event handler (when assigned) to validate/update the time value. The TReturnTimeEvent event handler is passed as an argument to the ShowTimePopup routine. +

+

+ The Close method is called to close the form if it has not already been hidden. +

+ + + + + + + + + + Sets the layout used in Minute grid for the form + +

+ SimpleLayout indicates whether the Minutes grid on the form use the simple layout. Simple layout uses a 30 minute interval between cells in the grid, and offers a more compact appearance. When SimpleLayout is False, a 5 minute interval is used between cells in the Minute grid. +

+ + + + + + Uses the compact 30 minute interval when True + + + + Sets the time value displayed on the form + + + + + Time value applied to the Hour and Minute grid + + + + Performs actions needed when the form is closed + +

+ FormClose reimplements the FormClose event handler for the form to ensure that the FormDeactivate method is removed from the registered deactivate handlers in the global Application instance. FormClose sets the value in CloseAction to caFree to free the form instance. +

+ + + + + + + + + Object for the event notification + + + Close action to perform on exit form the method + + + + Performs actions needed when the form instance is created + +

+ FormCreate reimplements the FormCreate method to initialize the form instance, and register its deactivation handler. FormCreate sets the form to us the Simple layout, calls SetLayout, and registers the FormDeactivate method as a deactivation handler in the global Application instance. +

+ + + + + + + + + + Object for the event notification + + + + Performs action needed when the form is deactivated + +

+ FormDeactivate reimplements the FormDeactivate event handler for the form. FormDeactivate call the Hide method to immediately hide the form. Otherwise, it would remain visible while in a Drag operation, for example. If not already active, the Close method is called prior to exiting from the method. +

+ + + + + + + + Object for the event notification + + + + + Creates, initializes, and displays a TTimePopupForm instance + + +

+ ShowTimePopup is a routine used to create, initialize, and display a TTimePopupForm instance. Arguments passed to the routine identify the time value and the control associated with the pop-up, event handlers assigned to the form instance, and the layout and position for the form. +

+ + + + + + + + Coordinates where the form is displayed + + + Initial time value for the form + + + Indicates if DoubleBuffered is enabled in the form instance + + + Event handler signalled when the time value is changed + + + Event handler signalled when the form is show or hidden + + + + True indicates the simple (compact) layout is used for the Minute grid on the form + + + + Control with the time value updated using the pop-up form + + + + + +