Gears
API ReferenceSettings.Global

IGlobalModSettingsCategory

A category inside a tab. A category is itself a global setting.

InterfaceNamespace GearsAPI.Settings.GlobalAssembly GearsAPI.dllSource
public interface IGlobalModSettingsCategory : IGlobalModSetting

A category inside a tab. A category is itself a global setting, which gives it a caption, description and preview image; its RestartScope always reads None.

Implements: IGlobalModSetting · IModSetting

Methods

GetSetting(String)

IGlobalModSetting GetSetting(string name);

Returns the IGlobalModSetting named name, or null.

GetSetting<T>(String)

T GetSetting<T>(string name) where T : class, IGlobalModSetting;

Returns the setting named name as T, or null if there is none or it is not a T. T must be a class implementing IGlobalModSetting.

CreateSetting<T>(String, String)

T CreateSetting<T>(string name, string displayKey) where T : class, IGlobalModSetting;

Creates a setting of interface T with the given name and display key. Throws ArgumentException if T is not a known setting interface, InvalidOperationException if its value type has no implementation or no registered parser, and ArgumentException on a duplicate name.

GetOrCreateSetting<T>(String, String)

T GetOrCreateSetting<T>(string name, string displayName) where T : class, IGlobalModSetting;

Returns the existing setting as T, or creates it.

AddSetting(IGlobalModSetting)

bool AddSetting(IGlobalModSetting setting);

Adds an existing setting object. Returns false if the name is taken.

RemoveSetting(String)

bool RemoveSetting(string settingName);

Removes the setting with that name. Returns whether one was removed.

RemoveSetting(IGlobalModSetting)

bool RemoveSetting(IGlobalModSetting setting);

Removes that setting. Returns whether it was removed.

GetAllSettings()

List<IGlobalModSetting> GetAllSettings();

Returns the category itself followed by its settings, as a List<IGlobalModSetting>.

On this page