summaryrefslogtreecommitdiffstats
path: root/dom/chrome-webidl/WindowsJumpListShortcutDescription.webidl
blob: ccd51b21e4558b76ebd7a7b7b4e0c0cc583a280d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
 * You can obtain one at http://mozilla.org/MPL/2.0/.
 */

/**
 * A WindowsJumpListShortcutDescription is a structure that describes an entry
 * to be created in the Windows Jump List. Both tasks, as well as custom
 * items can be described using this structure.
 *
 * nsIJumpListBuilder.populateJumpList accepts arrays of these structures.
 */
[GenerateInit, GenerateConversionToJS]
dictionary WindowsJumpListShortcutDescription {
  /**
   * The title of the Jump List item to be displayed to the user.
   */
  required DOMString title;

  /**
   * The path to the executable that Windows should run when the item is
   * selected in the Jump List.
   */
  required DOMString path;

  /**
   * Arguments to be supplied to the executable when the item is selected in
   * the Jump List.
   */
  DOMString arguments;

  /**
   * A description of the item that is displayed as a tooltip.
   */
  required DOMString description;

  /**
   * The path to an icon to assign to the Jump List item. If this is not
   * supplied then the fallbackIconIndex is used instead.
   */
  DOMString iconPath;

  /**
   * The icon index associated with the executable at the path to use in the
   * event that no iconPath is supplied.
   */
  required long fallbackIconIndex;
};