AboutSupportDeveloper GuideVersion 1.1.0

Interface ServerOptions

Options for starting the Snap Server

interface ServerOptions {
    blurEffectPerformanceThreshold?: number;
    disableBlurDropPreview?: boolean;
    disableGPUAcceleratedDragging?: boolean;
    disableUserUnstick?: boolean;
    executablePath?: string;
    hideTaskbarEntry?: boolean;
    keyToStick?: boolean;
    showDebug?: boolean;
    taskbarIcon?: string;
    taskbarIconGroup?: string;
}

Properties

blurEffectPerformanceThreshold?: number

This is respected only if the disableBlurDropPreview option is not set. This threshold (in milliseconds) relates to the time taken to render a blur effect. Snap will do a check at start up to measure this performance and automatically disable the blur effect if this threshold time is exceeded. If not provided, the performance check will use a default threshold.

disableBlurDropPreview?: boolean

If true, the drop preview will not be blurred. This can be useful if performance issues are encountered when displaying a drop target and preview. This can occur on lower spec machines.

disableGPUAcceleratedDragging?: boolean

If true, reverts to a slower method of dragging groups of windows

disableUserUnstick?: boolean

If true, prevents the user from unsticking windows (e.g. using SHIFT key)

executablePath?: string

The path to the Snap executable to launch if not using a manifest asset

hideTaskbarEntry?: boolean

If true, snapped window groups will not be shown in the taskbar.

keyToStick?: boolean

If true, windows will only stick if CTRL key is held while dragging

showDebug?: boolean

True if the Snap debug console should be shown

taskbarIcon?: string

If set, this specifies a URL for a .ico file that will be used in the taskbar for the snapped window groups.

taskbarIconGroup?: string

An ID used by Windows for grouping taskbar entries. If set, all snapped window groups will be shown under the same taskbar entry. If you want to show the snapped window groups under the same taskbar entry as your OpenFin application, you must set this value carefully, as follows: it must start with a prefix of openfin_apps_group. and follow with the value of the following field in the app: https://developer.openfin.co/docs/javascript/stable/interfaces/OpenFin.ApplicationCreationOptions.html#taskbarIconGroup