SBDisplay

From iPhone Development Wiki
Jump to: navigation, search

SBDisplay is an abstract class in SpringBoard that represents a full-screen view. It is the superclass of SBApplication and SBAlert.

Display state

SBDisplay stores the display state cache in ~/Library/Caches/com.apple.springboard.displaystate.plist. This plist contains key-value pairs, with keys being the display IDs and the values being a dictionary of settings. The dictionary allows these:

key type value
SBApplicationBadgeKey integer The icon badge value.
SBDefaultPNGNameKey string Name of the default PNG file (splash screen) of the application.
SBDefaultStatusBarModeKey integer Default status bar mode, as an UIStatusBarStyle.
SBDefaultStatusBarOrientationKey integer Default status bar orientation, as an UIInterfaceOrientation.
SBDefaultPNGPreventSplitKey  ?  ?
SBAutoLockTimeKey real
SBAutoDimTimeKey real

These values can be retrieved using +defaultValueForKey:displayIdentifier:urlScheme:.

Display, activation and deactivation settings

These values are valid for 3.0 and above only.

Activation settings

Bitmask Description Value type
1 1 << 0 asPanel
2 1 << 1 suspended boolean
4 1 << 2 URL string (URL scheme)
8 1 << 3 remoteNotification boolean
16 1 << 4 eventOnly boolean
32 1 << 5 safe boolean
64 1 << 6 animateOthersSuspension boolean
128 1 << 7 slideOthersSuspension boolean
256 1 << 8 contextInfoForOthersSuspension string (URL query)
512 1 << 9 flipOthersSuspension
1024 1 << 10 animateScaleForOthersSuspension real
2048 1 << 11 animationStartForOthersSuspension real
4096 1 << 12 animationStart real
8192 1 << 13 flip boolean
16384 1 << 14 animationDuration real
32768 1 << 15 animationDurationForOthersSuspension real
65536 1 << 16 firstLaunchAfterBoot boolean
131072 1 << 17 appToTop boolean
262144 1 << 18 activateFromLocked boolean
524288 1 << 19 originatingURLDisplayIdentifier string (URL)

Display settings

Bitmask Description Value type
1 1 << 0 finishedLaunchingFrontmost boolean
2 1 << 1 resume boolean
4 1 << 2 animate boolean
8 1 << 3 animateNoPNG boolean
16 1 << 4 statusBarMode integer (UIStatusBarStyle)
32 1 << 5 statusBarOrientation integer (angle)
64 1 << 6 arguments array
128 1 << 7 environment dictionary
256 1 << 8 standardOut
512 1 << 9 standardError
1024 1 << 10 waitForDebugger boolean

Deactivation settings

Bitmask Description Value type
1 1 << 0 eventOnly boolean
2 1 << 1 animate boolean
4 1 << 2 slide boolean
8 1 << 3 animationStart real
16 1 << 4 forceExit boolean
32 1 << 5 afterNextLaunch boolean
64 1 << 6 flip boolean
128 1 << 7 contextInfo string (URL query)
256 1 << 8 animationScale real
512 1 << 9 returnToLastApp boolean
1024 1 << 10 startForOthersActivation boolean
2048 1 << 11 killed boolean
4096 1 << 12 underLock
8192 1 << 13 animationDuration real
16384 1 << 14 durationForOthersSuspension real
32768 1 << 15 deactivateAnimateOthersResumption
65536 1 << 16 suspensionAnimationDelay real

References