Difference between revisions of "LCL Internals - Resizing, Moving/fr"
Paulatreides (talk | contribs) |
Paulatreides (talk | contribs) |
||
Line 5: | Line 5: | ||
La bibliothèque LCL a beaucoup de propriétés de redimensionnement (Left, Width, Anchors, Align, AnchorSide, AutoSize, Constraints, ChildSizing, ...) et des hooks(points d'encrage) où les applications peut modifier le comportement (OnResize, OnChangeBounds, ...). Toutes ces choses ne peuvent pas être calculés en une seule étape, ainsi les commandes peuvent se déplacer énormément avant les coordonnées finales sortent . Pour réduire le scintillement la bibliothèque LCL n'envoit pas tous les déplacements ou redimensionnement à l'interface de la bibliothèque LCL. Par exemple, au cours des Begin/EndAlign et csLoading aucun move/resize est envoyée à l'interface. Le widgetset va essayer de suivre les conseils de la bibliothèque LCL, mais il y a quelques cas, où il ne les suit pas. Par exemple, les forms (fenêtres de haut niveau) sont limités par les politiques de gestion de fenêtres. Et TPage dépend entièrement de la taille et du thème de TNotebook. | La bibliothèque LCL a beaucoup de propriétés de redimensionnement (Left, Width, Anchors, Align, AnchorSide, AutoSize, Constraints, ChildSizing, ...) et des hooks(points d'encrage) où les applications peut modifier le comportement (OnResize, OnChangeBounds, ...). Toutes ces choses ne peuvent pas être calculés en une seule étape, ainsi les commandes peuvent se déplacer énormément avant les coordonnées finales sortent . Pour réduire le scintillement la bibliothèque LCL n'envoit pas tous les déplacements ou redimensionnement à l'interface de la bibliothèque LCL. Par exemple, au cours des Begin/EndAlign et csLoading aucun move/resize est envoyée à l'interface. Le widgetset va essayer de suivre les conseils de la bibliothèque LCL, mais il y a quelques cas, où il ne les suit pas. Par exemple, les forms (fenêtres de haut niveau) sont limités par les politiques de gestion de fenêtres. Et TPage dépend entièrement de la taille et du thème de TNotebook. | ||
− | == Comment la bibliothèque LCL indique à l'interface | + | == Comment la bibliothèque LCL indique à l'interface de redimensionner / déplacer une poignée(handle) == |
Dans TWinControl.DoSendBoundsToInterface la fonction widget SetBounds est appelée | Dans TWinControl.DoSendBoundsToInterface la fonction widget SetBounds est appelée |
Revision as of 11:32, 15 July 2009
│
English (en) │
français (fr) │
Présentation
La bibliothèque LCL a beaucoup de propriétés de redimensionnement (Left, Width, Anchors, Align, AnchorSide, AutoSize, Constraints, ChildSizing, ...) et des hooks(points d'encrage) où les applications peut modifier le comportement (OnResize, OnChangeBounds, ...). Toutes ces choses ne peuvent pas être calculés en une seule étape, ainsi les commandes peuvent se déplacer énormément avant les coordonnées finales sortent . Pour réduire le scintillement la bibliothèque LCL n'envoit pas tous les déplacements ou redimensionnement à l'interface de la bibliothèque LCL. Par exemple, au cours des Begin/EndAlign et csLoading aucun move/resize est envoyée à l'interface. Le widgetset va essayer de suivre les conseils de la bibliothèque LCL, mais il y a quelques cas, où il ne les suit pas. Par exemple, les forms (fenêtres de haut niveau) sont limités par les politiques de gestion de fenêtres. Et TPage dépend entièrement de la taille et du thème de TNotebook.
Comment la bibliothèque LCL indique à l'interface de redimensionner / déplacer une poignée(handle)
Dans TWinControl.DoSendBoundsToInterface la fonction widget SetBounds est appelée
TWSWinControlClass(WidgetSetClass).SetBounds(Self, Left, Top, Width, Height);
How the Interface tells the LCL to resize/move a handle
When the client area of a Handle was resized
Note: If the theme changes the frame of a TGroupBox can change. This leaves the Size and Position of the TGroupBox unchanged, but the client area can change. The interface calls
LCLControl.InvalidateClientRectCache(false);
and sends a LM_SIZE message as below.
When a Handle of a TWinControl was resized/moved
First the LCL interface send a LM_WINDOWPOSCHANGED message
- x := Left (relative to 0,0 of client area of parent)
- y := Top
- cx := Width
- cy := Height
Then a LM_SIZE message is sent
- Width
- Height
- SizeType is a bit flag containing Size_SourceIsInterface plus one of the values SIZENORMAL, SIZEICONIC, SIZEFULLSCREEN.
Then a LM_MOVE message is sent
- MoveType := Move_SourceIsInterface;
- XPos := Left (relative to 0,0 of client area of parent)
- YPos := Top
When a form is maximized, minimized or restored the interface sends a LM_SIZE message
- Width
- Height
- SizeType is a bit flag containing Size_SourceIsInterface plus one of the values SIZENORMAL, SIZEICONIC, SIZEFULLSCREEN.
How the LCL gets the current size / position of a LCL interface handle
LCLIntf.GetWindowSize(Handle, InterfaceWidth, InterfaceHeight)
Returns the current width and height of a Handle.
LCLIntf.GetClientRect(Handle, Result)
Returns the current width and height (left and top are always 0) of the client area of a Handle (= inner area inside the border/frame of a control).
TWSWinControlClass(WidgetSetClass).GetDefaultClientRect(Self, Left, Top, Width, Height, Result)
This function is called first by the LCL to get the ClientRect. If it returns false, the LCL will use GetClientRect if it has already created a handle, otherwise the values loaded from the .lfm. If all this fails, the default is Rect(0,0,Width,Height). GetDefaultClientRect can be used by the LCL interface to reduce flickering by providing good values before the handle is created.
GetWindowRelativePosition(Handle,NewLeft,NewTop)
Returns the current Left, Top of a Handle relative to the client area (0,0) of its parent.
Constraints
The LCL asks the interface for constraints (min, max for width and height) with the function
GetControlConstraints
For example: Under gtk a horizontal scrollbar has a fixed height.
Preferred Size
To autosize a control (e.g. a TButton or a TLabel) the LCL asks the interface about the minimum size to render a control nicely:
TWSWinControlClass(WidgetSetClass).GetPreferredSize(Self, PreferredWidth, PreferredHeight, WithThemeSpace);
Scrolling
The LCL scrolls child controls only virtually. That means, their Left,Top properties do not change. To scroll it uses the LCL interface function
TWSScrollingWinControlClass(WidgetSetClass).ScrollBy(Self, DeltaX, DeltaY);
Miscellaneous
LCLIntf.GetClientBounds(Handle,Result);
Returns the unscrolled client rectangle relative to the top, left of the Handle. In other words it is equivalent to:
CurClientBounds := GetClientRect(Handle) OffsetRect(CurClientBounds,FrameBorderLeft,FrameBorderTop);