LaunchBoxCONTRIBUTORS
On this page

14.1 Beta 1 SDK

This reference documents the current beta SDK. Beta APIs can change before stable.

IGameMenuItemPlugin7.10

C#
public interface Unbroken.LaunchBox.Plugins.IGameMenuItemPlugin
Implement this interface in order to add a game-specific menu item to the right-click menu in LaunchBox and/or the game details menu in Big Box.

Properties

Caption 7.10

C#
string Caption { get; }
Gets a value specifying the text to show on the menu item.

IconImage 7.10

C#
System.Drawing.Image IconImage { get; }
Gets a value specifying the icon image to use for the menu item in LaunchBox. This property is not used in Big Box.

ShowInBigBox 7.10

C#
bool ShowInBigBox { get; }
Gets a value specifying whether to show the menu item in the Big Box game details menu.

ShowInLaunchBox 7.10

C#
bool ShowInLaunchBox { get; }
Gets a value specifying whether to show the menu item in the LaunchBox right-click menu.

SupportsMultipleGames 7.10

C#
bool SupportsMultipleGames { get; }
Gets a value specifying whether the menu item should be accessible when multiple games are selected at once.

Methods

GetIsValidForGame 7.10

C#
bool GetIsValidForGame(Unbroken.LaunchBox.Plugins.Data.IGame selectedGame)
Used to determine whether the menu item is valid for the selected game. If not valid, the menu item will be disabled in LaunchBox or hidden in Big Box.
selectedGame 7.10
The game that is currently selected.

Returns

A value specifying whether the menu item is valid for the selected game.

GetIsValidForGames 7.10

C#
bool GetIsValidForGames(Unbroken.LaunchBox.Plugins.Data.IGame[] selectedGames)
Used to determine whether the menu item is valid for the selected games when multiple games are selected. If not valid, the menu item will be disabled in LaunchBox. Multiple selections are currently not used in Big Box.
selectedGames 7.10
An array of games that represent all the currently selected games.

Returns

A value specifying whether the menu item is valid for the selected games.

OnSelected 7.10

C#
void OnSelected(Unbroken.LaunchBox.Plugins.Data.IGame selectedGame)
Called when the menu item is clicked or selected for a particular game.
selectedGame 7.10
The currently-selected game that the menu item was called for.

OnSelected 7.10

C#
void OnSelected(Unbroken.LaunchBox.Plugins.Data.IGame[] selectedGames)
Called when the menu item is clicked or selected for multiple games.
selectedGames 7.10
An array of games that represent the currently-selected games that the menu item was called for.