html之api

API 参考

---

对象参考

此部分显示了 Google Gadgets API 中与脚本相关的不同对象，包括它们的属性、方法和相关事件。注意，许多对象继承了 basicElement 的属性、方法和事件。

同样，如果说一个方法返回了一个元素，这意味着在小工具的 XML 定义中定义了一个元素，它继承自 basicElement。

gadget.debug 
列出了可用于开发和调试小工具的 API。要以调试模式运行，请解压缩您的小工具，并双击所获得的文件中的 gadget.gmanifest 文件。方法名称和参数说明返回值error(string Message)当小工具以调试模式运行时，在调试控制台中作为错误消息显示字符串消息。voidtrace(string Message)当小工具以调试模式运行时，在调试控制台中显示字符串消息。voidwarning(string Message)当小工具以调试模式运行时，在调试控制台中作为警告显示字符串消息。void

gadget.storage 
提供对小工具包内容的访问权。方法名称和参数说明返回值extract(string filename)将文件从小工具包解压到临时文件夹，并返回该解压文件的完整路径。字符串openStream(string filename)通过小工具包打开一个文件，并作为流返回内容。流openText(string filename)通过小工具包打开一个文件，并作为字符串返回内容。字符串

view 
注意：与其子对象/内容对象不同，view不从 basicElement 继承。
您必须在单独的文件中为小工具的每个面板用户界面定义 view 对象。属性名称说明类型读/写caption此视图的标题，默认情况下当小工具处于浮动/扩展模式时显示此标题，当小工具位于补充工具栏中时不显示此标题。另请参阅 showCaptionAlways 属性。字符串读-写children返回包含此视图元素的直接子元素的集合。它们全部是 basicElement 的子对象。只能通过脚本访问，不能通过 XML 定义访问。元素只读event事件句柄脚本获得 event 对象的方式。事件读height设置或返回视图高度，以像素表示。整数读-写width设置或返回视图宽度，以像素表示。整数读-写resizable值为 true 时，用户可以调整视图的大小。布尔读-写showCaptionAlways值为 true 时，补充工具栏一直显示此视图的标题（在caption 属性中指定）。默认情况下或当此值为 false时，如果小工具在补充工具栏中则不显示此标题，如果小工具处于浮动或扩展模式则显示此标题。布尔读-写方法名称和参数说明返回值void alert(string message)显示包含消息字符串的消息框。voidelement appendElement(string xml)解析所提供的元素定义（以 XML 格式给定），并将此元素附加为此视图的最后一个子视图。新元素。integer beginAnimation(string script, integer startValue, integer endValue, integer duration)启动动画计时器。此计时器运行 duration 毫秒。在此时间段内使用 StartValue 和 EndValue 之间的值定期执行脚本。可用于取消此动画的标识符。
注意：调用 Callback 的次数由系统的性能和当前负载决定。最高为 100 fps。void cancelAnimation(integer Token)取消当前运行的动画。Token 是 beginAnimation 返回的标识符。voidvoid clearInterval(integer Token)取消间隔或超时。voidboolean confirm(string message)显示包含消息字符串的确认框。如果按“确定”，返回 true，否则返回 false。布尔element insertElement(string xml, element InsertBefore)解析提供的 XML，并将此元素插入紧挨 InsertBefore 元素之前的位置。新元素。void removeElement(element Item)删除指定元素。voidvoid resizeBy(integer width, integer height)根据视图当前的宽度和高度，将视图大小更改指定的宽度和高度。以像素为单位。voidVoid resizeTo(integer width, integer height)将视图大小更改为指定的宽度和高度（以像素为单位）。voidinteger setTimeout(string Script, integer Duration)创建单次运行计时器。在 Duration 毫秒之后脚本将执行一次。可用于取消超时的令牌。integer setInterval(string Script, integer Duration)创建一个永久运行计时器。在取消之前，脚本将每 Duration 毫秒执行一次。可用于取消间隔的令牌。事件


