diff --git a/docs/xml/lcl/forms.xml b/docs/xml/lcl/forms.xml index cfd5b28fca..64a16e4968 100644 --- a/docs/xml/lcl/forms.xml +++ b/docs/xml/lcl/forms.xml @@ -12591,37 +12591,56 @@ Finds the monitor containing the form with the given window handle.

-MonitorFromWindow is a TMonitor function used to locate monitor where the +MonitorFromWindow is a TMonitor function used to locate the monitor where the form represented by the specified window Handle is displayed.

MonitorDefault is a TMonitorDefaultTo enumeration value which indicates the monitor used when the display area for the form is not -found on a monitor. See TMonitorDefaultTo for more information about the -values in the enumeration and their meanings. +found on a monitor. +See TMonitorDefaultTo for more +information about the values in the enumeration and their meanings.

-MonitorFromWindow calls MonitorFromWindow in the widgetset class to get a -monitor handle used to locate the monitor in the Monitors property. The -UpdatedMonitor method is called to ensure that Monitors contains up-to-date +MonitorFromWindow calls the MonitorFromWindow routine in the LCL interface to +get the HMONITOR handle to locate in the Monitors property. The +UpdatedMonitors method is called to ensure that Monitors contains up-to-date values for the available monitors.

-If a monitor with the Handle is not found, GetWindowRect is called to get the -display areas for the monitor Handle. MonitorFromRect is called to locate the -monitor which contains the rectangle. +If the handle is found in Monitors, the TMonitor instance with the handle is +used as the return value. +

+

+If a monitor is not found, GetWindowRect is called to get the display area for +the TLCLHandle specified in the Handle argument. MonitorFromRect is called to +locate the monitor which contains the rectangle. The TMonitor instance is used +as the return value. +

+

+MonitorFromWindow is called from methods like TCustomForm.GetMonitor.

- + +Modified in LCL version 4.0 to use the TLCLHandle type instead of the +deprecated THandle type in the Handle parameter. + + + + + +TLCLHandle +HMONITOR + -The monitor found. +The TMonitor instance found for the specified handle. -The window handle to use. +The TLCLHandle instance on the monitor located in the method. -What to return when no monitor was found. +What to return if a monitor was found. @@ -18084,23 +18103,28 @@ Values are added to and removed from Flags in methods like: -Provides access to the widgetset handle for the application instance. +Provides access to the handle for the application instance.

-Handle is a THandle property which provides access to -the widgetset handle used for the application instance. Reading the value for -the property is redirected to the AppHandle allocated in the widgetset class. -Setting the value for the property causes the AppHandle in the widgetset -class to be updated with the new value. +Handle is a TLCLHandle property which provides access to +the handle used for the application instance. Reading the value for the +property is redirected to the AppHandle allocated in the widgetset class. +Setting the value for the property causes the AppHandle in the widgetset class +to be updated with the new value.

Handle is used to send and receive window messages and state change notifications for the application instance using the LCL interface.

+ +Modified in LCL version 4.0 to use the TLCLHandle type instead of the +deprecated THandle type. + - +TLCLHandle +TWidgetSet.AppHandle