Function Reference


GUICtrlSetResizing

Defines the resizing method used by a control.

GUICtrlSetResizing ( controlID, resizing )

Parameters

controlID The control identifier (controlID) as returned by a GUICtrlCreate...() function, or -1 for the last created control.
resizing See the Docking Values table below for values that can be used (add together multiple values if required).

Return Value

Success: 1.
Failure: 0.

Remarks

When a GUI window is resized the controls within react - how they react is determined by this function. To be able to resize a GUI window it needs to have been created with the $WS_SIZEBOX and $WS_SYSMENU styles. See GUICreate().

    Docking Values Table

Resizing Value No displacement of
$GUI_DOCKAUTO 1 resize and reposition according to new window size
$GUI_DOCKLEFT 2 Left side
$GUI_DOCKRIGHT 4 Right side
$GUI_DOCKHCENTER 8 Position will not move relative to horizontal center
$GUI_DOCKTOP 32 Top side
$GUI_DOCKBOTTOM 64 Bottom side
$GUI_DOCKVCENTER 128 Position will not move relative to vertical center
$GUI_DOCKWIDTH 256 Width will not change
$GUI_DOCKHEIGHT 512 Height will not change
Composite resizing
$GUI_DOCKSIZE 768 (256+512) Size will not change
$GUI_DOCKMENUBAR 544 (512+32) so the control will stay at the top of window with no change in Height
$GUI_DOCKSTATEBAR 576 (512+64) so the control stay at the bottom of the window with no change in Height
$GUI_DOCKALL 802 (2+32+256+512) so the control will not move during resizing
$GUI_DOCKBORDERS 102 (2+4+32+64) so the control will grow as the window

The default resizing for a given control is control dependent see the control doc.
A default value for any control can be set with GUIResizeMode (Option).

The automatic resizing event can be disabled if GUIEventOptions (Option) is set to 1.

Related

GUICtrlCreate..., GUIEventOptions (Option), GUIResizeMode (Option)

Example

#include <EditConstants.au3>
#include <GUIConstantsEx.au3>
#include <WindowsConstants.au3>

Example()

Func Example()
        Opt("GUICoordMode", 2)
        GUICreate("My InputBox", 190, 114, -1, -1, $WS_SIZEBOX + $WS_SYSMENU) ; start the definition

        GUISetFont(8, -1, "Arial")

        GUICtrlCreateLabel("Prompt", 8, 7) ; add prompt info
        GUICtrlSetResizing(-1, $GUI_DOCKLEFT + $GUI_DOCKTOP)

        Local $idButton_Edit = GUICtrlCreateInput("Default", -1, 3, 175, 20, $ES_PASSWORD) ; add the input area
        GUICtrlSetState($idButton_Edit, $GUI_FOCUS)
        GUICtrlSetResizing($idButton_Edit, $GUI_DOCKBOTTOM + $GUI_DOCKHEIGHT)

        Local $idButton_OK = GUICtrlCreateButton("OK", -1, 3, 75, 24) ; add the button that will close the GUI
        GUICtrlSetResizing($idButton_OK, $GUI_DOCKBOTTOM + $GUI_DOCKSIZE + $GUI_DOCKHCENTER)

        Local $idButton_Cancel = GUICtrlCreateButton("Cancel", 25, -1) ; add the button that will close the GUI
        GUICtrlSetResizing($idButton_Cancel, $GUI_DOCKBOTTOM + $GUI_DOCKSIZE + $GUI_DOCKHCENTER)

        GUISetState(@SW_SHOW) ; to display the GUI

        ; Loop until the user exits.
        While 1
                Switch GUIGetMsg()
                        Case $GUI_EVENT_CLOSE
                                ExitLoop

                EndSwitch
        WEnd
EndFunc   ;==>Example