名称说明onclick点击鼠标左键时触发。onclose视图将关闭时触发。ondblclick双击鼠标左键时触发。onkeydown当按下某键时触发。onkeypress当按下某键然后释放时触发。onkeyup当释放某键时触发。onminimize当小工具最小化时触发。onmousedown当按下鼠标左键时触发。onmouseout当鼠标光标离开视图时触发。onmouseover当鼠标光标进入视图时触发。onmouseup当释放鼠标左键时触发。onopen视图第一次打开时触发。onoptionchanged当添加、更改或删除 options 对象中的属性时触发。event.propertyName 指定更改的项目。onrestore当小工具从最小化状态恢复时触发。onsizing当用户更改小工具大小时触发。只有 resizable 设置为 true 时才触发。event.width 和 event.height 包含用户请求的新宽度和高度。事件代码可以取消该事件（event.returnValue = false），这将使小工具保持当前大小。事件代码可以修改 event.width 和 event.height，以忽略用户选择进行更改。onsize在脚本代码修改大小（例如，设置 view.width 或 view.height，或调用 view.resizeBy 或 view.resizeTo）后，或在调用 onsizing 并指定新的大小后，视图更改到新的大小，然后触发此事件。此事件无法取消。

basicElement 对象 
定义可用于所有元素的属性、方法和事件，特定元素将继承此处定义的内容。属性名称说明类型读/写cursor设置或检索光标，以在鼠标位于此元素之上时进行显示。 

可能值：arrow、 ibeam、 wait、 cross、 uparrow、 size、 sizenwse、 sizenesw、 sizewe、 sizens、 sizeall、 no、 hand、 busy、 help

字符串读-写dropTarget设置或检索此元素是否是拖/放操作的目标。如果为 true，当用户启动拖/放操作时，ondrag* 事件将触发。布尔读-写enabled设置或检索是否启用此元素。禁用事件不触发任何鼠标或键盘事件。布尔读-写height设置或检索高度。 可以按像素或父对象的高度的百分比表示此值。可变读-写hitTest设置或检索此事件的点击测试值。

可能值：httransparent， htnowhere， htclient, htcaption， htsysmenu， htsize, htmenu， hthscroll， htvscroll， htminbutton， htmaxbutton，htleft， htright， httop， httopleft， httopright， htbottom， htbottomleft， htbottomright， htborder， htobject， htclose, hthelp

字符串读-写mask设置或检索定义此元素剪切路径的掩码位图。字符串读-写name检索元素名称。字符串只读offsetHeight检索元素相对于父元素的高度，以像素表示。该属性类似于相同名称的 DHTML 属性。只能通过脚本访问，不能通过 XML 定义访问。整数只读offsetWidth检索元素相对于父元素的宽度，以像素表示。该属性类似于相同名称的 DHTML 属性。只能通过脚本访问，不能通过 XML 定义访问。整数只读offsetX检索元素相对于父元素的 x 位置，以像素表示。该属性类似于相同名称的 DHTML 属性。只能通过脚本访问，不能通过 XML 定义访问。整数只读offsetY检索元素相对于父元素的 y 位置，以像素表示。该属性类似于相同名称的 DHTML 属性。只能通过脚本访问，不能通过 XML 定义访问。整数只读opacity设置或检索元素的不透明度。 

有效值：0-255

整数读-写parentElement检索父元素。只能通过脚本访问，不能通过 XML 定义访问。元素只读pinX设置或检索水平针型标记。整数读-写pinY设置或检索垂直针型标记。整数读-写rotation设置或检索元素的旋转，以度数表示。浮点读-写tagName检索标志名称。只能通过脚本访问，不能通过 XML 定义访问。字符串只读tooltip设置或检索鼠标在此元素之上停留时显示的工具提示。字符串读-写width设置或检索宽度。可以按像素或父对象的宽度的百分比表示此值。可变读-写visible设置或检索此元素是否可见。布尔读-写x设置或检索水平位置。可以按像素或父对象的宽度的百分比表示此值。可变读-写y设置或检索垂直位置。可以按像素或父对象的高度的百分比表示此值。可变读-写事件 名称说明onclick当用户点击此元素时触发。ondblclick当用户双击此元素时触发。ondragdrop当用户将对象拖动到此元素上时触发。ondragout当用户取消拖/放操作时触发。ondragover当用户将一个对象拖动到此元素上时触发。onfocusin当元素获得键盘焦点时触发。onfocusout当元素失去键盘焦点时触发。onkeydown当用户按下某键时触发。onkeypress当用户按下然后释放某键时触发。onkeyup当用户释放某键时触发。onmousedown当用户按下鼠标键时触发。onmousemove当用户在元素上移动鼠标时触发。onmouseout当用户将鼠标移出元素之外时触发。onmouseover当用户将鼠标移动到元素上时触发。onmouseup当用户释放鼠标键时触发。onmousewheel当用户滚动鼠标滚轮时触发。

