ALV详细字段介绍以及一些用法.doc

ALV详细字段介绍 ALV常用参数的详细描述 调用功能模块： CALL FUNCTION REUSE_ALV_GRID_DISPLAY EXPORTING i_interface_check = 接口一致性检查 i_callback_program = sy-repid 当前程序名 is_layout = layout 输出样式 it_fieldcat = fieldcat 字段定义描述表 i_callback_pf_status_set = PF_STATUS_SET 触发事件调用子程序 i_callback_user_command = USER_COMMAND 鼠标事件操作子程序 it_events = i_events 出口程序触发事件 i_callback_html_top_of_page = ALV_TOP_OF_PAGE ALV输出表头设置 i_grid_settings = wl_lvc_s_glay 打印表头设置 it_sort = sortable 排序设置 TABLES t_outtab = ig_out EXCEPTIONS program_error = 1 OTHERS = 2. 常用属性：（赋值中内容必须为大写） 1 Fieldcat data: fieldcat type slis_t_fieldcat_alv with header line. it_fieldcat = fieldcat 属性 （用来定义表单中的各个列的相关信息） Fieldcat-col_pos = n. 输出列 Fieldcat-tabname = FIELDNAME. 对应的内表字段名 Fieldcat-seltext_s/m/l = 列名. 输出列文本（_s：短文本 _l：长文本） Fieldcat-emphasize = CX10. 带有颜色的高亮列（其中X=（1-7）颜色同format） Fieldcat-hotspot = X. 作为热点显示，可触发鼠标触发事件 Fieldcat-currency = CURRKEY. 表 TCURX 中的货币名称 Fieldcat-quantity(3) 计量单位 Fieldcat-qfieldname = 数量 参考计量单位的字段名称 Fieldcat-round = n. 四舍五入至小数位数下n 位 Fieldcat-exponent = n. 浮点数的幂指数为n Fieldcat-key = X. 关键字段 Fieldcat-icon = X. 作为图标输出 Fieldcat-symbol = X. 输出作为符号 Fieldcat-checkbox = X. 作为复选框输出 Fieldcat-just = SPACE, R, L, C. 对齐方式 Fieldcat-lzero = X. 输出前导零 Fieldcat-no_sign = X. 输出抑制符号 Fieldcat-no_zero = X. 为输出隐藏零 Fieldcat-edit_mask = SPACE, mask.输出为mask的模式 Fieldcat-fix_column = X. 固定列 Fieldcat-do_sum = X. 总计列值总和 Fieldcat-no_out = X. 列不输出 Fieldcat-tech = X. 该字段为技术字段 Fieldcat-outputlen = n 列的字符宽度为n Fieldcat-decimals_out = n 能控制小数点的位数为n Fieldcat-datatype = C,I,N 定义数据类型 2 SORT data: sortable type slis_t_sortinfo_alv with header line. it_sort = sortable 属性 （排序） Sortable-Fieldname 字段名 Up 升序排列 Down 降序排列 Subtot 3 Layout data: layout type slis_layout_alv . is_layout = layout 属性 (用于定义ALV表单的相关格式、属性) info_fieldname = LINE_COLOR. 设置特殊行颜色（将LINE_COLOR增加到内表字段，写CX10到特殊行的LINE_COLOR, X为颜色值） colwidth_optimize = X. 优化列宽设置 no_colhead = X. 不显示列名 no_vline = X. 不显示列间竖线 zebra = X 可选行颜色,如果设置了，出现了间隔色带 f2code = &ETA. 设置触发弹出详细信息窗口的功能码，这里是双击 detail_initial_lines detail_popup 是否弹出详细信息窗口 detail_titlebar 设置弹出窗口的标题栏 totals_text totals_only group_change_edit header_text 4按钮 DATA: i_events TYPE slis_t_event WITH HEADER LINE. 事件： it_events = i_events i_callback_pf_status_set = PF_STATUS_SET i_callback_user_command = USER_COMMAND 出口程序触发事件对应子程序： FORM PF_STATUS_SET USING rt_extab TYPE slis_t_extab. FORM user_command USING ucomm LIKE sy-ucomm selfield TYPE slis_selfield. 功能代码: 函数文本: 图标名称: &ETA 细节 ICON_SELECT_DETAIL &EB9 调用报告. ICON_TABLE_SETTINGS &REFRESH 刷新 ICON_REFRESH &ALL 全部选择 ICON_SELECT_ALL &SAL 取消全选 ICON_DESELECT_ALL &OUP 按升序排列 ICON_SORT_UP &ODN 按降序排列 ICON_SORT_DOWN &ILT 设置过滤器 ICON_FILTER &UMC 总计 ICON_SUM &SUM 小计. ICON_INTERMEDIATE_SUM &RNT_PREV 打印预览 ICON_LAYOUT_CONTROL &VEXCEL Microsoft Excel ICON_XLS &AQW 字处理. ICON_WORD_PROCESSING %PC 本地文件 . ICON_EXPORT %SL 邮件收件人 ICON_MAIL &ABC ABC 分析 ICON_ABC &GRAPH 图形 ICON_GRAPHICS &OL0 更改布局. ICON_ALV_VARIANTS &OAD 选择格式. ICON_ALV_VARIANT_CHOOSE &AVE 保存格式. ICON_ALV_VARIANT_SAVE &INFO 信息 ICON_INFORMATION 1 ALV表头设置 i_callback_html_top_of_page = ALV_TOP_OF_PAGE form top_of_page using cl_dd type ref to cl_dd_document. 语法同HTML fomat ALV_GRID介绍 一.ALV介绍 The ALV Grid Control (ALV = SAP List Viewer)是一个显示列表的灵活的工具,它提供了基本功能的列表操作,也可以通过自定义来进行增强,因此可以允许你可以在大型的应用程序中使用. SAP提示: 在SAP的开发项目中,ALV GRID也可以作为修改和创建数据的一种工具,然而,目前这个功能只在实验计划中使用,还没有向客户发布. 下面是一个ALV GRID的图片: 它包括3大部分,工具栏,标题,用于显示数据的网格控制器.如果有必要，用户可以隐藏标题和工具栏. ALV家族包含3中ALV工具:简易的,两层ALV,分等级连续的列表和树形结构的ALV. 二.ALV GRID CONTROL (ALV网格控制器) ALV GRID CONTROL使用了控制器技术以实现艺术性的屏幕显示,象所有的控制器一样，ALV GRID CONTROL通过系统中的一个全局的类提供了方法,以响应它的动作. 使用了ABAP的对象以后,列表是通过ALV的一个实例(INSTANCE)来显示的,程序员可以使用ABAP对象的事件管理. 三.ALV GRID CONTROL 实例 ALV GRID实例的定义,参照CL_GUI_ALV_GRID类 data ALV_GRID1 type ref to cl_gui_alv_grid. ALV GRID继承结构: ALV_GRID介绍(1) 四、ALV GRID相关的几个控制结构 1.字段目录 Field catalog 字段目录是用来控制ALV显示的网格中每个字段的属性的,比如字段的顺序,对齐方式,可编辑状态,颜色,等等. 常用的控制字段如下:(下面的示例将说明这些字段的使用,参考STRUCTURE LVC_S_FCAT) 2 ROW_POS ALV 控制: 输出行 (内部使用) 3 COL_POS ALV 控制: 输出列 列的位置,第几列,例如1,2,. 4 FIELDNAME ALV 控制: 内部表字段的字段名称 字段名称 5 TABNAME LVC 标签名称 表名，如果是内表，是1 6 CURRENCY ALV 控制: 货币单位 7 CFIELDNAME ALV 控制: 参考的当前单位的字段名称 8 QUANTITY ALV 控制: 计量单位 9 QFIELDNAME ALV 控制: 参考计量单位的字段名称 10 IFIELDNAME ALV 控制: 内部表字段的字段名称 11 ROUND ALV 控制: ROUND 值 12 EXPONENT ALV 控制：流动表示的指数 13 KEY ALV 控制: 关键字段 关键字段,前面变蓝色 14 KEY_SEL ALV 控制: 可以被隐藏的关键列 可以被隐藏的关键列 15 ICON ALV 控制: 作为图标输出 此列作为图标输出 16 SYMBOL ALV 控制: 输出作为符号 17 CHECKBOX ALV 控制: 作为复选框输出 复选框输出 18 JUST ALV 控制: 对齐 对齐方式: R: right justified L: left justified C: centered 19 LZERO ALV 控制: 输出前导零 X 20 NO_SIGN ALV 控制：输出抑制符号 X,不输出符号 21 NO_ZERO ALV 控制: 为输出隐藏零 X,隐藏0 22 NO_CONVEXT ALV 控制: 不考虑输出的转换退出 23 EDIT_MASK ALV 控制: 为输出编辑掩码 格式 24 EMPHASIZE ALV 控制: 带有颜色的高亮列 列的颜色 25 FIX_COLUMN ALV 控制: 固定列 26 DO_SUM ALV 控制: 总计列值 X,合计 27 NO_SUM ALV 控制: 没有总计列值 X ,没有合计 28 NO_OUT ALV 控制: 列没有输出 X ,隐藏此列 29 TECH ALV 控制: 技术字段 X.也是隐藏，但是有点不一样 30 OUTPUTLEN ALV 控制: 列的字符宽度 输出的长度 31 CONVEXIT 转换例程 32 SELTEXT ALV 控制: 对话功能的列标识符 33 TOOLTIP ALV 控制: 列抬头的工具提示 34 ROLLNAME ALV 控制: F1 帮助的数据元素 35 DATATYPE ABAP 字典中的数据类型 ABAP 字典中的数据类型 36 INTTYPE ABAP 数据类型(C,D,N,.) ABAP 数据类型(C,D,N,.) 37 INTLEN 以字节计的内部长度 内容的长度 38 LOWERCASE 允许/不允许小写字母 X 允许大小写 39 REPTEXT 标题 40 HIER_LEVEL ALV 控制: 内部使用 41 REPREP ALV 控制: 价值是补充/补充接口的选择标准 42 DOMNAME 定义域名 43 SP_GROUP 组代码 44 HOTSPOT ALV 控制: 单击敏感 X,下面出现下划线,响应单击 45 DFIELDNAME ALV 控制: 数据库中列组的字段名称 46 COL_ID ALV 控制: 列 ID 47 F4AVAILABL 字段有输入帮助吗 X.此列有搜索帮助 48 AUTO_VALUE ALV 控制: 自动复制值 49 CHECKTABLE 表名 50 VALEXI 固定值存在 51 WEB_FIELD ALV 控制: 内部表字段的字段名称 52 HREF_HNDL 自然数 热点连接的句柄 53 STYLE ALV 控制: 样式 下面有例子会介绍,比如PUSHBUTTION 54 STYLE2 ALV 控制: 样式 55 STYLE3 ALV 控制: 样式 56 STYLE4 ALV 控制: 样式 57 DRDN_HNDL 自然数 下拉的句柄 58 DRDN_FIELD ALV 控制: 内部表字段的字段名称 下拉的字段 59 NO_MERGING 字符字段长度 1 相同的值不合并 60 H_FTYPE ALV 树控制: 功能类型 (总计,平均,最大.最小, .) 61 COL_OPT 可选列优化的条目 62 NO_INIT_CH 字符字段长度 1 63 DRDN_ALIAS 字符字段长度 1 64 REF_FIELD ALV 控制: 内部表字段的参考字段名称 65 REF_TABLE ALV 控制: 内部表字段的参考表名称 66 TXT_FIELD ALV 控制: 内部表字段的字段名称 67 ROUNDFIELD ALV 控制: 带有 ROUND 说明的字段名称 68 DECIMALS_O ALV 控制: 输出小数位的编号 69 DECMLFIELD ALV 控制: 带有 DECIMALS 说明的字段名称 70 DD_OUTLEN ALV 控制: 输出字符长度 71 DECIMALS 小数点后的位数 设置小数的位数 72 COLTEXT ALV 控制: 列标题 列标题 73 SCRTEXT_L 长字段标签 74 SCRTEXT_M 中字段标签 75 SCRTEXT_S 短字段标签 76 COLDDICTXT ALV 控制: 确定 DDIC 文本参考 77 SELDDICTXT ALV 控制: 确定 DDIC 文本参考 78 TIPDDICTXT ALV 控制: 确定 DDIC 文本参考 79 EDIT ALV 控制: 准备输入 输出状态.X可输入 80 TECH_COL ALV 控制: 内部使用 81 TECH_FORM ALV 控制: 内部使用 82 TECH_COMP ALV 控制: 内部使用 83 HIER_CPOS ALV 控制: 层次列位置 84 H_COL_KEY 树控制: 列名称/项目名称 85 H_SELECT 标识是否可以选择树控制中的列 86 DD_ROLL 数据元素 (语义域) 87 DRAGDROPID ALV 控制: 拖&放处理拖放对象 88 MAC 字符字段长度 1 89 INDX_FIELD 自然数 90 INDX_CFIEL 自然数 91 INDX_QFIEL 自然数 92 INDX_IFIEL 自然数 93 INDX_ROUND 自然数 94 INDX_DECML 自然数 95 GET_STYLE 字符字段长度 1 96 MARK 字符字段长度 1 ALV_GRID介绍(2) 2.布局控制layout 布局是用来控制整个ALV的一个布局，比如ALV的标题,是否可编辑,行颜色,列颜色. 参照ALV的控制结构LVC_S_LAYO,以后的例子我将详细介绍如何设置行颜色和列颜色. 详细的结构说明 字段名 描述 Value range CWIDTH_OPT 最优化宽度 SPACE, X SMALLTITLE 小标题,如果设置了这个字段，则标题与列标题大小一样 SPACE, X GRID_TITLE 标题,在网格和工具条之间 最长70个字符 NO_HEADERS 如果被设置,列标题隐藏 SPACE, X NO_HGRIDLN 隐藏水平线 SPACE, X NO_MERGING 禁用单元格合并 SPACE, X NO_ROWMARK 如果被设置,选择列在选择模式,为D和A的时候隐藏 SPACE, X NO_TOOLBAR 隐藏工具条 SPACE, X NO_VGRIDLN 隐藏垂直线 SPACE, X SEL_MODE 选择模式 SPACE, A, B, C, D EXCP_CONDS 合计例外 SPACE, X EXCP_FNAME 字段名称带有例外编码 最长30个字符 EXCP_LED 例外作为 LED SPACE, X EXCP_ROLLN 例外文档的数据元素 SPACE, X CTAB_FNAME 带有复杂单元格颜色编码的字段名称 最长30个字符 INFO_FNAME 带有简单行彩色代码的字段名称 最长30个字符 ZEBRA 可选行颜色,如果设置了，出现了间隔色带 SPACE, X NO_TOTLINE 没有总计 SPACE, X NUMC_TOTAL 可以对NUMC字段进行合计 SPACE, X TOTALS_BEF 总计输出在第一行,小计在新的值之前 SPACE, X STYLEFNAME 设置单元格,比如PUSHBUTTON 最长30个字符 ALV_GRID介绍(3) 3.打印和排序,过滤控制 打印的参数控制请参考结构LVC_S_PRNT 排序的参数控制请参考结构LVC_S_SORT 过滤的参数控制请参考结构LVC_S_FILT 这里不再一一解释,进入中文版本,里面应该也有解释的,虽然一些不是很清楚. 五.编写简单的ALV程序. 首先这里就不详细介绍DIALOG的用法了. OO的ALV GRID必须存在于一个容器当中,就是FUNCTION的ALV,其实也是一样的,底层也是使用CL_GUI_ALV_GRID这个类的. 首先ALV的显示需要有几个先决条件. 1,字段目录,这个是必须的,如果没有这个参数,参考一个数据字典也是可以的,就是参数I_STRUCTURE_NAME. 2.存放数据的内表,最好内表的结构和字段目录是一致的,否则可能会出现一些无法预知的错误,当然你说我非要不一样,那也不一定会出现错误.我建议是最好一样的. 这2个是必须的,布局的话,应该是可以不设置的,使用默认的就可以了. 第一步:创建个SCREEN,在屏幕上创建个容器,CONTAINER.定义变量. DATA: WCL_CONTAINER TYPE REF TO CL_GUI_CUSTOM_CONTAINER, WCL_ALV TYPE REF TO CL_GUI_ALV_GRID . *- 存放字段目录的内表 DATA gt_fieldcat TYPE lvc_t_fcat . *- 布局结构 DATA gs_layout TYPE lvc_s_layo . *-声明需要显示的内表(以SFLIGHT为例) DATA BEGIN OF gt_list OCCURS 0 . INCLUDE STRUCTURE SFLIGHT . DATA END OF gt_list . 第二步: 创建ALV这个对象，它的父组件是那个容器. 在PBO中写入如下代码: PROCESS BEFORE OUTPUT . MODULE display_alv . 创建DISPLAY_ALV的MODULE后,写下如下代码: MODULE display_alv OUTPUT . PERFORM display_alv . ENDMODULE . 在FORM DISPLAY_ALV中,判断ALV实例是否存在,如果不存在,则创建: IF WCL_ALV IS INITIAL . CREATE OBJECT: WCL_CONTAINER EXPORTING CONTAINER_NAME = ALV_CON. CREATE OBJECT WCL_ALV EXPORTING I_PARENT = WCL_CONTAINER. 准备获取字段目录 PERFORM prepare_field_catalog CHANGING gt_fieldcat . 设置布局 PERFORM prepare_layout CHANGING gs_layout . 显示ALV CALL METHOD gr_alvgrid-set_table_for_first_display EXPORTING * I_BUFFER_ACTIVE = * I_CONSISTENCY_CHECK = * I_STRUCTURE_NAME = * IS_VARIANT = * I_SAVE = * I_DEFAULT = X is_layout = gs_layout * IS_PRINT = * IT_SPECIAL_GROUPS = * IT_TOOLBAR_EXCLUDING = * IT_HYPERLINK = CHANGING it_outtab = gt_list it_fieldcatalog = gt_fieldcat * IT_SORT = * IT_FILTER = EXCEPTIONS invalid_parameter_combination = 1 program_error = 2 too_many_lines = 3 OTHERS = 4 . ELSE. *-刷新ALV CALL METHOD gr_alvgrid-refresh_table_display * EXPORTING * IS_STABLE = * I_SOFT_REFRESH = EXCEPTIONS finished = 1 OTHERS = 2 . IF sy-subrc 0. *-异常处理 ENDIF. ENDIF . 方法set_table_for_first_display的参数说明 - |I_BUFFER_ACTIVE | 如果方法调用是静态的,可以设置这个标记, | | 这表示,如果每次显示ALV都是相同的字段目录. | | 既然这样,那么字段目录会被放到一个特殊的缓存里, | | 这样加速了ALV的显示 - |I_STRUCTURE_NAME | 输出数据参考的数据字典的结构名,例如SFLIGHT. | | 如果指定了这个参数,字段目录会自动生成,下面的参数 | | IT_FIELDCATALOG不需要传值. - |IS_VARIANT | 决定布局显示的变式 - |I_SAVE | 决定用户是否可以保存变式: | | X 只能保存全局变式 | | U 只能保存特定变式 | | A 都可以保存 | | SPACE 不可以保存变式 - |I_DEFAULT | 决定用户是否可以定义默认的布局: | | X 可以定义默认布局,这个参数是默认的 | | SPACE 不可以定义默认布局 - |IS_LAYOUT | 布局参数,传递布局控制的一些信息 - |IS_PRINT | 后台打印属性的参数 - |IT_SPECIAL_GROUPS | 如果在字段目录中，一些字段通过SP_GROUP被分组在一起. | | 我们就必须为这些组传递一个组的文本内表进去 - |IT_TOOLBAR_EXCLUDING| 需要隐藏的标准的按钮的内表 - |IT_HYPERLINK | 为每个句柄分配了超连接的内表, | | LVC_S_HYPE中的HREF存放了超连接的地址, | | HANDLE指定了句柄,使用这些句柄，你可以在GRID中使用超连接 - |IT_ALV_GRAPHICS | 比较复杂，没有用过,意思好象是可以在图表中显示ALV. - |IT_OUTTAB | 输出数据存放的内表,数据都是存放在这个内表里 - |IT_FIELDCATALOG | 字段目录 - |IT_SORT | 排序的标准 - |IT_FILTER | 过滤的标准 - 方法REFRESH_TABLE_DISPLAY的参数说明 - IS_STABLE 刷新的稳定性，有2个参数，一个是行，一个是列. 如果设置了相应的值,那么对应的行，或者列， 在刷新的时候,将会保持稳定，就是滚动条保持不动. - I_SOFT_REFRESH 这个参数只是在异常情况下被使用,如果设置了这个参数, 任何创建的合计,任何排序次序,任何为了显示数据而设 置的过滤都将保持不变.这个是非常有意义的. 例如:当然你没有修改数据内表里的数据而想刷新ALV, 仅仅只是改变一下布局和字段目录. - 第三步,获取要显示数据的字段目录.有两种方式. 1.手动创建 FORM prepare_field_catalog CHANGING pt_fieldcat TYPE lvc_t_fcat . DATA ls_fcat type lvc_s_fcat . ls_fcat-fieldname = CARRID . ls_fcat-inttype = C . ls_fcat-outputlen = 3 . ls_fcat-coltext = Carrier ID . ls_fcat-seltext = Carrier ID . APPEND ls_fcat to pt_fieldcat . CLEAR ls_fcat . ls_fcat-fieldname = CONNID . ls_fcat-ref_table = SFLIGHT . ls_fcat-ref_table = CONNID . ls_fcat-outputlen = 3 . ls_fcat-coltext = Connection ID . ls_fcat-seltext = Connection ID . APPEND ls_fcat to pt_fieldcat . ENDFORM . 2.半自动的创建 FORM prepare_field_catalog CHANGING pt_fieldcat TYPE lvc_t_fcat . DATA ls_fcat type lvc_s_fcat . CALL FUNCTION LVC_FIELDCATALOG_MERGE EXPORTING i_structure_name = SFLIGHT CHANGING ct_fieldcat = pt_fieldcat EXCEPTIONS inconsistent_interface = 1 program_error = 2 OTHERS = 3. IF sy-subrc 0. *-Exception handling ENDIF. LOOP AT pt_fieldcat INTO ls_fcat . CASE pt_fieldcat-fieldname . WHEN CARRID . ls_fcat-outpulen = 10 . ls_fcat-coltext = Airline Carrier ID . MODIFY pt_fieldcat FROM ls_fcat . WHEN PAYMENTSUM . ls_fcat-no_out = X . MODIFY pt_fieldcat FROM ls_fcat . ENDCASE . ENDLOOP . ENDFORM . 第四步,设置布局 FORM prepare_layout CHANGING ps_layout TYPE lvc_s_layo. ps_layout-zebra = X . ps_layout-grid_title = Flights . ps_layout-smalltitle = X . ENDFORM. prepare_layout 第五步,排除不需要的标准按钮(可选,这个是第一种方法,还有另外一种，在添加自定义的按钮的时候介绍) 在你的ALV上，如果你想排除一些你不想要的标准按钮,你可以把需要排除的按钮填入到表UI_FUNCTIONS中,然后传给 set_table_for_first_display方法的参数IT_TOOLBAR_EXCLUDING.这些按钮的功能码一般都可以通过查看类 cl_gui_alv_grid的常量属性中获取到,或者自己加个断点，在after_user_command事件中. 如果你要隐藏全部的工具条,你可以把layout中的no_toolbar设置为X. FORM exclude_tb_functions CHANGING pt_exclude TYPE ui_functions . DATA ls_exclude TYPE ui_func. ls_exclude = cl_gui_alv_grid=mc_fc_maximum . APPEND ls_exclude TO pt_exclude. ls_exclude = cl_gui_alv_grid=mc_fc_minimum . APPEND ls_exclude TO pt_exclude. ls_exclude = cl_gui_alv_grid=mc_fc_subtot . APPEND ls_exclude TO pt_exclude. ls_exclude = cl_gui_alv_grid=mc_fc_sum . APPEND ls_exclude TO pt_exclude. ls_exclude = cl_gui_alv_grid=mc_fc_average . APPEND ls_exclude TO pt_exclude. ls_exclude = cl_gui_alv_grid=mc_mb_sum . APPEND ls_exclude TO pt_exclude. ls_exclude = cl_gui_alv_grid=mc_mb_subtot . ENDFORM . 按照上面的步骤,一个ALV的DEMO基本可以创建了.下面我们将讲述一些功能. 功能一:在第一次显示以后,修改字段目录和布局. 在运行的时候,很有可能需要在显示之后,需要设置一个新的布局或者字段目录.有下面这些方法去实现. 字段目录: get_frontend_fieldcatalog set_frontend_fieldcatalog 布局: get_frontend