LaunchBoxCONTRIBUTORS
On this page

14.1 Beta 1 SDK

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

IAdditionalApplication7.10

C#
public interface Unbroken.LaunchBox.Plugins.Data.IAdditionalApplication
This interface represents an Additional Application that is associated with an Unbroken.LaunchBox.Plugins.Data.IGame in LaunchBox/Big Box.

Properties

ApplicationPath 7.10

C#
string ApplicationPath { get; set; }
Gets or sets the application path associated with this Additional Application.

AutoRunAfter 7.10

C#
bool AutoRunAfter { get; set; }
Gets or sets a value specifying whether or not to automatically run this Additional Application after running the main game.

AutoRunBefore 7.10

C#
bool AutoRunBefore { get; set; }
Gets or sets a value specifying whether or not to automatically run this Additional Application before running the main game.

CommandLine 7.10

C#
string CommandLine { get; set; }
Gets or sets the command line parameters used when launching this Additional Application.

Developer 7.10

C#
string Developer { get; set; }
Gets or sets a value specifying the Developer of the Additional Application.

Disc 7.10

C#
int? Disc { get; set; }
Gets or sets a value specifying the disc number of the Additional Application.

EmulatorId 7.10

C#
string EmulatorId { get; set; }
Gets or sets a value specifying the ID of the emulator used for the Additional Application. Maps up directly to the emulator's Unbroken.LaunchBox.Plugins.Data.IEmulator.Id property.

GameId 7.10

C#
string GameId { get; }
Gets the ID of the game that is associated with this Additional Application. Maps up directly to the game's Unbroken.LaunchBox.Plugins.Data.IGame.Id property.

Id 7.10

C#
string Id { get; }
Gets the ID of the Additional Application. This ID is automatically generated when a new Additional Application is created.

Installed 10.11

C#
bool? Installed { get; set; }
Gets or sets a value specifying the installation state of this Addition Application.

LastPlayed 7.10

C#
System.DateTime? LastPlayed { get; set; }
Gets or sets a value specifying when the Additional Application was last played.

Name 7.10

C#
string Name { get; set; }
Gets or sets the Name of this Additional Application.

PlayCount 7.10

C#
int PlayCount { get; set; }
Gets or sets the number of times this Additional Application has been played.

PlayTime 12.5

C#
int PlayTime { get; set; }
Gets or sets the amount of time this Additional Application has been played (in seconds).

Priority 7.10

C#
int Priority { get; set; }
Gets or sets a value specifying the Priority of this Additional Application. Priority is used for sorting additional applications.

Publisher 7.10

C#
string Publisher { get; set; }
Gets or sets a value specifying the Publisher of the Additional Application.

Region 7.10

C#
string Region { get; set; }
Gets or sets a value specifying the Region of the Additional Application.

ReleaseDate 7.10

C#
System.DateTime? ReleaseDate { get; set; }
Gets or sets a value specifying the Release Date of the Additional Application.

SideA 7.10

C#
bool SideA { get; set; }
Gets or sets a value specifying whether this Additional Application represents Side A or not.

SideB 7.10

C#
bool SideB { get; set; }
Gets or sets a value specifying whether this Additional Application represents Side B or not.

Status 7.10

C#
string Status { get; set; }
Gets or sets a value specifying the Status of the Additional Application.

UseDosBox 7.10

C#
bool UseDosBox { get; set; }
Gets or sets a value specifying whether this Additional Application should use DOSBox or not when launching.

UseEmulator 7.10

C#
bool UseEmulator { get; set; }
Gets or sets a value specifying whether this Additional Application should use an emulator or not when launching.

Version 7.10

C#
string Version { get; set; }
Gets or sets a value specifying the Version of the Additional Application.

WaitForExit 7.10

C#
bool WaitForExit { get; set; }
Gets or sets a value specifying whether this Additional Application should wait for exit before launching the game.

Methods

GetEffectiveCommandLine 13.16

C#
string GetEffectiveCommandLine()
This will get the command line that is used when this app is launched. This is different than the standard CommandLine property in that this will grab the command line from the appropriate emulator as well if the app doesn't override it.

Returns

The command line sent to the process that starts the app

GetIconImage 7.10

C#
System.Drawing.Image GetIconImage(Unbroken.LaunchBox.Plugins.Data.IGame game)
Gets the image that should be used as an icon when displaying the Additional Application.
game 7.10
The game that is associated with the Additional Application. Used to determine the correct image.

Returns

The image to use for the icon.

Launch 7.10

C#
string Launch(Unbroken.LaunchBox.Plugins.Data.IGame game)
Launches the Additional Application.
game 7.10
The game that is associated with the Additional Application. Used in order to launch the Additional Application correctly.

Returns

A value specifying whether the Additional Application was successfully launched. If launched successfully, NULL will be returned. Otherwise, an error message will be returned that can be shown to the user.