元素 
表示元素对象的容器。支持 Javascript 枚举器和集合元素访问，例如 elements("foo")，而不是 elements.item("foo")。属性名称说明类型读/写count返回集合中的元素数。整数只读item (string Name)返回 Name 参数确定的元素。如果使用同一名称定义了多个元素，则返回第一个。如果没有匹配元素，返回空值。元素只读，默认（对于某些脚本语言， .item 标识可选）

<button> 元素，button 对象 
Button 对象，同样继承了 basicElement 对象的所有属性和方法。属性名称说明类型读/写disabledImage设置或检索禁用按钮时显示的图象。字符串读-写downImage设置或检索按下按钮时显示的图片。字符串读-写image设置或检索按钮的默认图片。字符串读-写overImage设置或检索当鼠标移动到按钮上时显示的图片。字符串读-写

<checkbox> 元素，checkbox 对象 
Checkbox 对象，同样继承了 basicElement 对象的所有属性和方法。属性名称说明类型读/写image设置或检索复选框的默认图片。字符串读-写checkedDisabledImage设置或检索选中和禁用复选框时显示的图片。字符串读-写checkedDownImage设置或检索选中和按下复选框时显示的图片。字符串读-写checkedOverImage设置或检索选中复选框时以及鼠标位于复选框之上时显示的图片。字符串读-写checkedImage设置或检索选中复选框时显示的默认图片。字符串读-写disabledImage设置或检索禁用复选框时显示的图片。字符串读-写downImage设置或检索按下复选框时显示的图片。字符串读-写overImage设置或检索当鼠标移动到按钮上时显示的图片。字符串读-写value如果选中复选框，返回 true。布尔读-写事件 名称说明onchangevalue 属性更改时触发。

<object> 元素object 对象 
嵌入式对象，它是无窗口 ActiveX 控件，同样继承了 basicElement 对象的所有属性和方法。属性名称说明类型读/写classId检索创建 ActiveX 控件所使用的 classId。注意，以 XML 格式定义 objectElement 时，classId 的值应使用 "clsid:GUID_value" 或 "progid:progid_value" 的格式，包括引号。字符串只读object检索托管的 ActiveX 控件。对象只读wmpServiceType当对象是 Windows Media Player 时，设置或检索该嵌入式对象的服务类型。字符串读-写wmpSkin设置或检索要在小工具中托管的 Windows Media Player 外观文件的名称。外观文件应该打包在 .gg 文件中。字符串读-写

<contentArea> 元素contentArea 对象
一般内容包容对象。虽然来源于 basicElement，但是不支持许多 basicElement 属性。仅支持 x、y、width、height 和 name 等 basicElement 属性。这包括 ContentItem 对象；详细信息请参见其参考材料。在 view 对象中只能定义一个contentArea。属性名称说明类型读/写contentFlags一个或多个 gddContentFlagXXXX 标记的组合。整数只写maxContentItems允许的内容项最大数，默认值为 25。整数读-写contentItems内容项组。可变读-写pinImages图片组；您可以使用 framework.graphics.loadImage() 加载图片。可变读-写方法名称和参数说明返回值void addContentItem(item, options)添加新内容项。voidvoid removeContentItem(item)删除指定内容项。voidvoid removeAllContentItems()删除所有内容项。void

<div> 元素，div 对象 
div 对象，同样继承了 basicElement 对象的所有属性和方法。属性名称说明类型读/写background设置或检索元素的背景颜色或背景图片。字符串读-写children检索包含此元素的直接子元素的集合。只能通过脚本访问，不能通过 XML 定义访问。元素只读方法名称和参数说明返回值appendElement(string xml)解析提供的 XML，并将此元素附加为这一元素的最后一个子元素。新 元素insertElement(string xml, element InsertBefore)解析提供的 XML，并将此元素插入紧挨 InsertBefore 元素之前的位置。新 元素removeElement(element Item)删除指定元素。void

