SBSettings: Difference between revisions

From iPhone Development Wiki
(Created page with '{{Infobox Package |icon=Sbsettingsicon.png |screenshot=Sbsfreemem2.png |developer=BigBoss |version=3.0.2 |package=sbsettings }} SBSettings is a MobileSubstrate extension…')
 
(→‎Toggles: bool)
Line 17: Line 17:
The <tt>Toggle.dylib</tt> contains code to react with users. It must implement and export the following C functions:
The <tt>Toggle.dylib</tt> contains code to react with users. It must implement and export the following C functions:
<source lang="c">
<source lang="c">
Boolean isCapable();            // returns whether this toggle should be shown.
bool isCapable();            // returns whether this toggle should be shown.
Boolean isEnabled();            // returns the ON/OFF state of the toggle.
bool isEnabled();            // returns the ON/OFF state of the toggle.
void setState(Boolean Enabled); // assign the ON/OFF state.
void setState(Boolean Enabled); // assign the ON/OFF state.
float getDelayTime();          // returns the expected time (in seconds) to handle a state change.
float getDelayTime();          // returns the expected time (in seconds) to handle a state change.
Line 24: Line 24:
and these are optional:
and these are optional:
<source lang="c">
<source lang="c">
Boolean getStateFast();        // "approximate" the ON/OFF state.
bool getStateFast();        // "approximate" the ON/OFF state.
Boolean allowInCall();          // returns whether this toggle can be used in call. Default to true.
bool allowInCall();          // returns whether this toggle can be used in call. Default to true.
void invokeHoldAction();        // responds to the user long-holding the toggle.
void invokeHoldAction();        // responds to the user long-holding the toggle.
</source>
</source>

Revision as of 23:28, 14 October 2009

Sbsettingsicon.png
SBSettings
Error creating thumbnail: File missing
Cydia Package
Developer BigBoss
Package ID sbsettings
Latest Version 3.0.2


SBSettings is a MobileSubstrate extension for SpringBoard which provides a quick way to view and change various settings. SBSettings are launched by swiping the finger across the status bar.

Toggles

The toggles are the basic building blocks of SBSettings. Each toggle should create a directory in /var/mobile/Library/SBSettings/Toggles with the following structure:

  • ~/Library/SBSettings/Toggles/
    • «Name of your toggle»/
      • Toggle.dylib

The Toggle.dylib contains code to react with users. It must implement and export the following C functions:

bool isCapable();            // returns whether this toggle should be shown.
bool isEnabled();            // returns the ON/OFF state of the toggle.
void setState(Boolean Enabled); // assign the ON/OFF state.
float getDelayTime();           // returns the expected time (in seconds) to handle a state change.

and these are optional:

bool getStateFast();         // "approximate" the ON/OFF state.
bool allowInCall();          // returns whether this toggle can be used in call. Default to true.
void invokeHoldAction();        // responds to the user long-holding the toggle.

Details can be found in BigBoss's SBSettings Toggle Spec.

Themes

SBSettings is themeable. See this page for detail.

References