Menu
Classe : Menu
Crée des menus d'applications natifs et des menus contextuels.
Processus : Main
new Menu()
Crée un nouveau menu.
Méthodes statiques
La classe Menu
dispose des méthodes statiques suivantes :
Menu.setApplicationMenu(menu)
menu
Menu | null
Définit menu
comme menu d'application sur macOS. Sous Windows et Linux, menu
sera défini comme menu principal de chaque fenêtre.
Sous Windows et Linux, vous pouvez également utiliser un &
dans le nom de l'élément de niveau supérieur pour indiquer quelle lettre fournira un raccourci . Par exemple, l’utilisation de &File
pour le menu Fichier entraînera la génération d’un raccourci Alt-F
ouvrant le menu associé. Le caractère indiqué dans le label du bouton est alors souligné et le caractère &
n’est pas affiché dans le bouton.
Afin d'échapper le caractère &
dans un nom d'item, ajoutez lui d'abord &
. Par exemple, &&File
afficherait &File
dans le bouton.
Le passage de null
comme paramètre supprimera le menu par défaut. Sous Windows et Linux, cela a pour effet supplémentaire de supprimer la barre de menu de la fenêtre.
Note: Le menu par défaut sera créé automatiquement si l'application ne le définit pas. Il contient des éléments standard tels que Fichier
, Modifier
, Voir
, Window
et Aide
.
Menu.getApplicationMenu()
Retourne Menu | null
- Le menu de l’application si défini, ou null
, si non défini.
Remarque : L'instance retournée de Menu
, ne supporte pas l'ajout ou la suppression dynamique d’éléments de menu. Les propriétés de l’instance peuvent toujours être modifiées dynamiquement.
Menu.sendActionToFirstResponder(action)
macOS
action
string
Envoie l'action
au premier répondant de l'application. Ceci est utilisé pour émuler les comportements du menu de macOS par défaut. Habituellement, vous utiliseriez la propriété rôle
d'un MenuItem
.
Voir le Guide de gestion des événements Cocoa de macOS pour plus d'informations sur les actions natives de macOS.
Menu.buildFromTemplate(template)
template
(MenuItemConstructorOptions | MenuItem)[]
Retourne Menu
Généralement, le paramètre template
est un tableau d' options
pour construire un MenuItem. L'utilisation peut être référencée ci-dessus.
Vous pouvez également attacher d'autres champs à l'élément du template
et ils deviendront des propriétés des éléments de menu construits.
Méthodes d’instance
L’objet menu
dispose des méthodes d’instance suivantes :
menu.popup([options])
Fait apparaitre ce menu sous la forme d'un menu contextuel dans la BrowserWindow
.
menu.closePopup([browserWindow])
browserWindow
BrowserWindow (facultatif) - La fenêtre focalisée est par défaut.
Ferme le menu contextuel dans la browserWindow
.
menu.append(menuItem)
menuItem
MenuItem
Ajoute le menuItem
au menu.
menu.getMenuItemById(id)
id
string
Retourne MenuItem | null
l'élément avec le id
spécifié
menu.insert(pos, menuItem)
pos
IntegermenuItem
MenuItem
Insère le menuItem
à la position pos
du menu.
Événements d’instance
Les objets créés avec new Menu
ou retournés par Menu.buildFromTemplate
émettent les événements suivants :
Remarque : Certains événements sont seulement disponibles sur des systèmes d'exploitation spécifiques et sont étiquetés comme tels.