<edit> 元素，edit 对象
编辑区域对象，同样继承了 basicElement 对象的所有属性和方法。颜色值格式只能是：
color="#RRGGBB"（类似于 HTML）
不支持 Alpha 和图片纹理值。属性名称说明类型读/写background设置或检索元素的背景颜色。字符串读-写bold设置或检索文本是否应该为粗体。布尔读-写color设置或检索文本颜色。字符串读-写font设置或检索文本字体。字符串读-写italic设置或检索文本是否应该为斜体。布尔读-写size设置或检索文本文字大小，以磅表示。整数读-写strikeout设置或检索是否应该删除文本。布尔读-写underline设置或检索是否应该为文本添加下划线。布尔读-写value设置或检索元素值。字符串读-写事件 名称说明onchange属性值更改时触发。

<img> 元素，img 对象
图片对象，同样继承了 basicElement 对象的所有属性和方法。属性名称说明类型读/写src设置或检索要显示的图片。字符串读-写srcHeight检索所显示图片的原始高度。整数只读srcWidth检索所显示图片的原始宽度。整数只读方法名称和参数说明返回值setSrcSize(integer Width, integer Height)通过降低分辨率，将图片大小调整为指定的宽度和高度。如果源图片大于显示区域，通过使用此方法将图片大小更改为输出大小，可以节省内存，改善呈现效果。void

<label> 元素，label对象 
标签对象，同样继承了 color="#RRGGBB"（类似于 HTML）
color="#AARRGGBB"（类似于 HTML，其中 AA 为 alpha 值）
color="some_image.png"（将此图片作为重复纹理）属性名称说明类型读/写align设置或检索文本对齐方式。
可能值：center、left 和 right字符串读-写bold设置或检索文本是否应该为粗体。布尔读-写color设置或检索文本颜色。字符串读-写font设置或检索文本字体。字符串读-写innerText设置或检索显示的文本。只能通过脚本访问，不能通过 XML 定义访问。字符串读-写italic设置或检索文本是否应该为斜体。布尔读-写size设置或检索文本文字大小，以磅表示。整数读-写strikeout设置或检索是否应该删除文本。布尔读-写trimming如果文本太大无法显示，设置或检索剪裁模式。
可能值：none、character、word、character-ellipsis、word-ellipsis、path-ellipsis字符串读-写underline设置或检索是否应该为文本添加下划线。布尔读-写vAlign设置或检索垂直对齐方式。
可能值：top（靠上）、middle（居中）、bottom（靠下）字符串读-写wordWrap设置或检索文本是否应该换行。布尔读-写

<a> 元素，a 对象
定义一个链接，同样继承了 basicElement 对象的所有属性和方法。属性名称说明类型读/写align设置或检索文本对齐方式。
可能值：center、left 和 right字符串读-写bold设置或检索文本是否应该为粗体。布尔读-写color设置或检索文本颜色。字符串读-写font设置或检索文本字体。字符串读-写href设置后，点击此链接将在默认浏览器中启动此网址。只能启动 http:、https: 和 ftp:网址。字符串读-写innerText设置或检索显示的文本。只能通过脚本访问，不能通过 XML 定义访问。字符串读-写italic设置或检索文本是否应该为斜体。布尔读-写overColor设置或检索当鼠标移动到元素上时文本的颜色。字符串读-写size设置或检索文本文字大小，以磅表示。整数读-写strikeout设置或检索是否应该删除文本。布尔读-写trimming如果文本太大无法显示，设置或检索剪裁模式。
可能值：none、character、word、character-ellipsis、word-ellipsis、path-ellipsis字符串读-写underline设置或检索是否应该为文本添加下划线。布尔读-写vAlign设置或检索垂直对齐方式。
可能值：top（靠上）、middle（居中）、bottom（靠下）字符串读-写wordWrap设置或检索文本是否应该换行。布尔读-写

