用于工具栏和菜单的图像
From Apache OpenOffice Wiki
OpenOffice.org 支持菜单和工具栏中的图像。除了属性 ImageIdentifier，加载项配置分支还有一个名为 Images 的第四集，它允许开发者定义并使用自己的图像。图像数据可以集成到配置中，或者作为十六进制编码的二进制数据， 或者作为对外部位图文件的引用。Images 集将命令 URL 绑定到用户自定义的图像。
| 模板 Images 的属性 | |
|---|---|
oor:name
|
字符串型。配置节点的名称。该名称在配置分支中必须是唯一的。因此，必须使用诸如 org.openoffice.<developer>.<add-on name> 或 com.<company>.<product>.<add-on name> 之类的模式以避免产生名称冲突。请记住，您的配置文件将合并到 OpenOffice.org 配置分支中。您不知道用户以前安装了多少或安装了哪些加载项。请记住，名称必须以 ASCII 字母字符开始。
|
URL
|
字符串型。指定应绑定到已定义的图像的命令 URL。OpenOffice.org 使用菜单项/工具栏项包含的命令 URL 搜索图像。 |
UserDefinedImages
|
属性 组。这组可选属性可以为 OpenOffice.org 提供自定义的图像数据。有两组不同的属性可以定义图像数据。一组属性可以提供图像数据作为指定未压缩的位图格式数据流的实时十六进制值。另一组属性使用指向外部位图文件的 URL。这些属性的名称都以 'URL' 结尾。OpenOffice.org 支持具有 1、4、8、16 和 24 位颜色深度的位图流。洋红（颜色值 red=0xffff、green=0x0000、blue=0xffff）用作透明色，表示绘制图像时使用显示的背景色，而不使用图像像素颜色。要获得最佳质量，小图像的大小应为 16x16 像素，大图像应为 26x26 像素。其他图像大小将由 OpenOffice.org 自动缩放。如果未提供高对比度图像数据，OpenOffice.org 将在高对比度环境中使用普通图像。无效的图像数据将被忽略。 |
Images 节点使用名为 UserDefinedImages 的第二个节点存储用户自定义的图像数据。
| 模板 UserDefinedImages 的属性 | |
|---|---|
ImageSmall
|
HexBinary。用于常规菜单/工具栏项，标准大小是 16x16 像素。 |
ImageBig
|
HexBinary。只有工具栏可以使用大图像。标准大小是 26x26 像素。用户可以使用工具 – 选项 – 视图 – 大按钮复选框激活大按钮。 |
ImageSmallHC
|
HexBinary。用于高对比度环境，表示菜单或工具栏的背景色低于特定的亮度阈值。 |
ImageBigHC
|
HexBinary。只有工具栏可以使用大图像。用于高对比度环境，表示工具栏的背景色低于特定的亮度阈值。 |
ImageSmallURL
|
字符串型。指向用于菜单项和普通工具栏按钮的外部图像的 URL。支持外部用户自定义的图像的方法是使用代表文件夹的占位符变量 %origin%，而 pkgchk 工具就将在该文件夹中安装组件。pkgchk 工具会用另一个占位符替换 %origin%，它将在运行时期间由 OpenOffice.org 替换为真正的安装文件夹。由于 OpenOffice.org 支持两个不同的配置文件夹（user 和 share），因此有必要利用此机制来确定组件的安装文件夹。
例如,URL %origin%/image 将被替换为类似如下所示的路径 vnd.sun.star.expand:$UNO_USER_PACKAGES_CACHE/uno_packages/component.zip.1051610942/image。 占位符 vnd.sun.star.expand:$UNO_USER_PACKAGES_CACHE 将在运行时期间被替 换为真正的路径。 |
ImageBigURL
|
字符串型。指向用于大工具栏按钮的外部图像的 URL。 |
ImageSmallHCURL
|
字符串型。指向在高对比度环境中用于菜单项和普通工具栏按钮的外部图像的 URL。 |
ImageBigHCURL
|
字符串型。指向在高对比度环境中用于大工具栏按钮的外部图像的 URL。 |
与 URL 属性一起使用时，嵌入图像数据具有更高的优先级。嵌入数据与 URL 属性可以混合使用，不会产生问题。
以下示例将创建两个用户自定义的图像，用于功能 org.openoffice.Office.addon.example:Function1。普通图像使用嵌入图像数据属性 ImageSmall 定义，大小为 16x16 像素，颜色深度为 4 位。另一个使用 URL 属性 ImageSmallHCURL 引用用于高对比度图像的外部位图文件。
<?xml version='1.0' encoding='UTF-8'?> <oor:component-data xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" oor:name="Addons" oor:package="org.openoffice.Office"> <node oor:name="AddonUI"> <node oor:name="Images"> <node oor:name="com.sun.star.comp.framework.addon.image1" oor:op="replace"> <prop oor:name="URL" oor:type="xs:string"> <value>org.openoffice.Office.addon.example:Function1</value> </prop> <node oor:name=”UserDefinedImages”> <prop oor:name=”ImageSmall”> <value>424df80000000000000076000000280000001000000010000000010004000000000000000000120b0000120b000000000000000000000000ff0000ffff0000ff0000ffff0000ff000000ff00ff00ffffff00c0c0c0008080800000000000000080000080800000800000808000008000000080008000cccccccccccccccc2c266b181b666c2c5cc66b818b6665c555566b181b66655555566b818b66655555566b181b6665555a8666bbb6668a55a0a866666668a0a5000a8666668a000a6000a86668a000a556000a868a000a55556000a8a000a5555556000a000a55555555600000a55555555556000a55555555555560a55555550000</value> </prop> <prop oor:name=”ImageSmallHCURL”> <value>%origin%/function1.bmp</value> </prop> </node> </node> </node> </node> </oor:component-data></nowiki>
| Content on this page is licensed under the Public Documentation License (PDL). |
