# 文本对象 - AJAX/Webview

文本对象可用于在布局中显示文本信息或图片。

## 文本对象：对象菜单

通过双击工作表对象，或单击对象标题（若显示）中的 the Menu icon 图标可以打开对象菜单作为上下文菜单。

菜单中的命令可能依据 WebView 是从 QlikView 中使用还是在 Web 浏览器中存取文档而有所不同。此菜单包含以下命令：

对象菜单命令

| 命令 | 说明 |
| --- | --- |
| 属性... | 打开活动工作表对象的 **属性**对话框。 |
| 注 | 允许创建和共享当前对象的注释。 |
| 复制 | 将选定的工作表对象复制到剪贴板。此函数只复制工作表对象，而不复制日期或图片。 |
| 删除 | 移除从工作表中选择的对象。 |

## 文本对象属性

可以通过以下方式打开属性对话框：选择 **属性**（从 **对象**菜单）。 如果 **属性**命令变暗，您可能不具有对属性进行更改的必要权限。

### 文本

输入文本应显示的文本对象。 该值可以作为计算公式输入。 单击 the 编辑表达式 icon 以打开对话框。

### 操作

要添加操作，请单击 the Add icon。一旦打开新操作，操作设置便会弹出。还可以在下拉中选择操作，然后单击 the Settings icon 编辑。the Move icon 图标可在列表中移动项目。the Remove icon 图标可从列表中移除项目。

#### 操作设置弹出窗口

以下选项可用：

* 类型：在下拉列表中选择类型。
* 子类型：在下拉列表中选择子类型。可用的子类型取决于选择的操作类型。

#### 操作类型和操作

选择项：

* 在字段中选择：选择指定的值和字段。在搜索字符串中，您可指定一个搜索掩码。如指定 (A|B)，则将选择 A 和 B。
* 选择排除项：在指定字段选择排除值。
* 选择可能值：在指定字段中选择可能值。
* 切换选择：在当前选择项和指定的字段及搜索字符串中选择。在搜索字符串中，您可指定一个搜索掩码。如指定 (A|B)，则将选择 A 和 B。
* 前进：在选择项清单中前进一步。
* 后退：在选择项清单中后退一步。
* Pareto 选择：根据表达式及百分比在指定字段做出 pareto 选择。这种类型的选择项用于选择一种度量的顶部贡献者，通常符合 80/20 规则。例如，要想找出贡献了 80% 营业额的顶端客户，Customer 应作为字段使用，sum(Turnover) 应用作表达式，80 应用作百分比。
* 字段锁定：在指定字段中锁定选择项。
* 全部锁定：锁定所有字段中的全部值。
* 字段解锁：在指定字段中解锁选择项。
* 全部解除：解锁所有字段中的全部值。
* 解锁并清除全部：解锁全部值并清除所有字段中的全部选择项。
* 清除其他字段：清除指定字段以外的所有相关字段。
* 全部清除：清除全部选择项，已锁定选择项除外。
* 清除字段：清除指定字段。

#### 布局

* 激活对象：激活对象 ID 指定的对象。此函数无法在 AJAX 客户端中工作。
* 激活工作表：激活工作表 ID 指定的工作表。
* 激活下一张工作表：打开文档中的下一张工作表。
* 激活上一张工作表：打开文档中的上一张工作表。
* 最小化对象：最小化对象 ID 指定的对象。
* 最大化对象：最大化对象 ID 指定的对象。
* 恢复（对象）：恢复对象 ID 指定的对象。

#### 书签

* 应用书签：应用书签 ID 指定的书签。如果两个书签拥有相同的 ID，将会应用文档的书签。要应用服务器书签指定服务器\书签 ID。
* 创建书签：从当前的选择项创建一个书签。指定书签 ID 及书签名称。选择 **隐藏**创建隐藏书签。
* 替换书签：用当前的选择项替换书签 ID 指定的书签。

#### 打印

* 打印对象：打印对象 ID 指定的对象。如果要将对象发送到默认打印机以外的打印机，请指定打印机名称。（不可用作文档和工作表触发器。）
* 打印工作表：打印工作表 ID 指定的工作表。（不可用作文档和工作表触发器。）此函数无法在 AJAX 客户端中工作。
* 打印报表：打印 报告 ID指定的报告。如果要将报告发送到默认打印机以外的打印机，请指定打印机名称。如果您要显示 Windows 打印对话框，请标记复选框显示打印对话框。（不可用作文档和工作表触发器。）