<progressBar> 元素，progressBar 对象。 
进度条对象，同样继承了 basicElement 对象的所有属性和方法。属性名称说明类型读/写emptyImage设置或检索滑块为空时显示的图片。字符串读-写fullImage设置或检索滑块充满时显示的图片。字符串读-写max设置或检索最大值 - 滑块充满时的值。整数读-写min设置或检索最小值 - 滑块为空时的值。整数读-写orientation设置或检索滑块的方向。
可能值：horizontal（水平）、vertical（垂直）字符串读-写thumbDisabledImage设置或检索禁用滑块时显示的缩略图。字符串读-写thumbDownImage设置或检索当按缩略图时显示的图片。字符串读-写thumbOverImage设置或检索当鼠标移动到缩略图上时显示的图片。字符串读-写thumbImage设置或检索缩略图的默认图片。字符串读-写value设置或检索该值。整数读-写事件 名称说明onchangevalue 属性更改时触发。

options 
独立对象，不会从其他任何对象继承。属性名称说明类型读/写count返回字典中的项目数。整数只读defaultValue (string name)设置或返回 name 的 defaultValue。字符串读-写item (string name)设置或返回 name 的当前值。这是默认属性。字符串读-写方法名称和参数说明返回值add(string name, variant value)如果某项未包含在字典中，添加此项。voidexists(string name)如果已经设置 name 值，返回 true。布尔remove(string name)从字典中删除此值。voidremoveAll()从字典中删除所有值。void

googleTalk 
4.0 版本之前的对象，其事件句柄使用 4.0 版本之前的事件处理模式。属性名称说明类型读/写friends返回在线朋友姓名。一组friend 对象。只读方法名称和参数说明返回值SendTalkData(friend_id, data)向朋友发送字符串。friend_id 来自 friend 对象的 user_id 属性。不返回任何值。SendTalkText(friend_id, message)向朋友发送作为即时消息的文本消息。friend_id 来自 friend 对象的 user_id 属性。不返回任何值。事件句柄 名称原型说明返回值onReceiveTalkDataOnReceiveTalkData(friend, data)当某位朋友机器上的同一插件发送数据时调用。friend 为 friend 对象，data 为字符串。不返回任何值。

Friend 对象 
此对象由 googleTalk 返回。Google 小工具无法创建此类型的变量。属性名称说明类型读/写name朋友的可见用户名。字符串只读user_id朋友的用户 ID，此 ID 被作为参数传递给 SendTalkText 和 SendTalkData 等方法。字符串只读email_address朋友的电子邮件地址。字符串只读has_sidebar朋友是否安装了补充工具栏。布尔只读status朋友的状态（例如，在线/空闲/忙碌）。整数只读

ContentItem 对象 
4.0 版本之前的对象，其事件句柄使用 4.0 版本之前的事件处理模式。属性名称说明类型读/写image项目中显示的图片。图片读/写notifier_image通知程序中显示的图片。图片读/写time_created时间（在 JavaScript 中，指可变时间值）。时间读/写heading项目显示的标题。字符串读/写source项目显示的网站/新闻来源。字符串读/写snippet项目显示的摘录。字符串读/写open_command用户打开/双击项目时打开的网址/文件路径。字符串读/写layout项目的布局表明项目的显示格式。整数读/写flags内容项标记组合。整数只写tooltip工具提示文本，例如完整路径、完整标题等等。字符串只写friend_name如果此项目来自其他用户，则包含发送项目的用户名。字符串读/写time_received如果此项目来自其他用户，则包含接收的日期和时间（使用通用协调时间）。字符串读/写方法名称和参数说明返回值SetRect(x, y, width, height)设置项目的显示位置。在设置任何项目的位置之前，启用插件的MANUAL_LAYOUT 标记。如果未启用，此项目将显示在插件给定的默认位置。无事件句柄 名称原型说明返回值onDrawItemDrawItem(item, display_target, graphics, x, y, width, height)调用以绘制项目。不返回任何值。onGetHeightGetHeight(item, display_target, graphics, width)调用以获取项目在宽度给定时的高度，以像素数表示。返回 integer，按像素数给出项目高度。onOpenItemOpenItem(item)用户打开/双击项目时调用。不返回任何值。onToggleItemPinnedStateToggleItemPinnedState(item)用户点击项目的“针形标记”按钮时调用不返回任何值。onGetIsTooltipRequiredGetIsTooltipRequired(item, display_target, graphics, x, y, width, height)调用以检查显示在给定位置的项目是否需要工具提示返回布尔值，true 显示工具提示，false 不显示工具提示。onDetailsViewOnDetailsView(item)在为给定项目显示详细视图之前调用不返回任何值，将取消详细视图；或返回一个具有以下属性的对象：

