# Show Custom Menu

Grammar — Show the Game Menu with Title show|Text for players
Flags — Native | Action

The Custom Menu is similiar in look and functionality to the Game Menu (F10 Menu). However, the Custom Menu doesn’t force items on or off based on the current state of the game.

# Arguments

• playergroup — Players
• text — Title

Returns — void

native void UIShowCustomMenu(
	playergroup inPlayers,
	text inTitleText,
);

# Related

Category: UI / Game Menu

• Abort Mission — void — TriggerAddEventAbortMission
• Game Menu Item Selected — void — TriggerAddEventGameMenuItemSelected
• Game Menu Item Selected — int<preset::GameMenuDialogItem> — EventGameMenuItemSelected
• Set Game Menu Dialog Item Text — void — UISetGameMenuItemText
• Set Game Menu Dialog Item Shortcut — void — UISetGameMenuItemShortcut
• Show/Hide Game Menu Dialog Item — void — UISetGameMenuItemVisible
• Show Custom Menu — void — UIShowCustomMenu
• Show Standard Menu — void — UIShowStandardMenu
• Set Custom Menu Dialog Item Text — void — UISetCustomMenuItemText
• Set Custom Menu Dialog Item Shortcut — void — UISetCustomMenuItemShortcut
• Show/Hide Custom Menu Dialog Item — void — UISetCustomMenuItemVisible
• Hide All Custom Menu Dialog Items — void — UIClearCustomMenuItemList

# Examples

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tarcade.sc2map/MapScript.galaxy:8310

    UISetCustomMenuItemText(PlayerGroupAll(), c_gameMenuDialogGenericButton2, StringExternal("Param/Value/9D577A69"));
    UISetCustomMenuItemVisible(PlayerGroupAll(), c_gameMenuDialogGenericButton2, true);
    UIShowCustomMenu(PlayerGroupAll(), StringExternal("Param/Value/66BCC477"));
    return true;
}

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tarcade.sc2map/MapScript.galaxy:8474

    UISetCustomMenuItemVisible(PlayerGroupAll(), c_gameMenuDialogGenericButton2, true);
    UISetCustomMenuItemVisible(PlayerGroupAll(), c_gameMenuDialogReturnToGameplayButton, true);
    UIShowCustomMenu(PlayerGroupAll(), StringExternal("Param/Value/14A8C48E"));
    return true;
}

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tarcade.sc2map — MapScript.galaxy:8310

    UISetCustomMenuItemText(PlayerGroupAll(), c_gameMenuDialogGenericButton2, StringExternal("Param/Value/9D577A69"));
    UISetCustomMenuItemVisible(PlayerGroupAll(), c_gameMenuDialogGenericButton2, true);
    UIShowCustomMenu(PlayerGroupAll(), StringExternal("Param/Value/66BCC477"));
    return true;
}

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tarcade.sc2map — MapScript.galaxy:8474

    UISetCustomMenuItemVisible(PlayerGroupAll(), c_gameMenuDialogGenericButton2, true);
    UISetCustomMenuItemVisible(PlayerGroupAll(), c_gameMenuDialogReturnToGameplayButton, true);
    UIShowCustomMenu(PlayerGroupAll(), StringExternal("Param/Value/14A8C48E"));
    return true;
}