#### 外部

有些客户可能无法应付此类设置！

* 导出：导出一份包含一组特定字段的表格，但只有对于作出的选择适用的记录才会导出。单击 操作页面中的设置按钮打开导出操作设置对话框。此项不可用作文档和工作表触发器。

  信息注释此函数无法在 AJAX 客户端中工作。

* 启动：启动一项外部计划。以下设置可在操作对话框中进行配置：

  * 应用程序：单击浏览... 可找到应启动的应用程序。（不可用作文档和工作表触发器。）
  * 文件名：输入应使用以上指定的应用程序打开的文件的路径。（不可用作文档和工作表触发器。）
  * 参数：在应用程序启动位置指定命令行参数。（不可用作文档和工作表触发器。）
  * 工作目录：为启动应用程序设置工作目录。（不可用作文档和工作表触发器。）
  * 关闭 QlikView 时退出应用程序：当退出 QlikView 时，强制关闭应用程序。（不可用作文档和工作表触发器。）

    信息注释此函数无法在 AJAX 客户端中工作。

* 打开 URL：您可在另一个 QlikView 文档中，使用打开 URL 来打开指向 QlikView 文档的 URL（文档链接）。该设置在默认网络浏览器中打开 URL。该功能不能用作文档和工作表触发器。如果使用打开 URL，确保以小写在操作字符串中输入文档名称。  
  在可行时，使用打开 QlikView 文档而非打开 URL。

  信息注释默认情况下，禁止在 URL 中使用 Javascript。

  您可以通过更改 custom.config 文件中的 `PreventJavascriptInObjectActions` 参数来允许 URL 中的 Javascript。

* 打开 QlikView 文档：您可在另一个 QlikView 文档中，使用打开 QlikView 文档 来打开 QlikView 文档（文档链接）。该功能不能用作文档或工作表触发器。更多信息，请参阅[文档链接示例](https://help.qlik.com/zh-CN/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Ajax/WebView_TextObject.htm#Document)。

* 执行宏：输入要执行的宏的路径和名称。输入以后可能在编辑模块对话框中为其创建宏的任何名称，或一个 动态更新的计算表达式。

* 设置变量：为指定的变量分配一个值。

* 显示信息：显示相关信息，如一个文本文件或字段中指定的字段图片。此函数无法在 AJAX 客户端中工作。

* 关闭这个文档：关闭当前 QlikView 文档。

* 重新加载：在当前文档中执行重新加载。此函数无法在 AJAX 客户端和 IE 插件中工作。

* 动态更新：在当前加载的文档中执行数据动态更新。动态更新状态将被输入 Statement 字段中。  
  动态更新的预期用途使 QlikView 管理员可以从单一源传送数量有限的数据到 QlikView 文档，同时无需执行重新加载文档。这时连接到 QlikView Server 的多个客户端可执行分析。

  信息注释更新的信息只存储在 RAM，如果执行重新加载文档，使用动态更新添加或更新的任何数据都将丢失。

  以下语法描述了可能与动态更新功能一起使用的语句及其组件：

  * statements ::= statement { “;” statement }
  * statement ::= insert\_statement | update\_statement | delete\_statement | begin\_transaction\_statement | commit\_transaction\_statement
  * insert\_statement ::= "INSERT" "INTO" ("\*" | table\_name) field\_list "VALUES" value\_list {"," value\_list} ["KEY" ["AUTO" | (" (" field\_list ")")] ["REPLACE" (["WITH" "ONE"] | "EACH") ]]{"," value\_list}
  * update\_statement ::= "UPDATE" ("\*" | table\_name) set\_clause {"," | set\_clause} "WHERE" condition ["AUTO" "INSERT"]
  * delete\_statement ::= "DELETE" "FROM" ("\*" | table\_name] "WHERE" condition
  * begin\_transaction\_statement ::= "BEGIN" ("TRANSACTION" | "TRAN") [trans\_name]
  * commit\_transaction\_statement ::= "COMMIT" ["TRANSACTION" | "TRAN"] [trans\_name]
  * table\_name ::= identifier | quoted\_name
  * field\_list ::= "(" field\_name {"," field\_name} ")"
  * value\_list ::= "("value {"," value} ")"
  * set\_clause ::= "SET" field\_name "=" any\_valid\_non\_aggregated\_qlikview\_expression
  * field\_name ::= identifier | quoted string
  * value ::= identifier | any\_qlikview\_number | quoted string
  * condition ::= any\_valid\_non\_aggregated\_qlikview\_expression
  * identifier ::= any\_qlikview\_identifier
  * quoted\_string ::= "[" [^]]+ "]"

  示例：

  `  UPDATE AbcTable SET Discount = 123 WHERE AbcField=1 `

  信息注释 要使用此功能，文档和服务器都必须能够支持动态更新。

