GDState constants

Use these constants with the GDState programming interface. More...

Enumerations

• enum GDUserInterfaceState {
    GDUIStateNone = 0,
    GDUIStateApplicationInFront,
    GDUIStateGDLibraryInFront,
    GDUIStateBypassUnlockInFront
  }

  User interface states.

  More...
  

• enum GDLibraryScreen {
    GDLibraryScreenNone = 0,
    GDLibraryScreenCertificateImport,
    GDLibraryScreenOther = 1000
  }

  BlackBerry Dynamics user interface screen indication.

  More...
  

Variables

• NSString *const GDStateChangeNotification

  NSNotification name for GDState change notifications.
  

• NSString *const GDStateChangeKeyProperty

  Key in the NSNotification userInfo dictionary for the name of the property that changed.
  

• NSString *const GDStateChangeKeyCopy

  Key in the NSNotification userInfo dictionary for the as-after copy of the GDState object.
  

• NSString *const GDKeyIsAuthorized

  Path for KVO of the GDState isAuthorized property.
  

• NSString *const GDKeyReasonNotAuthorized

  Path for KVO of the GDState reasonNotAuthorized property.
  

• NSString *const GDKeyUserInterfaceState

  Path for KVO of the GDState userInterfaceState property.
  

• NSString *const GDKeyCurrentScreen

  Path for KVO of the GDState currentScreen property.
  

---

Detailed Description

These constants are intended to facilitate:

• Key-value observing (KVO), with which GDState complies.
• Implementing NSNotification observers of GDState.

See the GDState class reference for details.

---

Enumeration Type Documentation

enum GDUserInterfaceState

This enumeration represents the possible states of the user interface of a BlackBerry Dynamics application.

The GDState userInterfaceState property takes one of these values.

Enumerator:

GDUIStateNone	Initial state.
GDUIStateApplicationInFront	A screen from the application code is in front.
GDUIStateGDLibraryInFront	A built-in screen of the GD runtime library is in front.
GDUIStateBypassUnlockInFront	A designated bypass screen from the application is in front. This state is only possible if the application uses the Bypass Unlock feature. Not yet supported on macOS. See also: Bypass Unlock: Application Developer Guide on the Good Developer Network for a description of Bypass Unlock.

enum GDLibraryScreen

This enumeration is used to indicate which of the built-in BlackBerry Dynamics screens is in front of the user interface.

The GDState currentScreen property takes one of these values, when the userInterfaceState property has the value GDUIStateGDLibraryInFront.

Enumerator:

GDLibraryScreenNone	Indicates that no screen has been shown yet.
GDLibraryScreenCertificateImport	Indicates that the certificate enrollment screen is in front. The application code shouldn't attempt to use secure communication when this screen is in front. The user might be enrolling a certificate that is required for access to the enterprise infrastructure, or for authentication by an application server.
GDLibraryScreenOther	Indicates that another screen is in front.

---

Variable Documentation

NSString* const GDStateChangeNotification

NSString* const GDStateChangeKeyProperty

NSString* const GDStateChangeKeyCopy

NSString* const GDKeyIsAuthorized

NSString* const GDKeyReasonNotAuthorized

NSString* const GDKeyUserInterfaceState

NSString* const GDKeyCurrentScreen