SAP ABAP 开发实战REUSE_ALV_GRID_DISPLAY_LVC 详解 —— 从入门到精通一、引言在 SAP ABAP 开发中几乎每一个报表或数据展示功能都离不开 ALVABAP List Viewer。REUSE_ALV_GRID_DISPLAY_LVC是自 SAP NetWeaver 7.0 之后引入的ALV Grid 显示函数它是对早期REUSE_ALV_GRID_DISPLAY的改进版本采用了LVCList Viewer Control架构提供了更丰富的交互功能和更强的可扩展性。本文将系统地讲解REUSE_ALV_GRID_DISPLAY_LVC的作用、完整用法、核心参数说明、注意事项以及一个完整的实战示例。文章适合 ABAP 初学者至中级开发人员帮助你快速掌握这一核心工具。二、作用为什么使用 REUSE_ALV_GRID_DISPLAY_LVC简单地说它的作用是将一个内表Internal Table以美观、交互式表格的形式显示在 SAP GUI 上。相比普通报表它提供了以下标准功能列排序、过滤、合计用户可直接在界面上操作。列宽调整、列隐藏灵活定制显示。导出到 Excel / 打印通过内置菜单实现。行选择单行/多行方便后续操作。事件处理可以捕获用户点击、双击、修改等操作。相比其前身REUSE_ALV_GRID_DISPLAYLVC 版本的优势在于更好的性能通过对象架构优化支持更丰富的布局控制如合计、小计、页眉、脚注无需显式调用CALL FUNCTION后的SET PF-STATUS菜单栏默认可用更容易集成到自定义容器中三、使用方法完整参数解析REUSE_ALV_GRID_DISPLAY_LVC位于函数组SLVC可通过SE37查看其完整签名。最关键参数如下3.1 必需参数参数名类型说明I_STRUCTURE_NAMEC内表行结构的字典名称如BAPIMATNR用于自动生成列标题和数据类型。I_GRID_TITLEC表格标题显示在 ALV 左上角。IT_OUTTABTABLE要显示的内表必须是STANDARD TABLE类型。IT_FIELDCATALOGLVC_T_FCAT字段目录定义哪些列显示、标题、宽度、对齐等。若不提供则根据数据字典生成。IT_SORTLVC_T_SORT排序定义初始排序。IT_FILTERLVC_T_FILT过滤定义初始过滤条件。IS_LAYOUTLVC_S_LAYO布局设置如网格线、列宽优化、行选择模式等。IS_PRINTLVC_S_PRNT打印设置。IS_VARIANTDISVARIANT变式管理可保存用户布局。I_SAVEC是否允许保存变式‘A’用户可保存或 ‘X’仅系统管理等。I_CALLBACK_PROGRAMC事件处理程序所在的程序名。I_CALLBACK_PF_STATUS_SETC设置自定义菜单状态的例程名FORM name。I_CALLBACK_USER_COMMANDC用户菜单命令处理例程名。I_CALLBACK_TOP_OF_PAGEC顶部标题显示例程名。I_CALLBACK_HTML_TOP_OF_PAGEC顶部 HTML 标题例程名。EXPORTINGE_EXIT_GRID可选的返回 ALV 控件实例用于后续事件绑定。3.2 常用参数详解1IT_FIELDCATALOG—— 字段目录类型LVC_T_FCAT内表行类型LVC_S_FCAT。常用字段字段名说明FIELDNAME内表字段名必须对应IT_OUTTAB的组件名TABNAME表名如果是来自数据字典的结构可填REF_FIELD参考字段用于货币、单位等REF_TABLE参考表COLTEXT列标题显示在 ALV 表头SCRTEXT_L长文本标题若COLTEXT为空使用该字段SCRTEXT_M中文本标题若SCRTEXT_L为空使用该字段SCRTEXT_S短文本标题KEY是否是关键列加粗显示LOWERCASE是否区分大小写HOTSPOT是否允许单击触发事件JUST对齐方式L左对齐C居中R右对齐DO_SUM是否对该列进行合计NO_ZERO不显示零值EDIT是否可编辑DEFAULT_ICON是否显示图标用于状态列2IS_LAYOUT—— 布局设置类型LVC_S_LAYO。常用字段字段名说明CWIDTH_OPT是否根据内容优化列宽GRID_TITLE表格标题与参数I_GRID_TITLE作用相同可覆盖SELMODE选择模式A行选择单选B行选择多选C单元格选择D列选择NO_MERGING是否禁止合并相同单元格EXCEL_EXIT导出 Excel 时的行为标志CTAB_FNAME如果希望根据行数据动态改变单元格颜色指定该字段名类型为C存储颜色代码STYLEFNAME指定一个字段用于定义单元格样式编辑、颜色、链接等SMALL_TITLE是否使用小标题显示NO_COLHEAD是否隐藏列标题NO_ROWMARK是否隐藏行选择列通常选第一列NO_TOTALLINE是否隐藏合计行3事件回调通过I_CALLBACK_PROGRAM指定程序名然后定义以下 FORMSPF_STATUS_SET用于设置工具栏菜单可添加自定义按钮。FORM user_pf_status_set USING rt_extab TYPE slis_t_extab. SET PF-STATUS ZALV_STATUS. ENDFORM.USER_COMMAND处理菜单命令包括自定义按钮和标准功能。FORM user_command USING r_ucomm TYPE sy-ucomm rs_selfield TYPE slis_selfield. CASE r_ucomm. WHEN IC1. 双击或热点点击 ... ENDCASE. ENDFORM.TOP_OF_PAGE显示页眉信息如报表标题、日期。FORM top_of_page. CALL FUNCTION REUSE_ALV_COMMENTARY_WRITE EXPORTING it_list_commentary lt_header. ENDFORM.四、注意事项避坑指南内表类型必须匹配IT_OUTTAB必须是STANDARD TABLE不能是SORTED TABLE或HASHED TABLE。字段名大小写敏感在IT_FIELDCATALOG中定义FIELDNAME时必须与IT_OUTTAB的组件名完全一致通常大写。不要使用REFRESH刷新如果要更新显示数据应使用 ALV 实例的方法refresh_table_display而非重新调用函数。事务控制REUSE_ALV_GRID_DISPLAY_LVC会在内部调用COMMIT WORK因此不要在调用前用COMMIT或ROLLBACK打断事务否则可能导致数据不一致。性能优化当数据量超过 10 万行时建议使用I_STRUCTURE_NAME 自动字段目录或手动限制显示的列。也可以在IS_LAYOUT中设置CWIDTH_OPT来优化列宽。事件处理中避免COMMIT在USER_COMMAND等回调中不要执行COMMIT WORK否则可能导致 ALV 内部状态异常出现DUMP。字段目录必须保持同步如果内表结构更改务必同步更新字段目录否则列可能显示错误或崩溃。ALV 实例引用如果想获取 ALV 实例例如用于动态刷新需要声明TYPE REF TO CL_GUI_ALV_GRID并通过E_EXIT_GRID导出参数获取。五、完整实战示例显示物料库存表以下示例展示了一个完整的 ALV 报表包含自定义字段目录布局设置行选择、列宽优化自定义工具栏添加“刷新”按钮双击事件处理显示物料详情顶部页眉5.1 数据定义与获取REPORT Z_DEMO_ALV_LVC. TABLES: mara, makt, mard. TYPES: BEGIN OF ty_material, matnr TYPE mara-matnr, 物料 maktx TYPE makt-maktx, 描述 werks TYPE mard-werks, 工厂 lgort TYPE mard-lgort, 库存地点 labst TYPE mard-labst, 非限制库存 einfa TYPE mard-einfa, 在途库存 insme TYPE mard-insme, 质检库存 END OF ty_material. DATA: gt_material TYPE TABLE OF ty_material, gs_material TYPE ty_material. DATA: gt_fieldcat TYPE lvc_t_fcat, gs_fieldcat TYPE lvc_s_fcat, gs_layout TYPE lvc_s_layo. DATA: go_grid TYPE REF TO cl_gui_alv_grid. 用于刷新 DATA: gv_repid TYPE sy-repid VALUE Z_DEMO_ALV_LVC. START-OF-SELECTION. PERFORM get_data. PERFORM build_fieldcat. PERFORM build_layout. PERFORM display_alv. *--------------------------------------------------------------------* * FORM get_data *--------------------------------------------------------------------* FORM get_data. SELECT a~matnr, b~maktx, a~werks, a~lgort, a~labst, a~einfa, a~insme INTO TABLE gt_material FROM mard AS a LEFT JOIN makt AS b ON a~matnr b~matnr AND b~spras sy-langu. ENDFORM.5.2 构建字段目录*--------------------------------------------------------------------* * FORM build_fieldcat *--------------------------------------------------------------------* FORM build_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname MATNR. gs_fieldcat-coltext 物料. gs_fieldcat-key X. APPEND gs_fieldcat TO gt_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname MAKTX. gs_fieldcat-coltext 物料描述. gs_fieldcat-outputlen 20. APPEND gs_fieldcat TO gt_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname WERKS. gs_fieldcat-coltext 工厂. APPEND gs_fieldcat TO gt_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname LGORT. gs_fieldcat-coltext 库存地点. APPEND gs_fieldcat TO gt_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname LABST. gs_fieldcat-coltext 非限制库存. gs_fieldcat-do_sum X. 合计 gs_fieldcat-just R. 右对齐 APPEND gs_fieldcat TO gt_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname EINFA. gs_fieldcat-coltext 在途库存. gs_fieldcat-do_sum X. APPEND gs_fieldcat TO gt_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname INSME. gs_fieldcat-coltext 质检库存. gs_fieldcat-do_sum X. APPEND gs_fieldcat TO gt_fieldcat. ENDFORM.5.3 构建布局*--------------------------------------------------------------------* * FORM build_layout *--------------------------------------------------------------------* FORM build_layout. gs_layout-cwidth_opt X. gs_layout-selmode A. 单行选择 gs_layout-grid_title 物料库存查询. gs_layout-no_merging X. ENDFORM.5.4 显示 ALV 并定义回调*--------------------------------------------------------------------* * FORM display_alv *--------------------------------------------------------------------* FORM display_alv. CALL FUNCTION REUSE_ALV_GRID_DISPLAY_LVC EXPORTING i_structure_name TY_MATERIAL 也可以用 MARD 但需映射 i_grid_title 物料库存清单 it_fieldcat_lvc gt_fieldcat is_layout_lvc gs_layout i_callback_program gv_repid i_callback_pf_status_set PF_STATUS_SET i_callback_user_command USER_COMMAND i_callback_top_of_page TOP_OF_PAGE IMPORTING e_exit_grid go_grid TABLES t_outtab gt_material EXCEPTIONS program_error 1 OTHERS 2. IF sy-subrc 0. MESSAGE ALV 显示失败 TYPE E. ENDIF. ENDFORM.5.5 实现回调 FORM5.5.1 自定义工具栏添加刷新按钮*--------------------------------------------------------------------* * FORM pf_status_set *--------------------------------------------------------------------* FORM pf_status_set USING rt_extab TYPE slis_t_extab. SET PF-STATUS ZALV_STANDARD EXCLUDING rt_extab. 需要在 SE41 中创建状态 ZALV_STANDARD添加一个按钮 REFR (刷新) 或保留标准状态不做修改。 ENDFORM.5.5.2 用户命令处理刷新、双击*--------------------------------------------------------------------* * FORM user_command *--------------------------------------------------------------------* FORM user_command USING r_ucomm TYPE sy-ucomm rs_selfield TYPE slis_selfield. CASE r_ucomm. WHEN REFR. 自定义刷新按钮 PERFORM refresh_alv. WHEN IC1. 双击或热点点击 PERFORM handle_double_click USING rs_selfield. ENDCASE. ENDFORM. *--------------------------------------------------------------------* * FORM refresh_alv *--------------------------------------------------------------------* FORM refresh_alv. 重新获取数据此处仅演示实际需要重新查询 PERFORM get_data. 刷新 ALV 显示 IF go_grid IS BOUND. CALL METHOD go_grid-refresh_table_display EXPORTING is_stable VALUE #( row X col X ) EXCEPTIONS finished 1 OTHERS 2. IF sy-subrc 0. MESSAGE 刷新失败 TYPE S. ENDIF. ENDIF. ENDFORM. *--------------------------------------------------------------------* * FORM handle_double_click *--------------------------------------------------------------------* FORM handle_double_click USING rs_selfield TYPE slis_selfield. DATA: lv_matnr TYPE mara-matnr. READ TABLE gt_material INTO gs_material INDEX rs_selfield-tabindex. IF sy-subrc 0. lv_matnr gs_material-matnr. 显示物料详情例如跳转到 MM03 CALL TRANSACTION MM03 AND SKIP FIRST SCREEN WITH RMMG1-MATNR lv_matnr. ENDIF. ENDFORM.5.5.3 顶部页眉显示*--------------------------------------------------------------------* * FORM top_of_page *--------------------------------------------------------------------* FORM top_of_page. DATA: lt_header TYPE slis_t_listheader, ls_header TYPE slis_listheader. 第一行报表标题 ls_header-typ H. ls_header-info 物料库存查询报表. APPEND ls_header TO lt_header. 第二行日期 CLEAR ls_header. ls_header-typ S. ls_header-key 日期: . ls_header-info sy-datum. APPEND ls_header TO lt_header. 第三行用户 CLEAR ls_header. ls_header-typ S. ls_header-key 用户: . ls_header-info sy-uname. APPEND ls_header TO lt_header. CALL FUNCTION REUSE_ALV_COMMENTARY_WRITE EXPORTING it_list_commentary lt_header. ENDFORM.5.6 完整运行效果执行该报表后ALV Grid 将显示物料库存表带有合计行支持双击物料编号跳转到 MM03工具栏包含标准导出、打印功能并自定义了一个刷新按钮。六、高级技巧与拓展6.1 动态修改字段目录在调用函数前可以动态添加或移除列。例如根据用户权限隐藏特定列READ TABLE gt_fieldcat WITH KEY fieldname EINFA INTO DATA(ls_fcat). IF sy-subrc 0 AND NOT auth_check_ok. ls_fcat-no_out X. 隐藏该列 MODIFY gt_fieldcat FROM ls_fcat INDEX sy-tabix. ENDIF.6.2 设置单元格颜色首先在内表中增加一个颜色字段类型C或LVC_S_COLO然后在布局中指定STYLEFNAME为这个字段名。之后在填充数据时为特定行设置颜色值。6.3 实现可编辑单元格在字段目录中设置EDIT X并在布局中指定EDIT X。为了保存修改后的值需要在USER_COMMAND中捕获EDT或使用DATA_CHANGED事件较为复杂需使用 ALV 实例注册事件。七、总结REUSE_ALV_GRID_DISPLAY_LVC是 SAP ABAP 开发中最实用、最常用的显示工具之一。它提供了标准化的数据展示和交互能力大大减少了开发工作量。掌握它的参数、事件回调、布局设置是每一个 ABAP 开发人员的基本功。通过本文的学习你应该能够明白何时使用 LVC 版本的 ALV95% 的场景推荐使用熟练配置字段目录和布局实现自定义事件双击、刷新、按钮处理 ALV 刷新和内存管理后续进阶方向包括使用CL_SALV_TABLE更现代、更轻量或CL_GUI_ALV_GRID类直接创建更灵活但在大多数业务报表中REUSE_ALV_GRID_DISPLAY_LVC仍然是最快、最稳妥的选择。✏️ 博客作者[爱喝水的鱼丶] 发布日期2026年06月08日 标签#SAP #ABAP #ALV #REUSE_ALV_GRID_DISPLAY_LVC #开发技巧
SAP-ABAP：SAP ABAP 开发实战：REUSE_ALV_GRID_DISPLAY_LVC 详解 —— 从入门到精通
SAP ABAP 开发实战REUSE_ALV_GRID_DISPLAY_LVC 详解 —— 从入门到精通一、引言在 SAP ABAP 开发中几乎每一个报表或数据展示功能都离不开 ALVABAP List Viewer。REUSE_ALV_GRID_DISPLAY_LVC是自 SAP NetWeaver 7.0 之后引入的ALV Grid 显示函数它是对早期REUSE_ALV_GRID_DISPLAY的改进版本采用了LVCList Viewer Control架构提供了更丰富的交互功能和更强的可扩展性。本文将系统地讲解REUSE_ALV_GRID_DISPLAY_LVC的作用、完整用法、核心参数说明、注意事项以及一个完整的实战示例。文章适合 ABAP 初学者至中级开发人员帮助你快速掌握这一核心工具。二、作用为什么使用 REUSE_ALV_GRID_DISPLAY_LVC简单地说它的作用是将一个内表Internal Table以美观、交互式表格的形式显示在 SAP GUI 上。相比普通报表它提供了以下标准功能列排序、过滤、合计用户可直接在界面上操作。列宽调整、列隐藏灵活定制显示。导出到 Excel / 打印通过内置菜单实现。行选择单行/多行方便后续操作。事件处理可以捕获用户点击、双击、修改等操作。相比其前身REUSE_ALV_GRID_DISPLAYLVC 版本的优势在于更好的性能通过对象架构优化支持更丰富的布局控制如合计、小计、页眉、脚注无需显式调用CALL FUNCTION后的SET PF-STATUS菜单栏默认可用更容易集成到自定义容器中三、使用方法完整参数解析REUSE_ALV_GRID_DISPLAY_LVC位于函数组SLVC可通过SE37查看其完整签名。最关键参数如下3.1 必需参数参数名类型说明I_STRUCTURE_NAMEC内表行结构的字典名称如BAPIMATNR用于自动生成列标题和数据类型。I_GRID_TITLEC表格标题显示在 ALV 左上角。IT_OUTTABTABLE要显示的内表必须是STANDARD TABLE类型。IT_FIELDCATALOGLVC_T_FCAT字段目录定义哪些列显示、标题、宽度、对齐等。若不提供则根据数据字典生成。IT_SORTLVC_T_SORT排序定义初始排序。IT_FILTERLVC_T_FILT过滤定义初始过滤条件。IS_LAYOUTLVC_S_LAYO布局设置如网格线、列宽优化、行选择模式等。IS_PRINTLVC_S_PRNT打印设置。IS_VARIANTDISVARIANT变式管理可保存用户布局。I_SAVEC是否允许保存变式‘A’用户可保存或 ‘X’仅系统管理等。I_CALLBACK_PROGRAMC事件处理程序所在的程序名。I_CALLBACK_PF_STATUS_SETC设置自定义菜单状态的例程名FORM name。I_CALLBACK_USER_COMMANDC用户菜单命令处理例程名。I_CALLBACK_TOP_OF_PAGEC顶部标题显示例程名。I_CALLBACK_HTML_TOP_OF_PAGEC顶部 HTML 标题例程名。EXPORTINGE_EXIT_GRID可选的返回 ALV 控件实例用于后续事件绑定。3.2 常用参数详解1IT_FIELDCATALOG—— 字段目录类型LVC_T_FCAT内表行类型LVC_S_FCAT。常用字段字段名说明FIELDNAME内表字段名必须对应IT_OUTTAB的组件名TABNAME表名如果是来自数据字典的结构可填REF_FIELD参考字段用于货币、单位等REF_TABLE参考表COLTEXT列标题显示在 ALV 表头SCRTEXT_L长文本标题若COLTEXT为空使用该字段SCRTEXT_M中文本标题若SCRTEXT_L为空使用该字段SCRTEXT_S短文本标题KEY是否是关键列加粗显示LOWERCASE是否区分大小写HOTSPOT是否允许单击触发事件JUST对齐方式L左对齐C居中R右对齐DO_SUM是否对该列进行合计NO_ZERO不显示零值EDIT是否可编辑DEFAULT_ICON是否显示图标用于状态列2IS_LAYOUT—— 布局设置类型LVC_S_LAYO。常用字段字段名说明CWIDTH_OPT是否根据内容优化列宽GRID_TITLE表格标题与参数I_GRID_TITLE作用相同可覆盖SELMODE选择模式A行选择单选B行选择多选C单元格选择D列选择NO_MERGING是否禁止合并相同单元格EXCEL_EXIT导出 Excel 时的行为标志CTAB_FNAME如果希望根据行数据动态改变单元格颜色指定该字段名类型为C存储颜色代码STYLEFNAME指定一个字段用于定义单元格样式编辑、颜色、链接等SMALL_TITLE是否使用小标题显示NO_COLHEAD是否隐藏列标题NO_ROWMARK是否隐藏行选择列通常选第一列NO_TOTALLINE是否隐藏合计行3事件回调通过I_CALLBACK_PROGRAM指定程序名然后定义以下 FORMSPF_STATUS_SET用于设置工具栏菜单可添加自定义按钮。FORM user_pf_status_set USING rt_extab TYPE slis_t_extab. SET PF-STATUS ZALV_STATUS. ENDFORM.USER_COMMAND处理菜单命令包括自定义按钮和标准功能。FORM user_command USING r_ucomm TYPE sy-ucomm rs_selfield TYPE slis_selfield. CASE r_ucomm. WHEN IC1. 双击或热点点击 ... ENDCASE. ENDFORM.TOP_OF_PAGE显示页眉信息如报表标题、日期。FORM top_of_page. CALL FUNCTION REUSE_ALV_COMMENTARY_WRITE EXPORTING it_list_commentary lt_header. ENDFORM.四、注意事项避坑指南内表类型必须匹配IT_OUTTAB必须是STANDARD TABLE不能是SORTED TABLE或HASHED TABLE。字段名大小写敏感在IT_FIELDCATALOG中定义FIELDNAME时必须与IT_OUTTAB的组件名完全一致通常大写。不要使用REFRESH刷新如果要更新显示数据应使用 ALV 实例的方法refresh_table_display而非重新调用函数。事务控制REUSE_ALV_GRID_DISPLAY_LVC会在内部调用COMMIT WORK因此不要在调用前用COMMIT或ROLLBACK打断事务否则可能导致数据不一致。性能优化当数据量超过 10 万行时建议使用I_STRUCTURE_NAME 自动字段目录或手动限制显示的列。也可以在IS_LAYOUT中设置CWIDTH_OPT来优化列宽。事件处理中避免COMMIT在USER_COMMAND等回调中不要执行COMMIT WORK否则可能导致 ALV 内部状态异常出现DUMP。字段目录必须保持同步如果内表结构更改务必同步更新字段目录否则列可能显示错误或崩溃。ALV 实例引用如果想获取 ALV 实例例如用于动态刷新需要声明TYPE REF TO CL_GUI_ALV_GRID并通过E_EXIT_GRID导出参数获取。五、完整实战示例显示物料库存表以下示例展示了一个完整的 ALV 报表包含自定义字段目录布局设置行选择、列宽优化自定义工具栏添加“刷新”按钮双击事件处理显示物料详情顶部页眉5.1 数据定义与获取REPORT Z_DEMO_ALV_LVC. TABLES: mara, makt, mard. TYPES: BEGIN OF ty_material, matnr TYPE mara-matnr, 物料 maktx TYPE makt-maktx, 描述 werks TYPE mard-werks, 工厂 lgort TYPE mard-lgort, 库存地点 labst TYPE mard-labst, 非限制库存 einfa TYPE mard-einfa, 在途库存 insme TYPE mard-insme, 质检库存 END OF ty_material. DATA: gt_material TYPE TABLE OF ty_material, gs_material TYPE ty_material. DATA: gt_fieldcat TYPE lvc_t_fcat, gs_fieldcat TYPE lvc_s_fcat, gs_layout TYPE lvc_s_layo. DATA: go_grid TYPE REF TO cl_gui_alv_grid. 用于刷新 DATA: gv_repid TYPE sy-repid VALUE Z_DEMO_ALV_LVC. START-OF-SELECTION. PERFORM get_data. PERFORM build_fieldcat. PERFORM build_layout. PERFORM display_alv. *--------------------------------------------------------------------* * FORM get_data *--------------------------------------------------------------------* FORM get_data. SELECT a~matnr, b~maktx, a~werks, a~lgort, a~labst, a~einfa, a~insme INTO TABLE gt_material FROM mard AS a LEFT JOIN makt AS b ON a~matnr b~matnr AND b~spras sy-langu. ENDFORM.5.2 构建字段目录*--------------------------------------------------------------------* * FORM build_fieldcat *--------------------------------------------------------------------* FORM build_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname MATNR. gs_fieldcat-coltext 物料. gs_fieldcat-key X. APPEND gs_fieldcat TO gt_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname MAKTX. gs_fieldcat-coltext 物料描述. gs_fieldcat-outputlen 20. APPEND gs_fieldcat TO gt_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname WERKS. gs_fieldcat-coltext 工厂. APPEND gs_fieldcat TO gt_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname LGORT. gs_fieldcat-coltext 库存地点. APPEND gs_fieldcat TO gt_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname LABST. gs_fieldcat-coltext 非限制库存. gs_fieldcat-do_sum X. 合计 gs_fieldcat-just R. 右对齐 APPEND gs_fieldcat TO gt_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname EINFA. gs_fieldcat-coltext 在途库存. gs_fieldcat-do_sum X. APPEND gs_fieldcat TO gt_fieldcat. CLEAR gs_fieldcat. gs_fieldcat-fieldname INSME. gs_fieldcat-coltext 质检库存. gs_fieldcat-do_sum X. APPEND gs_fieldcat TO gt_fieldcat. ENDFORM.5.3 构建布局*--------------------------------------------------------------------* * FORM build_layout *--------------------------------------------------------------------* FORM build_layout. gs_layout-cwidth_opt X. gs_layout-selmode A. 单行选择 gs_layout-grid_title 物料库存查询. gs_layout-no_merging X. ENDFORM.5.4 显示 ALV 并定义回调*--------------------------------------------------------------------* * FORM display_alv *--------------------------------------------------------------------* FORM display_alv. CALL FUNCTION REUSE_ALV_GRID_DISPLAY_LVC EXPORTING i_structure_name TY_MATERIAL 也可以用 MARD 但需映射 i_grid_title 物料库存清单 it_fieldcat_lvc gt_fieldcat is_layout_lvc gs_layout i_callback_program gv_repid i_callback_pf_status_set PF_STATUS_SET i_callback_user_command USER_COMMAND i_callback_top_of_page TOP_OF_PAGE IMPORTING e_exit_grid go_grid TABLES t_outtab gt_material EXCEPTIONS program_error 1 OTHERS 2. IF sy-subrc 0. MESSAGE ALV 显示失败 TYPE E. ENDIF. ENDFORM.5.5 实现回调 FORM5.5.1 自定义工具栏添加刷新按钮*--------------------------------------------------------------------* * FORM pf_status_set *--------------------------------------------------------------------* FORM pf_status_set USING rt_extab TYPE slis_t_extab. SET PF-STATUS ZALV_STANDARD EXCLUDING rt_extab. 需要在 SE41 中创建状态 ZALV_STANDARD添加一个按钮 REFR (刷新) 或保留标准状态不做修改。 ENDFORM.5.5.2 用户命令处理刷新、双击*--------------------------------------------------------------------* * FORM user_command *--------------------------------------------------------------------* FORM user_command USING r_ucomm TYPE sy-ucomm rs_selfield TYPE slis_selfield. CASE r_ucomm. WHEN REFR. 自定义刷新按钮 PERFORM refresh_alv. WHEN IC1. 双击或热点点击 PERFORM handle_double_click USING rs_selfield. ENDCASE. ENDFORM. *--------------------------------------------------------------------* * FORM refresh_alv *--------------------------------------------------------------------* FORM refresh_alv. 重新获取数据此处仅演示实际需要重新查询 PERFORM get_data. 刷新 ALV 显示 IF go_grid IS BOUND. CALL METHOD go_grid-refresh_table_display EXPORTING is_stable VALUE #( row X col X ) EXCEPTIONS finished 1 OTHERS 2. IF sy-subrc 0. MESSAGE 刷新失败 TYPE S. ENDIF. ENDIF. ENDFORM. *--------------------------------------------------------------------* * FORM handle_double_click *--------------------------------------------------------------------* FORM handle_double_click USING rs_selfield TYPE slis_selfield. DATA: lv_matnr TYPE mara-matnr. READ TABLE gt_material INTO gs_material INDEX rs_selfield-tabindex. IF sy-subrc 0. lv_matnr gs_material-matnr. 显示物料详情例如跳转到 MM03 CALL TRANSACTION MM03 AND SKIP FIRST SCREEN WITH RMMG1-MATNR lv_matnr. ENDIF. ENDFORM.5.5.3 顶部页眉显示*--------------------------------------------------------------------* * FORM top_of_page *--------------------------------------------------------------------* FORM top_of_page. DATA: lt_header TYPE slis_t_listheader, ls_header TYPE slis_listheader. 第一行报表标题 ls_header-typ H. ls_header-info 物料库存查询报表. APPEND ls_header TO lt_header. 第二行日期 CLEAR ls_header. ls_header-typ S. ls_header-key 日期: . ls_header-info sy-datum. APPEND ls_header TO lt_header. 第三行用户 CLEAR ls_header. ls_header-typ S. ls_header-key 用户: . ls_header-info sy-uname. APPEND ls_header TO lt_header. CALL FUNCTION REUSE_ALV_COMMENTARY_WRITE EXPORTING it_list_commentary lt_header. ENDFORM.5.6 完整运行效果执行该报表后ALV Grid 将显示物料库存表带有合计行支持双击物料编号跳转到 MM03工具栏包含标准导出、打印功能并自定义了一个刷新按钮。六、高级技巧与拓展6.1 动态修改字段目录在调用函数前可以动态添加或移除列。例如根据用户权限隐藏特定列READ TABLE gt_fieldcat WITH KEY fieldname EINFA INTO DATA(ls_fcat). IF sy-subrc 0 AND NOT auth_check_ok. ls_fcat-no_out X. 隐藏该列 MODIFY gt_fieldcat FROM ls_fcat INDEX sy-tabix. ENDIF.6.2 设置单元格颜色首先在内表中增加一个颜色字段类型C或LVC_S_COLO然后在布局中指定STYLEFNAME为这个字段名。之后在填充数据时为特定行设置颜色值。6.3 实现可编辑单元格在字段目录中设置EDIT X并在布局中指定EDIT X。为了保存修改后的值需要在USER_COMMAND中捕获EDT或使用DATA_CHANGED事件较为复杂需使用 ALV 实例注册事件。七、总结REUSE_ALV_GRID_DISPLAY_LVC是 SAP ABAP 开发中最实用、最常用的显示工具之一。它提供了标准化的数据展示和交互能力大大减少了开发工作量。掌握它的参数、事件回调、布局设置是每一个 ABAP 开发人员的基本功。通过本文的学习你应该能够明白何时使用 LVC 版本的 ALV95% 的场景推荐使用熟练配置字段目录和布局实现自定义事件双击、刷新、按钮处理 ALV 刷新和内存管理后续进阶方向包括使用CL_SALV_TABLE更现代、更轻量或CL_GUI_ALV_GRID类直接创建更灵活但在大多数业务报表中REUSE_ALV_GRID_DISPLAY_LVC仍然是最快、最稳妥的选择。✏️ 博客作者[爱喝水的鱼丶] 发布日期2026年06月08日 标签#SAP #ABAP #ALV #REUSE_ALV_GRID_DISPLAY_LVC #开发技巧
