Difference between revisions of "SBSettings"

From iPhone Development Wiki
Jump to: navigation, search
(Toggles: bool)
(Toggles)
Line 19: Line 19:
 
bool isCapable();            // returns whether this toggle should be shown.
 
bool isCapable();            // returns whether this toggle should be shown.
 
bool 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(bool 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.
 
</source>
 
</source>

Revision as of 23:29, 14 October 2009

Sbsettingsicon.png
SBSettings
Sbsfreemem2.png
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(bool 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