#### 文档链接示例

您可使用打开 QlikView 文档来创建文档链接。

可以应用以下设置：

* 传输状态：将选择项从初始文档传输至目标文档。目标文档将首先会清除选择项。

* 应用状态到当前选择项之上：保留目标文档的选择项并将原始文档的选择项应用到它们之上。

  信息注释 如果在两个文档中创建的选择项冲突，使用应用状态到当前选择项之上可能返回意外的结果。

* 在相同的窗口中打开：在使用 AJAX ZFC 客户端时在相同浏览器选择项卡中打开新文档。

  信息注释对于非域用户，在使用 QlikView 插件时，不支持打开 QlikView 文档操作。

QlikView 文档：必须包括目标文件的扩展名。只要链接的文档存储在相同文件夹结构中（挂载），则支持在所有客户端中从一个 QlikView 文档到另一个导航的相对路径。

以下示例示出了如何将文件路径写入目标文件：

示例：位于相同文件夹结构中的文件（相同挂载）。

* 如果目标文件位于相同文件夹中：  
  DestinationDoc.qvw

* 如果目标文件位于子文件夹中：  
  SubFolder/DestinationDoc.qvw

* 如果目标文件位于上层文件夹中：  
  ../DestinationDoc.qvw

* 如果目标文件位于上层和同层文件夹中：  
  ../ParallelFolder/DestinationDoc.qvw

示例：文件位于不同的文件夹结构中（不同挂载）。在 Ajax 客户端中仅支持不同挂载之间的相对路径。

* 如果目标文件位于不同挂载中：  
  ../DifferentMount/DestinationDoc.qvw

示例：使用挂载路径来指向 QlikView 文档。在 Ajax 客户端中仅支持设置指向挂载的文件夹的路径。

* 如果目标文件位于相同挂载的文件夹中：  
  \Mount\DestinationDoc.qvw

* 如果目标文件位于不同挂载的文件夹中：  
  \DifferentMount\DestinationDoc.qvw

  信息注释带有已挂载文件夹的文档链接不适用于 QlikView 插件。

示例：使用绝对路径来指向 QlikView 文档。在 Ajax 客户端和 QlikView Desktop 中支持使用文档链接的绝对路径。

* 指向本地 Local Root 文件夹或挂载的绝对路径：  
  C:\...\DestinationDoc.qvw

* 指向网络共享的绝对路径：  
  \\SharedStorage\...\DestinationDoc.qvw

Qlik Sense Cloud 应用中心中的 QlikView 应用：您需要 AppId，而非路径。需要在 QlikView Desktop 中准备和更新应用程序。当应用程序在应用中心中打开时，可以在 URL 中找到 AppId。

示例

如果 URL 为 https://qcs.us.qlikcloud.com/qv/opendoc.htm?document=1cc71b323f172f93a8121ce1456cdg。则 AppId 为 1cc71b323f172f93a8121ce1456cdg。

## 文本对象属性：外观

### 呈现形式

文本对象中的文本可解释为至一个存储器或光碟中的一个索引。当选择文本时，文本对象的内容将总是解释并显示为文本。当您选择了图片时，QlikView 将偿试将文本内容解释为至一个图片的参考。参考可能是至一个磁碟上的文件的路径或者在一个 .qvw 文档中。它也可是一个链接到一个包含图片信息的信息函数。如果 QlikView 无法将文本内容解释为至一个图片的有效参考，将会显示文本本身。单击 the Settings icon 打开弹出窗口。

