SDLCreateWindow Class Reference

-initWithId:windowName:windowType:

Constructor with the required parameters

Objective-C

- (nonnull instancetype)initWithId:(NSUInteger)windowId
                        windowName:(nonnull NSString *)windowName
                        windowType:(nonnull SDLWindowType)windowType;

Swift

init(id windowId: UInt, windowName: String, windowType: SDLWindowType)

Parameters

windowId

The type of the window to be created. Main window or widget.

windowName

The window name to be used by the HMI. - see: windowName

windowType

The type of the window to be created. Main window or widget.

-initWithId:windowName:windowType:associatedServiceType:duplicateUpdatesFromWindowID:

Convenience constructor with all the parameters.

Objective-C

- (nonnull instancetype)initWithId:(NSUInteger)windowId
                        windowName:(nonnull NSString *)windowName
                        windowType:(nonnull SDLWindowType)windowType
             associatedServiceType:(nullable NSString *)associatedServiceType
      duplicateUpdatesFromWindowID:(NSUInteger)duplicateUpdatesFromWindowID;

Swift

init(id windowId: UInt, windowName: String, windowType: SDLWindowType, associatedServiceType: String?, duplicateUpdatesFromWindowID: UInt)

Parameters

windowId

The type of the window to be created. Main window or widget.

windowName

The window name to be used by the HMI. - see: windowName

windowType

The type of the window to be created. Main window or widget.

associatedServiceType

Allows an app to create a widget related to a specific service type. - see: associatedServiceType

duplicateUpdatesFromWindowID

Optional parameter. Specify whether the content sent to an existing window should be duplicated to the created window. If there isn’t a window with the ID, the request will be rejected with INVALID_DATA.

windowID

A unique ID to identify the window. @discussion The value of ‘0’ will always be the default main window on the main display and should not be used in this context as it will already be created for the app. See PredefinedWindows enum. Creating a window with an ID that is already in use will be rejected with INVALID_ID.

Objective-C

@property (nonatomic, strong) NSNumber<SDLUInt> *_Nonnull windowID;

Swift

var windowID: NSNumber & SDLUInt { get set }

windowName

The window name to be used by the HMI. @discussion The name of the pre-created default window will match the app name. Multiple apps can share the same window name except for the default main window. Creating a window with a name which is already in use by the app will result in DUPLICATE_NAME. MaxLength 100.

Objective-C

@property (nonatomic, strong) NSString *_Nonnull windowName;

Swift

var windowName: String { get set }

type

The type of the window to be created. Main window or widget.

Objective-C

@property (nonatomic, strong) SDLWindowType _Nonnull type;

Swift

var type: SDLWindowType { get set }

associatedServiceType

Allows an app to create a widget related to a specific service type. @discussion As an example if a MEDIA app becomes active, this app becomes audible and is allowed to play audio. Actions such as skip or play/pause will be directed to this active media app. In case of widgets, the system can provide a single “media” widget which will act as a placeholder for the active media app. It is only allowed to have one window per service type. This means that a media app can only have a single MEDIA widget. Still the app can create widgets omitting this parameter. Those widgets would be available as app specific widgets that are permanently included in the HMI. This parameter is related to widgets only. The default main window, which is pre-created during app registration, will be created based on the HMI types specified in the app registration request.

Objective-C

@property (nonatomic, strong, nullable) NSString *associatedServiceType;

Swift

var associatedServiceType: String? { get set }

duplicateUpdatesFromWindowID

Optional parameter. Specify whether the content sent to an existing window should be duplicated to the created window. If there isn’t a window with the ID, the request will be rejected with INVALID_DATA.

Objective-C

@property (nonatomic, strong, nullable) NSNumber<SDLUInt> *duplicateUpdatesFromWindowID;

Swift

var duplicateUpdatesFromWindowID: (NSNumber & SDLUInt)? { get set }