• obj.title - 详细视图显示的标题
• obj.details_control - 应该在详细视图中显示的 activeX 控件
• obj.flags - 控制详细视图布局/使用的标记

对于以上每个参数的详细信息，请参阅界面IGoogleDesktopDisplayContentItemHandler 中有关OnDetailsView 的文档。onProcessDetailsViewFeedbackProcessDetailsViewFeedback(item, details_view_flags)调用以处理用户在详细视图中的操作。不返回任何值。onRemoveItemRemoveItem(item)当用户从显示中删除一项时调用返回 true 取消删除，保留此项目；返回 false 继续操作，删除此项目。

DetailsView 对象 
4.0 版本之前的对象，其事件句柄使用 4.0 版本之前的事件处理模式。方法名称和参数说明返回值SetContent(source, time_created, text, time_absolute, content_layout)设置要在“详细视图”内容窗格中显示的内容。无SetContentFromItem(item)设置从项目直接显示的内容。无

menu方法名称和参数说明返回值AddItem(item_text, style, handler)添加一个菜单项。style 是 gddMenuItemFlagXXXX 的组合。handler 的函数原型是 OnMenuItem(item_text)。不返回任何值。SetItemStyle(item_text, style)设置给定菜单项的样式。Style 是 gddMenuItemFlagXXXX 的组合。不返回任何值。AddPopup(popup_text)添加显示给定文本的子菜单/弹出式菜单。返回新弹出式菜单的菜单对象。

Framework 命名空间 

framework 
如果指向其子对象，则 framework 关键字可选。例如，framework.system.battery 等同于 system.battery对象说明system返回收集计算机系统相关信息的对象。方法名称和参数说明返回值BrowseForFile( string Filter)显示文件对话的标准浏览，并返回所选文件的文件名；如果取消此对话，则显示空字符串。过滤器字符串的形式为“显示名称|类型列表”，并可以为其添加多个条目。例如“音乐文件|*.mp3;*.wma|所有文件|*.*”通过对话的“文件类型”下拉菜单定义了两种可能选择：音乐文件，符合 *.mp3 或 *.wma 的任何文件；所有文件，符合 *.* 的任何文件。字符串BrowseForFiles( string Filter)显示文件对话的标准浏览，并返回包含所选文件名称的集合；如果取消此对话，则显示空字符串。查看 BrowseForFile，获得对 Filter 参数的说明。collection

framework.graphics对象说明createPoint返回 Point 对象。createSize返回 Size 对象。loadImage(image_src)加载和返回（作为 image 对象）给定的图片文件。
image_src 可以是本地文件（不支持远程网址）的路径，也可以是 XMLHttp 对象的 responseStream 成员（通过它，小工具可以使用 XMLHttp 对象下载和加载图片）。您可以将图片文件对象用作contentItem.image 属性的值，或修改旧的 API 的 plugin 对象的 <smallIcon> 和 <icon> 属性。

framework.system 
有关这些对象属性的信息，请参阅以下条目对象 说明 cursor 返回提供鼠标光标相关信息的对象。 filesystem 返回提供对 Windows 标准 Scripting.FileSystemObject 对象访问权的对象。 memory 返回提供系统内存相关信息的对象。 network 提供系统无线连接相关信息的对象的父对象。目前，framework.system.network 自身不具有属性，本身也不作为对象使用。 perfmon 返回提供类似于 Windows PerfMon 的信息的对象。 power 返回提供系统节能状态相关信息的对象。processor 返回提供系统处理器相关信息的对象，可以提供诸如批次，型号，名称，速度，厂家等信息。 screen 返回提供屏幕相关信息的对象。 

framework.system.cursor属性类型说明positionpoint返回 Point 对象，它包含当前光标相对于屏幕的位置。

framework.system.memory属性类型说明free整数当前可用的虚拟内存（物理 + 转换）的字节数。total整数虚拟内存（物理 + 转换）的总字节数。used整数当前正在使用的虚拟内存（物理 + 转换）的字节数。freePhysical整数当前可用的物理内存的字节数。totalPhysical整数物理内存的总字节数。usedPhysical整数当前使用的物理内存的字节数。