#### 格式化

有以下格式选项可用：

* 没有拉伸：显示时图片不伸展。这可能会导致部分图片无法显示或仅填充对象的一部分。
* 填充：伸展图片以适应对象区域，不保持图片的长宽比。
* 保持长宽比：尽量伸展图片以填充对象区域，同时保持图片的长宽比。
* 以固定长宽比填充：伸展图片以在两个方向填充对象区域，同时保持图片的长宽比。

### 水平

左、居中 或右对齐文本或图片。

### 垂直

上、居中 或下对齐文本或图片。

### 文本边框

设置文本对象外边框和文本本身之间的页边距。

### 显示水平滚动条

如果勾选了此复选框，当文本内容太多无法在给定的区域完整显示时，一个水平滚动条将会被添加至文本对象中。

### 显示垂直滚动条

如果勾选了此复选框，当文本内容太多无法在给定的区域完整显示时，一个垂直滚动条将会被添加至文本对象中。

### 背景样式

#### 颜色

设置背景颜色，要么为纯色，要么为渐进色。单击the Caption color icon选择颜色。

#### 图片

设置背景图片。单击 the Add image icon 浏览图片。单击 the 图片 icon 打开弹出窗口。

* 没有拉伸：显示时图片不伸展。这可能会导致部分图片无法显示或仅填充对象的一部分。
* 填充：伸展图片以适应对象区域，不保持图片的长宽比。
* 保持长宽比：尽量伸展图片以填充对象区域，同时保持图片的长宽比。
* 以固定长宽比填充：伸展图片以在两个方向填充对象区域，同时保持图片的长宽比。
* 水平：左对齐、居中对齐或右对齐。
* 垂直：顶部对齐、居中对齐或底部对齐。
* 透明度：通过输入一个值或拖动滑块设置透明度。设置为 100% 时，背景将完全透明。

### 背景透明度

设置文本对象背景的透明度。设置为 100% 时，背景将完全透明。

### 更多.../更少...

单击此按钮展开/折叠包含其他标签的折页。

#### 样式

外观样式

| 选项 | 说明 |
| --- | --- |
| 文本 | 要设置文本颜色，请单击 the Font color icon。要设置字体类型，请单击 the Font icon。 |
| 标题字体 | 要设置标题字体类型，请单击 the Font icon。 |
| 活动标题 | 要设置活动标题的背景颜色，请单击 the Caption color icon。要设置文本颜色，请单击 the Font color icon。 |
| 非活动标题 | 要设置非活动标题的背景颜色，请单击 the Caption color icon。要设置文本颜色，请单击 the Font color icon。 |
| 使用边框 | 勾选该复选框，可以在工作表对象周围使用边框。单击 the Caption color icon 以设置边框颜色。 |
| 边框宽度 | 在输入字段中指定边框宽度，或使用滑块设置期望的宽度值。宽度用像素来指定。 |
| 圆角 | 单击the 圆角 icon打开弹出窗口。<br><br>信息注释<br><br>圆角仅在以下情况中可用：选择了高级样式模式（位于文档属性：常规中）。<br><br>选择固定或相对圆角，以及哪些角会受到影响。也可通过输入一个值选择方形。 |

## 文本对象属性：“标题”

### “标题”

* 标签：在文本框中，您可以输入标题，以便显示在工作表对象的标题中。如果未设置标签，但选择了显示标题，则将使用字段的名称。

  该值可以作为计算公式输入。

  单击 the 编辑表达式 icon 以打开对话框。

* 显示标题：勾选了此选项时，标题将会被移至工作表对象的顶部。列表框和其他“框对象”将默认开启该选项，而按钮，文本对象和直线/箭头对象则不会默认开启。

* 标题对齐：可为左、居中或右。

* 多行标题（自动换行）： 如果勾选此选项，则文本将显示两行或多行。

* 行数：如果标题允许使用多行，在输入字段中指定行数，或拖动滑块至所期望的数值。

* 标题对齐：可为顶部、居中或底部。

### 更多.../更少...

