Aide:GUICtrlCreateContextMenu.txt

De Wiki AutoIt Français
Aller à : navigation, rechercher

Document original V3.3.6.1 :

###Function###
GUICtrlCreateContextMenu

###Description###
Creates a context menu for a control or entire GUI window.

###Syntax###
GUICtrlCreateContextMenu ( [controlID] )


###Parameters###
@@ParamTable@@
controlID
	[optional] Control identifier as returned by <a href="GUICtrlCreate Management.htm">GUICtrlCreate...</a>
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns the identifier (controlID) of the new control.
Failure:	Returns 0.
@@End@@


###Remarks###
After creating the context menu main control with this function, each menu item can be created by using <a href="GUICtrlCreateMenuItem.htm">GUICtrlCreateMenuItem</a>.
Sub-menus can be created using <a href="GUICtrlCreateMenu.htm">GUICtrlCreateMenu</a>.

If you use no parameters or -1 in this function then the context menu that is created is associated with the entire GUI window rather than an individual control.

Only one context menu per control is possible.  If you wish to create a new context menu one you have to delete the existing menu first.

Note: You can't create context menus for controls that already have <b>system</b> context menus, i.e. edit or input controls.

###Related###
GUICtrlCreateMenuItem, GUICtrlCreateMenu, GUICtrlGetHandle, GUICtrlSetState, GUICtrlDelete


###Example###
@@IncludeExample@@


Document traduit V3.3.6.1 :

###Function###
GUICtrlCreateContextMenu

###Description###
Crée un menu contextuel pour un contrôle ou toute la fenêtre GUI.

###Syntax###
GUICtrlCreateContextMenu ( [controlID] )


###Parameters###
@@ParamTable@@
controlID
	[optionnel] Identificateur de contrôle tel que retourné par <a href="GUICtrlCreate Management.htm">GUICtrlCreate...</a>
@@End@@

###ReturnValue###
@@ReturnTable@@
Succès:	Retourne l'identifiant (controlID) du nouveau contrôle.
Échec:	Retourne 0.
@@End@@


###Remarks###
Après la création de la commande de menu contextuel principal de cette fonction, chaque élément de menu peut être créé en utilisant <a href="GUICtrlCreateMenuItem.htm">GUICtrlCreateMenuItem</a>.
Les sous-menus peuvent être créés avec <a href="GUICtrlCreateMenu.htm">GUICtrlCreateMenu</a>.

Si vous n'utilisez aucun des paramètres ou -1 dans cette fonctionalors le menu contextuel qui est créé est associé à la fenêtre entière GUI plutôt qu'à un contrôle individuel.

Un seul menu contextuel par un contrôle est possible. Si vous souhaitez en créer un nouveau, vous devez d'abord supprimer le menu actuel.

Remarque: Vous ne pouvez pas créer des menus contextuels pour les contrôles qui ont déjà un <b>système</b> de menus contextuels, à savoir des Edits ou des Inputs.

###Related###
GUICtrlCreateMenuItem, GUICtrlCreateMenu, GUICtrlGetHandle, GUICtrlSetState, GUICtrlDelete


###Example###
@@IncludeExample@@


Traducteur :TT22

Contributeurs (pour les modifications avant le Wiki) :