framework.system.network.wireless属性类型说明available布尔如果可以使用无线则为 True。connected布尔如果已连接到无线网络此值为 True。name字符串返回无线适配器的名称。networkName字符串返回无线网络的名称。signalStrength整数返回无线连接的信号强度。值为 0-100。

framework.system.perfmon属性类型说明currentValue ("counter_path")可变返回所指定计数器的当前值。应该已经使用 addCounter 添加计数器。计数器路径由 Windows PerfMon 应用程序定义和记录，类似 “\Processor(_Total)\% Processor Time” 或 “\LogicalDisk(_Total)\% Disk Time”。方法名称和参数说明返回值addCounter(string counter_path, string script_code)开始监控指定计数器。只要计数器值改变，此脚本代码就会运行。voidremoveCounter(string counter_path)停止监控指定计数器。void

framework.system.power 
注意：如果此计算机没有电池或 Windows 无法确定电池的值，整数类型属性将返回 -1。属性类型说明charging布尔如果电池正在充电，值为 true。percentRemaining整数剩余电池电量（百分比）pluggedIn布尔如果计算机已插上电源，则为 true。timeRemaining整数所估计的电池需要充电之前的剩余时间（以秒表示）。timeTotal整数所估计的电池完全充满后的工作时间（以秒表示）。

framework.system.processor属性类型说明architecture字符串处理器架构（例如 x86）。count整数安装的处理器数量。family整数处理器系列的标识。model整数标记的处理器型号。name字符串处理器名称（用于显示）。speed字符串处理器速度，以 mhz 表示。stepping整数处理器的步进标识。vendor字符串处理器供应商名称。

framework.system.screen属性类型说明size尺寸返回包含屏幕尺寸信息的 size 对象。

Point 对象

表示一个由其位置确定的点。坐标值与哪些因素相关取决于指定这些值的方法或属性。

point属性名称说明类型读/写xX-坐标值。整数读-写yY-坐标值。整数读-写

Size 对象

表示某一对象的大小。

size属性名称说明类型读/写height高度值。整数读-写width宽度值。整数读-写

