SBStatusBarController: Difference between revisions

From iPhone Development Wiki
m (firmwares)
m (Updated.)
Line 1: Line 1:
[[SBStatusBarController]] is a singleton class that manages the status bar. You can access the singleton instance with the nonstandard method as follows:
[[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:
<source lang="objc">
<source lang="objc">
+(id)sharedStatusBarController
+(id)sharedStatusBarController
Line 9: Line 9:


==== Activation ====
==== Activation ====
{{Function signature|signature=-(void)setDoubleHeightMode:(int)mode glowAnimationEnabled:(BOOL)enabled bundleID:(NSString *)id;|firmware=3.0 –}}
{{Function signature|signature=- (void)setDoubleHeightMode:(int)mode glowAnimationEnabled:(BOOL)enabled bundleID:(NSString *)id;|firmware=3.0 – 3.2}}
{{Function signature|signature=-(void)setDoubleHeightMode:(int)mode glowAnimationEnabled:(BOOL)enabled bundleID:(NSString *)id priority:(int)priority;|firmware=3.0 –}}
{{Function signature|signature=- (void)setDoubleHeightMode:(int)mode glowAnimationEnabled:(BOOL)enabled bundleID:(NSString *)id priority:(int)priority;|firmware=3.0 – 3.2}}
These methods activate and deactivate the double height status bar. The parameters are as follows:
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:
* '''mode''': Generally, color of the status bar. Options are listed below:
Line 22: Line 22:


==== Deactivation ====
==== Deactivation ====
{{Function signature|signature=-(void)clearDoubleHeightStatusBarForBundleID:(NSString *)bundleID;|firmware=3.0 –}}
{{Function signature|signature=- (void)clearDoubleHeightStatusBarForBundleID:(NSString *)bundleID;|firmware=3.0 – 3.2}}
{{Function signature|signature=-(int)doubleHeightMode;|firmware=3.0 –}}
{{Function signature|signature=- (int)doubleHeightMode;|firmware=3.0 – 3.2}}
Gets or clears the double height status bar mode.
Gets or clears the double height status bar mode.


==== Text ====
==== Text ====
{{Function signature|signature=-(void)setDoubleHeightPrefixText:(id)text bundleID:(NSString *)id;|firmware=3.0 –}}
{{Function signature|signature=- (void)setDoubleHeightPrefixText:(NSString *)text bundleID:(NSString *)id;|firmware=3.0 – 3.2}}
{{Function signature|signature=-(id)doubleHeightPrefixText;|firmware=3.0 –}}
{{Function signature|signature=- (NSString *)doubleHeightPrefixText;|firmware=3.0 – 3.2}}
{{Function signature|signature=-(void)setDoubleHeightStatusText:(id)text bundleID:(NSString *)id;|firmware=3.0 –}}
{{Function signature|signature=- (void)setDoubleHeightStatusText:(NSString *)text bundleID:(NSString *)id;|firmware=3.0 – 3.2}}
{{Function signature|signature=-(id)doubleHeightStatusText;|firmware=3.0 –}}
{{Function signature|signature=- (NSString *)doubleHeightStatusText;|firmware=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:
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.
* '''text''': The text that you wish to set.

Revision as of 11:35, 12 March 2015

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