new AcroFormListBox()
扩展
成员
color :string|rgba
- 源:
- 继承自:
- 默认值:
- 'black'
文本的颜色
类型:
- string | rgba
combo :boolean
- 源:
- 覆盖:
- 默认值:
- false
如果设置，则字段为组合框；如果清除，则字段为列表框。
类型:
- boolean
commitOnSelChange :boolean
- 源:
- 继承自:
- 默认值:
- false
(PDF 1.5) 如果设置，新的值将在选择后立即提交（通常使用指点设备）。在这种情况下，为字段提供值涉及三个操作：选择字段进行填写，选择填写值的选项，以及离开该字段，这将最终确定或“提交”数据选择并触发与输入或更改此数据相关的任何操作。如果此标志开启，则处理不会等待离开字段的操作发生，而是立即进行第三步。 此选项使应用程序能够在选择后执行操作，而无需用户退出字段。如果清除，则新的值在用户退出字段之前不会提交。
类型:
- boolean
defaultValue :any
- 源:
- 继承自:
- 默认值:
- null
(可选；可继承) 字段在执行重置表单操作时恢复的默认值（见 12.7.5.3，“重置表单操作”）。该值的格式与值的格式相同。
类型:
- any
doNotSpellCheck :boolean
- 源:
- 继承自:
- 默认值:
- false
(PDF 1.4) 如果设置，输入字段的文本将不进行拼写检查。此标志仅在组合和编辑标志都设置时使用。
类型:
- boolean
edit :boolean
- 源:
- 继承自:
- 默认值:
- false
如果设置，组合框将包括一个可编辑的文本框以及一个下拉列表；如果清除，则仅包括一个下拉列表。此标志仅在组合标志设置时使用。
类型:
- boolean
fieldName :string
- 源:
- 继承自:
- 默认值:
- null
(可选) 部分字段名称（见 12.7.3.2，“字段名称”）。
类型:
- string
fontName :string
- 源:
- 覆盖:
- 默认值:
- 'helvetica'
要使用的字体名称。
类型:
- string
fontSize :number
- 源:
- 继承自:
- 默认值:
- 0 (自动)
要使用的字体大小。
类型:
- number
fontStyle :string
- 源:
- 继承自:
- 默认值:
- 'normal'
要使用的字体样式。
类型:
- string
(只读) hasAnnotation :boolean
检查字段是否有注释
类型:
- boolean
(只读) hasAppearanceStream :boolean
如果字段有外观流，则为真
类型:
- boolean
height :number
- 源:
- 继承自:
- 默认值:
- null
字段的高度。
类型:
- number
maxFontSize :number
- 源:
- 继承自:
- 默认值:
- 0 (自动)
要使用的最大字体大小。
类型:
- number
multiSelect :boolean
- 源:
- 继承自:
- 默认值:
- false
(PDF 1.4) 如果设置，可以同时选择多个字段的选项项；如果清除，最多只能选择一个项
类型:
- boolean
noExport :boolean
- 源:
- 继承自:
- 默认值:
- false
如果设置，字段将不会通过提交表单操作导出（见 12.7.5.2，“提交表单操作”）
类型:
- boolean
page :number
AcroFormField 所在的页面
类型:
- number
readOnly :boolean
- 源:
- 继承自:
- 默认值:
- false
如果设置，用户将无法更改字段的值。任何相关的控件注释将不会与用户交互；即，它们不会响应鼠标点击或根据鼠标动作改变外观。此标志对于值是从数据库计算或导入的字段非常有用。
类型:
- boolean
required :boolean
- 源:
- 继承自:
- 默认值:
- false
如果设置，字段在通过提交表单操作导出时必须有值（见 12.7.5.2，“提交表单操作”）。
类型:
- boolean
showWhenPrinted :boolean
- 源:
- 继承自:
- 默认值:
- true
(PDF 1.2) 如果设置，打印页面时打印注释。如果清除，则无论在屏幕上是否显示，都不会打印注释。 注意 2 这对于表示交互式按钮的注释非常有用，因为在打印页面上没有任何有意义的目的。
类型:
- boolean
sort :boolean
- 源:
- 继承自:
- 默认值:
- false
如果设置，字段的选项项将按字母顺序排序。此标志旨在供写入者使用，而不是供读取者使用。符合标准的读取者应按它们在 Opt 数组中出现的顺序显示选项（见表 231）。
类型:
- boolean
textAlign :string
- 源:
- 继承自:
- 默认值:
- 'left'
(可选；可继承) 指定在显示文本时使用的对齐方式（对齐）代码： 'left', 'center', 'right'
类型:
- string
topIndex :number
- 源:
- 继承自:
- 默认值:
- 0
(可选) 对于可滚动的列表框，顶部索引（在 Opt 数组中第一个可见选项的索引）。默认值：0。
类型:
- number
value :any
- 源:
- 继承自:
- 默认值:
- null
(可选；可继承) 字段的值，其格式根据字段类型而异。有关更多信息，请参见各个字段类型的描述。
类型:
- any
width :number
- 源:
- 继承自:
- 默认值:
- null
字段的宽度。
类型:
- number
x :number
- 源:
- 继承自:
- 默认值:
- null
字段的 x 位置。
类型:
- number
y :number
- 源:
- 继承自:
- 默认值:
- null
字段的 y 位置。
类型:
- number
方法
addOption(value)
参数:
| 名称 | 类型 | 描述 |
|---|---|---|
value |
string |
getOptions() → {array}
返回:
选项数组
- 类型
- array
removeOption(value, allEntries)
参数:
| 名称 | 类型 | 描述 |
|---|---|---|
value |
string | |
allEntries |
boolean | (默认: false) |
setOptions(value)
参数:
| 名称 | 类型 | 描述 |
|---|---|---|
value |
array |