Initial skeleton for System Indicator API

chrome/common/extensions/api/experimental_system_indicator.idl

Index: chrome/common/extensions/api/experimental_system_indicator.idl
diff --git a/chrome/common/extensions/api/experimental_system_indicator.idl b/chrome/common/extensions/api/experimental_system_indicator.idl
new file mode 100644
index 0000000000000000000000000000000000000000..9a75addcd272ea83059a4d8a8e07a22010337156
--- /dev/null
+++ b/chrome/common/extensions/api/experimental_system_indicator.idl
@@ -0,0 +1,25 @@
+// Copyright (c) 2012 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+// Manages an app's system indicator icon, an image displayed in the system's
+// menubar, system tray, or other visible area provided by the OS.
+namespace experimental.systemIndicator {
+  interface Functions {
+    // Set the image to be used as an indicator icon.
+    //  Can be set by url:
+    static void setURL(DOMString path);
+    //  Or can be set by imageData derived from a canvas element.
+    static void setImageData([instanceOf=ImageData] object ImageData);
+
+    // Show the icon in the status tray.
+    static void show();
+    // Hide the icon from the status tray.
+    static void hide();
+  };
+
+  interface Events {
+    // Fired when a click does not result in a menu being shown.
+    static void onSystemIndicatorClicked();
+  };
+};

[Pete Williamson, 2012/11/13 18:01:41]

I don't see any faults with the code we have, but there is functionality that I
would have expected to find that I don't see here. Specifically, it would be
great if an app had a way to populate a right click menu with several options,
and to get notified when an option was chosen.

Also, if an app sets a system tray icon, what happens if the app exits, or if
chrome exits?  (I realize that this is not the right place for the question, but
I thought of it while looking at this code.)

As I mentioned elsewhere, if we want to minimize the risk of spoofing, we should
demand that the URL is local or relative instead of allowing any site on the
internet, and modify the comments to say so.

[dewittj, 2012/11/14 00:25:07]

Ultimately agreed that a separate menu API is appropriate so it is now in. 
Added an IDL comment about local icon resources.