* 菜单：打开对象菜单。
* 清除：在活动工作表对象中清除当前选择。
* 打印：在另一个浏览器窗口中以列表格式打开选定的工作表对象。 有些客户可能无法应付此类设置！
* 复制数据：复制工作表对象中的字段值。 有些客户可能无法应付此类设置！
* 将图片复制到剪贴板：将工作表对象作为图片复制到剪贴板。 有些客户可能无法应付此类设置！
* 发送到 Excel...：将可能的（包括选定的）值导出到 Microsoft Excel。如果 Excel 还未运行，将会自动开启。导出的值将在新的 Excel 工作表中显示为一列。计算机上必须安装 Microsoft Excel 2007 或更高版本，此功能才可用。 有些客户可能无法应付此类设置！
* 允许最小化：选中此选项时，如果对象可以最小化，将会在工作表对象的窗口标题中显示最小化图标。此外，还可以通过双击该标题最小化对象。
* 自动最小化：在勾选允许最小化时适用该选项。在相同的工作表上为若干工作表对象勾选自动最小化时，除去一项以外，其他全部对象在任何时候都会自动最小化。此选项十分有用，例如可以交替显示相同工作表区域中的若干图表。
* 允许最小化：选中此选项时，如果对象可以最大化，将会在工作表对象的窗口标题中显示最大化图标。此外，还可以通过双击标题最大化对象。如果同时勾选了允许最小化和允许最大化，双击标题将会导致对象最小化。
* 帮助信息：您可以在此处输入帮助文本。该信息将会显示在弹出窗口中。此选项不适用于文档一级。 该值可以作为计算公式输入。 单击 the 编辑表达式 icon 以打开对话框。   
  例如，您可以输入工作表对象的说明。这将会添加一个帮助图标到对象的窗口标题中。当鼠标指针移到图标上时，该文本将会显示在弹出窗口中。
* 快速转换类型：可在此处启用图表类型切换。并不适用于全部对象。单击 the Settings icon 打开弹出窗口。
* 快速类型设置弹出窗口：勾选此框，可使用快速转换类型在您希望图表类型之间进行切换。

## 文本对象属性：选项

### 选项

部分选项可能不能用于所有对象。

* 只读：让图表变为只读模式，即无法以在图表内单击或使用鼠标绘画的方式作出选择。
* 允许移动/调整大小：如果取消选择此选项，则将无法移动工作表对象或调整其大小。
* 允许复制/备份：如果取消选择此选项，则将无法复制工作表对象。某些客户端可能无法使用此设置。
* 依数据调整对象大小：通常，当选择引起表格的大小小于工作表对象分配的大小时，QlikView 中全部数据表的工作表对象的边框将会缩小。通过取消选中该复选框，将会关闭大小的自动调整，任何剩余空间都将留空。
* 允许显示标题信息：使用 info 函数时，每当字段值具有与之相关的信息时，窗口标题中都将显示一个信息图标。如果您不想信息图标显示在标题中，可以取消勾选此选项。仅适用于列表框、统计框、多选框和输入框。
* 保留滚动条的位置：当勾选此复选框和 用户偏好 ， 对象 对话框中相应的选项时，在表格对象中进行选择时 QlikView 将保留垂直滚动条的位置。
* 使用显示条件：工作表对象的显示或隐藏将取决于条件表达式。系统将视条件（例如选择情况等）对条件表达式进行持续评估。仅当条件返回 false 时工作表对象才会隐藏。 该值可以作为计算公式输入。 单击 the 编辑表达式 icon 以打开对话框。
* 常规：通过设置对象的左边和顶部页边距，以及宽度和高度来指定对象的位置。
* 最小化：通过设置最小化对象的左边和顶部页边距，以及宽度和高度来指定最小化工作表对象的位置。
* 更多.../更少...：以下选项可用：
  * 所有者：所有者域名和用户 ID。

  * 共享对象：启用与其他用户共享对象。启用此选项将启用以下设置。

  * 共享：选择与所有用户共享或按用户名称共享。

  * 用户（域名\用户 ID）：如果选择按用户名称共享，则将显示已添加用户的列表。

    要添加用户，请单击 the Add icon，将添加一行。高亮该行以将其解锁，然后编辑用户信息。要移除用户，请在要移除的每个用户之后单击 the Remove icon。