Oma_Ot_Template_Column_Add()
摘要
向模板添加一个新列。
语法
Oma_Ot_Template_Column_Add (template_ptr, column_tag, column_title, format_string, value_type, options)
| 参数 | 类型 | 说明 |
|---|---|---|
template_ptr |
OmaT_Ot_Template * |
接收新列的模板。 |
column_tag |
const char * |
标识该列的唯一字符串。 |
column_title |
const char * |
列的名称(无需唯一)。 |
format_string |
const char * |
显示列值的格式(如 “%.12g”、“0x%lX”),或 PRGC_NIL。 |
value_type |
OmaT_Ot_Value_Type |
该列可容纳的值类型。有效的符号常量见 表 175。 |
options |
int |
支持的列选项按位或(OR)后的值。参见详情。 |
返回类型
int
新列的索引;如果操作失败,返回 PRGC_NIL 或 -1。
头文件
oma_ot.h
详情
options 必须为 0,或为以下符号常量按位或(OR)组合的值:
OMAC_OT_TABLE_COLUMN_OPT_MULTIPLE_VALUES_PER_CELL——设置该选项后,对该列的收集值会被合并到一个动态增长的数组中。(通常,在两次行写入之间对某列的收集会使先前的值被新值覆盖。)OMAC_OT_TABLE_COLUMN_OPT_INHERIT_PREVIOUS_VALUE——如果该列的值未定义,则应从最接近的前一行的已定义值继承。OMAC_OT_TABLE_COLUMN_OPT_PREFORMATTED_TEXT——该列包含预先格式化的文本字符串。