Deprecated: trim(): Passing null to parameter #1 ($string) of type string is deprecated in /var/www/html/extensions/Variables/includes/ExtVariables.php on line 198
SBStatusBarController - iPhone Development Wiki

SBStatusBarController

From iPhone Development Wiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

SBStatusBarController is a singleton class that manages the status bar in iOS 3.0 - 3.2. You can access the singleton instance with the nonstandard method as follows:

+(id)sharedStatusBarController

Double Height Status Bar

There are a few methods used generally for a double height status bar.

Activation

Signature - (void)setDoubleHeightMode:(int)mode glowAnimationEnabled:(BOOL)enabled bundleID:(NSString *)id;
Available in 3.0 – 3.2
Signature - (void)setDoubleHeightMode:(int)mode glowAnimationEnabled:(BOOL)enabled bundleID:(NSString *)id priority:(int)priority;
Available in 3.0 – 3.2

These methods activate and deactivate the double height status bar. The parameters are as follows:

  • mode: Generally, color of the status bar. Options are listed below:
    • 1: Green, fixed text: "Touch to return to call".
    • 2: Red. Text is in the form "PREFIX STATUS".
    • 3: Red. Appears to be the same as 2.
    • 4: Blue, used in tethering. Form is "STATUS".
  • enabled: Controls the glowing of the status bar.
  • id: Bundle ID to set the mode for. Can be nil, but not suggested.
  • priority: Not sure, but assumed to be the priority for this bundle ID and the double height status bar.

Deactivation

Signature - (void)clearDoubleHeightStatusBarForBundleID:(NSString *)bundleID;
Available in 3.0 – 3.2
Signature - (int)doubleHeightMode;
Available in 3.0 – 3.2

Gets or clears the double height status bar mode.

Text

Signature - (void)setDoubleHeightPrefixText:(NSString *)text bundleID:(NSString *)id;
Available in 3.0 – 3.2
Signature - (NSString *)doubleHeightPrefixText;
Available in 3.0 – 3.2
Signature - (void)setDoubleHeightStatusText:(NSString *)text bundleID:(NSString *)id;
Available in 3.0 – 3.2
Signature - (NSString *)doubleHeightStatusText;
Available in 3.0 – 3.2

These methods set and retrieve the status bar text. For different modes, different portions of the text is used, see above for details. Parameters:

  • text: The text that you wish to set.
  • id: The bundle ID you wish to set the text for,

References