Allows the application to access the window menu for copying and modifying
#include <GuiMenu.au3>
_GUICtrlMenu_GetSystemMenu ( $hWnd [, $bRevert = False] )
| $hWnd | Handle to the window that will own a copy of the window menu |
| $bRevert | [optional] Specifies the action to be taken. If this parameter is False, the function returns a handle to the copy of the window menu currently in use. The copy is initially identical to the window menu, but it can be modified. If this parameter is True, the function resets the window menu back to the default state. The previous window menu, if any, is destroyed. |
Any window that does not use the GetSystemMenu function to make its own copy of the window menu receives the standard window menu.
The window menu initially contains items with various identifier values, such as $SC_CLOSE, $SC_MOVE, and $SC_SIZE. Menu items on the window menu send $WM_SYSCOMMAND messages.
All predefined window menu items have identifier numbers greater than 0xF000.
If an application adds commands to the window menu, it should use identifier numbers less than 0xF000.
The system automatically grays items on the standard window menu, depending on the situation.
The application can perform its own checking or graying by responding to the $WM_INITMENU message that is sent before any menu is displayed.
Search GetSystemMenu in MSDN Library.
#include <GuiMenu.au3>
Example()
Func Example()
Local $hWnd, $hMenu, $iCount, $iI
; Open Notepad
Run("notepad.exe")
WinWaitActive("[CLASS:Notepad]")
$hWnd = WinGetHandle("[CLASS:Notepad]")
$hMenu = _GUICtrlMenu_GetSystemMenu($hWnd)
; Play with system menu
_GUICtrlMenu_InsertMenuItem($hMenu, 5, "&AutoIt")
; Display system menu
$iCount = _GUICtrlMenu_GetItemCount($hMenu)
Writeln("System menu handle: 0x" & Hex($hMenu))
Writeln("Item count .......: " & $iCount)
For $iI = 0 To $iCount - 1
Writeln("Item " & $iI & " text ......: " & _GUICtrlMenu_GetItemText($hMenu, $iI))
Next
EndFunc ;==>Example
; Write a line of text to Notepad
Func Writeln($sText)
ControlSend("[CLASS:Notepad]", "", "Edit1", $sText & @CRLF)
EndFunc ;==>Writeln