常量和标记详细视图标记名称说明gddDetailsViewFlagNone没有传递任何标记。gddDetailsViewFlagToolbarOpen使详细视图标题像按钮一样可以点击。gddDetailsViewFlagNegativeFeedback在详细视图中添加否定反馈按钮（例如，“不要显示这样的项目”）。gddDetailsViewFlagRemoveButton在详细视图中添加“删除”按钮。gddDetailsViewFlagShareWithButton在详细视图中添加按钮，以在点击时显示朋友列表，用户还可以与其朋友共享内容项目。插件标记名称说明gddPluginFlagNone没有传递任何标记。gddPluginFlagToolbarBack在插件工具栏中添加“返回”按钮。gddPluginFlagToolbarForward在插件工具栏中添加“前进”按钮。信息掩码名称说明gddInfoMaskNone没有传递任何标记。gddInfoMaskMinSize返回显示插件内容所需大小的下限gddInfoMaskMaxSize返回显示插件内容所需大小的上限gddInfoMaskIdealSize返回显示插件内容所需大小的理想值插件命令名称说明gddCmdAboutDialog显示“关于”对话。gddCmdToolbarBack用户点击了“返回”按钮。gddCmdToolbarForward用户点击了“前进”按钮内容项布局名称说明gddContentItemLayoutNowrapItems只有标题和图标时为单行。gddContentItemLayoutNews显示标题、来源和时间的布局。gddContentItemLayoutEmail显示标题、来源、时间和摘录的布局。内容标记名称说明gddContentFlagNone没有传递任何标记。gddContentFlagHaveDetails当用户点击内容项时显示详细视图。gddContentFlagPinnable使用户可以固定内容项，以便一直显示这些项目。gddContentFlagManualLayout通过给定每个项目的显示位置，插件可以管理项目布局内容项标记名称说明gddContentItemFlagNone没有传递任何标记。gddContentItemFlagStatic项目不接受用户输入。gddContentItemFlagHighlighted项目突出显示/显示为粗体。gddContentItemFlagPinned项目被固定在列表顶部。gddContentItemFlagTimeAbsolute项目时间显示为绝对时间，与当前时间无关。gddContentItemFlagNegativeFeedback项目可以从用户那里获得否定反馈。gddContentItemFlagLeftIcon项目图标应该显示在左侧。gddContentItemFlagNoRemove不在上下文菜单中显示此项目的“删除”选项。gddContentItemFlagShareable可以与朋友共享项目。这将启用上下文菜单中的特定菜单项，并启用详细视图中的按钮。gddContentItemFlagShared说明此项目来自其他用户。gddContentItemFlagInteracted说明该用户已经与此项目交互（查看详细信息/打开等等）。小工具显示状态名称说明gddTileDisplayStateHidden平铺窗格不可见。gddTileDisplayStateRestored从最小化或伸出状态恢复平铺窗格。gddTileDisplayStateMinimized平铺窗格已经最小化，只有标题栏可见。gddTileDisplayStatePoppedOut平铺窗格“伸出”补充工具栏另外展开一个窗口。gddTileDisplayStateResized平铺窗格重新调整大小。目标设备名称说明gddTargetSidebar正在补充工具栏中显示/绘制项目。gddTargetNotifier正在通知窗口中显示/绘制项目。gddTargetFloatingView插件/项目正显示在浮动于桌面上的自己的窗口中。ContentItem 显示选项名称说明gddItemDisplayInSidebar在补充工具栏中显示此项目。gddItemDisplayInSidebarIfVisible如果补充工具栏可见，则在其中显示此项目。gddItemDisplayAsNotification在通知窗口中显示此项目。gddItemDisplayAsNotificationIfSidebarHidden如果补充工具栏隐藏，则在通知窗口中显示此项目。窗口类名称说明gddWndCtrlClassLabel标准窗口静态/标签控件。gddWndCtrlClassEdit标准窗口单行编辑控件。gddWndCtrlClassList标准窗口列表框/下拉列表组合框控件。gddWndCtrlClassButton标准窗口按钮控件（还包括复选框）。控件类型名称说明gddWndCtrlTypeNone未传递任何值。编辑控件类型名称说明gddWndCtrlTypeEditPassword用户可以输入密码的编辑框，该框可以隐藏实际输入的字符。列表控件类型名称说明gddWndCtrlTypeListOpen标准列表控件，在可滚动窗口中显示所有选项。gddWndCtrlTypeListDrop下拉列表控件（也称为没有现场编辑功能的组合框控件）。按钮控件类型名称说明gddWndCtrlTypeButtonPush标准按钮。gddWndCtrlTypeButtonCheck复选框控件。字体 ID名称说明gddFontNormal用于常规文本的字体。gddFontSnippet用于摘录文本的字体（可能稍小于常规字体）。gddFontExtraInfo用于项目其他信息（例如来源和时间）的字体。文本颜色 ID名称说明gddColorNormalText常规文本所使用的颜色。gddColorNormalBackground补充工具栏背景所使用的颜色。gddColorSnippet摘录文本所使用的颜色。gddColorExtraInfo项目其他信息（例如来源和时间）所使用的颜色。文本标记名称说明gddTextFlagCenter文本水平居中。gddTextFlagRight文本右对齐。gddTextFlagVCenter文本垂直居中。gddTextFlagBottom文本底部对齐。gddTextFlagWordBreak当换行时在字的分界处截断文本。gddTextFlagSingleLine在一行中显示文本，不换行。菜单项标记名称说明gddMenuItemFlagGrayed禁用的菜单项。gddMenuItemFlagChecked选中的菜单项。出现在选项对话框中的按钮 ID名称说明gddIdOK“确定”按钮gddIdCancel“取消”按钮。写入插件日志的消息级别名称说明gddLogLevelDebug用于正常诊断消息。gddLogLevelInfo用于可能属于不正常行为的提供信息的消息。gddLogLevelWarning用于输入/数据不正常、需要注意的情况。gddLogLevelError用于重大错误。好友列表中联系人的状态名称说明gddFriendStatusOnline好友在线。gddFriendStatusIdle好友空闲，最近没有使用此 PC。gddFriendStatusBusy好友正忙。“发送至”目标名称说明gddSendToSidebar将此数据发送至给定用户的补充工具栏。gddSendToIM使用即时消息将此数据发送至给定用户。gddSendToEmail使用电子邮件将此数据发送至给定用户。