ContentItem Object

A ContentItem represents an item of information within a contentarea. Here is an example of setting up a content item that displays "Hello World!".

// Create a content item and say hello.
var item = new ContentItem();
item.heading = "Hello World!";          // this string is shown in the item
item.snippet = "Detailed description";   // this string shown in details view
plugin.AddContentItem(item, gddItemDisplayInSidebar); // add the item to the display

Properties

To create an Image object, as required by the image and notifier_image properties, use the graphics.loadImage method to load a file from the gadget's .gg package. For example:

image = graphics.loadImage("anImage.gif");

Methods

Event Handlers

ContentItem has a different event handling model from most other objects in the Gadget API. To handle a content item event, you must set a handler function for that specific event. Handler functions can only be set inside JavaScript blocks, not in XML definitions. If you don't set a particular handler, its default action happens in response to its associated event.

The function you assign to a particular event handler should match the prototype signature given in this page. For example, the Prototype column of onOpenItem gives the signature OpenItem(item). Knowing that, here's how you might declare and set an onOpenItem event handler for a ContentItem object:

function DoSomething(item) {
  ///...Implementation goes here. 
}
...
aContentItem.onOpenItem = DoSomething;