前面我们讲过，ALV Grid 函数的输出有两个：REUSE_ALV_GRID_DISPLAY 和 REUSE_ALV_GRID_DISPLAY_LVC

两者的操作大同小异，只是后者能更好的和ALV容器结合使用，前后则不能；而在输入参数属性的结构上也有些差异。

本篇文章主要讲解下ALV函数中输入参数的一些应用。

首先了解下ALV函数输入参数的作用(粗体为常用参数):

I_INTERFACE_CHECK: 检查接口一致性

I_BYPASSING_BUFFER: 是否使用缓存

I_BUFFER_ACTIVE：是否激活缓存，如果每次显示ALV都是相同的字段目录，则该字段目录会被放到一特殊的缓存里，加快显示速度。

I_CALLBACK_PROGRAM：调用ALV的程序名称

I_CALLBACK_PF_STATUS_SET：ALV工具栏Subroutine（子程序）

I_CALLBACK_USER_COMMAND：ALV User Command Subroutine（子程序），实现对应菜单项及相应事件功能

I_CALLBACK_TOP_OF_PAGE：ALV抬头内容信息

I_CALLBACK_HTML_TOP_OF_PAGE：ALV HTML格式抬头内容信息

I_CALLBACK_HTML_END_OF_LIST：ALV HTML格式页脚内容信息

I_STRUCTURE_NAME：为输出表数据结构的命名，指定了这个参数，域目录将会自动生成

I_BACKGROUND_ID：ALV背景图片Object ID

I_GRID_TITLE：ALV 标题

I_GRID_SETTINGS：GRID信息

IS_LAYOUT / IS_LAYOUT_LVC：ALV输出布局样式

IT_FIELDCAT / IT_FIELDCAT_LVC：设定显示的项目名称及输出设定

IT_EXCLUDING：隐藏设置的ALV工具栏

IT_SPECIAL_GROUPS / IT_SPECIAL_GROUPS_LVC：若内表中一些字段通过SP_GROUP被分组在一起，必须为这些组传递组文本内表

IT_SORT / IT_SORT_LVC：ALV排序设置

IT_FILTER / IT_FILTER_LVC：ALV过滤设置

IS_SEL_HIDE：替换或修改屏幕中select-option的值

I_DEFAULT：用户是否可以定义默认的布局，’X'-可以定义默认布局，Space-不可以定义默认布局 （默认：X）

I_SAVE：保存表格布局,’X'-只能保存全局变式；’U'-只能保存特定变式；’A'-都可以保存；Space-不能保存变式 （默认：space）

IS_VARIANT：表格布局变式

IT_EVENTS：设置事件, 类型为slis_t_event的内表（name：事件名称，form：事件的FORM）

IT_EVENT_EXIT：设置回调的方法的执行行为，表明用户所写的代码是在执行标准执行之前还是之后

IS_PRINT：后台打印的相关参数

I_SCREEN_START_COLUMN：以对话框形式显示的开始列

I_SCREEN_START_LINE：以对话框形式显示的开始行

I_SCREEN_END_COLUMN：以对话框形式显示的结束列

I_SCREEN_END_LINE：以对话框形式显示的结束行

I_HTML_HEIGHT_TOP：HTML抬头的高度

I_HTML_HEIGHT_END：HTML页脚的高度

IT_ALV_GRAPHICS：是否可以在图表中显示ALV

IT_HYPERLINK：使用超链接

下面详细介绍下常用的输入参数：

1. I_CALLBACK_PROGRAM 参数属性

定义调用程序名称，一般为当前程序sy-repid

2. I_CALLBACK_PF_STATUS_SET 参数

定义ALV屏幕菜单，此参数允许报表展现用户自定义的屏幕菜单，

参数类型为：SLIS_FORMNAME，指定自定义按钮的子FORM，该子FORM不显式的调用；

如：

Form中的定义为：

2.1). 没有自定义按钮时候，该参数可以不要，这时会显示ALV标准的按钮；

当然这些按钮可以部分隐藏（见：IT_EXCLUDING 参数属性）；

2.2). 当我们使用自定义按钮后，ALV自带的标准按钮，则会失效，这时需要将一些必要的按钮在工具条补上；

2.3). 其中 “分隔符” 的插入方法为：在需要插入分隔符的方框内,选择菜单：Edit->Insert-> Separator line 即可插入分隔符；

2.4). 下面是ALV中的标准工具的名称、代码、图标名称、快捷键：

2.5). 一般情况下，可以快速拷贝标准程序的菜单栏，再进行修改、筛选；

操作步骤如下：

01). 进入 SE80，打开 Repository Information System;

02). 打开路径: Repository Information System-> Program Library->Program SubObjects->GUI Status;

03). 在右边屏幕的程序名称（Program Name）输入框内输入标准程序名称：SAPLKKBL，然后执行；

04). 在输出的列表中，找到 STANDARD 或 STANDARD_FULLSCREEN:

05).双击进入菜单编辑后，拷贝到需要用到的程序中即可。

3. I_CALLBACK_USER_COMMAND 参数属性

响应菜单项及其相应事件，捕捉点击相应的按钮或双击等操作的 Function Code(FCode)；

参数类型为：SLIS_FORMNAME，与 I_CALLBACK_PF_STATUS_SET 参数一样，为定义的子 FORM，不显式调用；

如：

Form 的定义为：

其中，标准按钮的FCode，可以通过类 CL_GUI_ALV_GRID 中的 Attributes 查看；

操作步骤：

01). 进入事务码SE24，输入类名称：CL_GUI_ALV_GRID，点击显示( Display )；

02). 切换到 Attributes 标签，找到自己需要的”属性”和”初始值”，这个初始值就是我们要找的标准按钮的FCODE；

3.1 热点链接

热点链接，即 Fieldcat中 的 hotspot 属性；

设置之后，当用户点击带有热点的字段时，就会触发 Subroutine（FRM_USER_COMMAND）中的动作；

对于热点链接，所对应的FCode为 “&IC1“；

示例如下：

3.2 显示明细

在使用 REUSE_ALV_GRID_DISPLAY_LVC 时，会发现使用 REUSE_ALV_GRID_DISPLAY 时的双击显示行明细功能没有了；

这是SAP标准程序决定的，REUSE_ALV_GRID_DISPLAY_LVC 已经取消了双击显示行明细功能。

当然，也可以点击工具栏中的放大镜按钮，直接查看明细；

如若想要实现双击显示明细，则可以直接执行FCode：&ETA调用标准功能：

3.3 调用其他事务

其中，”LIB“是指：参数ID（PARAMETER ID）。

查找方法：

01). 用一个事务码进入屏幕界面，在输入框内按 F1；

02). 在弹出来的界面中点击”技术信息”按钮，在字段数据的最后一行，即为参数ID；

“SE37″ 是指我们要调用的事务代码，AND SKIP FIRST SCREEN 表示跳过第一屏屏幕；

4. I_CALLBACK_TOP_OF_PAGE / I_CALLBACK_HTML_TOP_OF_PAGE 参数属性

I_CALLBACK_TOP_OF_PAGE 与 I_CALLBACK_HTML_TOP_OF_PAGE 参数属性都用于书写 ALV抬头标题信息，

只是区别在于后者支持 HTML格式；

参数类型：SLIS_FORMNAME，也与 I_CALLBACK_PF_STATUS_SET 参数一样，为定义的子FORM，不显式调用。

如：

其中，对应 FORM(FRM_HTML_TOP_OF_PAGE)的定义，需要引用类：CL_DD_DOCUMENT（动态文本类）来显示HTML格式。

如：

下图是SAP标准文档中的说明：

示例如下：

效果如图所示：

4.1 REUSE_ALV_COMMENTARY_WRITE 函数

上面文档中出现 REUSE_ALV_COMMENTARY_WRITE 函数，这里顺便了解下该函数的应用。

该函数与 CL_DD_DOCUMENT 类一样，用于 I_CALLBACK_TOP_OF_PAGE FORM 中输出抬头/页脚内容信息；

所以一般情况下：

I_CALLBACK_TOP_OF_PAGE Form 与 REUSE_ALV_COMMENTARY_WRITE 函数配合使用；

I_CALLBACK_HTML_TOP_OF_PAGE Form 与 CL_DD_DOCUMENT 类配合使用。

REUSE_ALV_COMMENTARY_WRITE 函数包括一个必须参数，三个可选参数：

01). IT_LIST_COMMENTARY（必须）：一个类型为 SLIS_T_LISTHEADER 的内表；

02). I_LOGO（可选）：图片/Logo 的 Object ID

03). I_END_OF_LIST_GRID（可选）：用于页脚的信息

04). I_ALV_FORM（可选）：是否用于 ALV 的FORM中，默认为：Space

接下来，看下示例：

效果如图所示：

4.2 上传图片

01).通过事务码：OAER，进入 Business Document Navigator 参数界面；

02).输入值：

ClassName 输入：”PICTURES”；

Class Type 输入： “OT”

Object Key 输入： 自定义ID名称（这里输入ZJX_LOGO），用于标记上上传图片的唯一标识

03).按F8执行后，进入到导航界面：

04) 选择 PICTURES 节点后，在创建标签中，打开标准文档类型节点；

05) 双击屏幕节点，会弹出文件框，直接上传现有的图片；

06) 选择文件后，输入描述与关键字，便于搜索查找；

07) 上传成功后，记录下Object Key：”ZJX_LOGO”

然后在 ALV抬头中加入上传后的LOGO：

效果如图所示：

关于图片上传的内容，可以查看以下内容：

* Notes:

* 1) Logos & wallpapers can be found in table BDS_CONN05

* 2) Transaction OAER can be used to create PICTURES.

* Run transaction OAER with class Class type = OT,

* and Object key with whatever name you want to create. In the

* next screen, right clicking on screen and import

Steps for uploading Logo :-:

1.  Goto the transaction OAER

2.  Enter the class name as ‘PICTURES’

3.  Enter the class type as ‘OT’

4.  Enter the object key as the name of the logo you wish to give

5.  Execute

6.  Then in the new screen select Standard doc. types in bottom window

Click on the Screen icon

Now, it will ask for the file path where you have to upload the logo

7.  Now you can use this logo in REUSE_ALV_COMMENTARY_WRITE

or

Import Logo and Background Picture for Reporting

In this step, you can import a customer-specific logo and a background picture into the R/3 System.

These will be displayed in the header area of reports in HR Funds and Position Management.

From the SPRO:

HR Funds and Position Management –> Dialog Control –> Customize Reporting Interface –> Import Logo and Background Picture for Reporting.

Activities

1. Enter the Name of your logo/background picture as an object key in the initial screen.

2. Make sure that the class name is PICTURES, and the class type is OT.

3. Choose Execute.

4. Double-click the document type Picture on the Create tab page.

A dialog box will appear in which you can enter the path in which the logo/background picture can be found.

5. Enter the path and choose Open.  The logo will be uploaded into the current R/3 System.

If the logo/background picture is to be transported into other systems as well, choose Transport.

6. Return to the initial screen and repeat the procedure after having entered the Name of your background picture as an object key.

Please note that the logo/background picture can only be displayed in ALV-based reports with an HTML header.

Manually programmed reports such as business distribution plans are not based on the ALV.

If you have selected several initial objects, ALV-based reports in HR Funds and Position Management will automatically use a hiearchical-sequential display.

A logo is not displayed here either. Note also that the logo cannot be printed (see print preview in program).

Make sure that the logo does not exceed a height of 100 pixels because it would mean that the header of the report will be scrollable.

5. I_GRID_TITLE 参数属性

该参数为 ALV 小标题，位于 ALV 抬头信息下方；示例如下：

效果如图所示：

6. I_GRID_SETTINGS 参数属性

该参数用于设置Grid相关参数（打印、单元格回调）；

类型为：LVC_S_GLAY，该结构包括：

01) COLL_TOP_P：最小化 TOP_OF_PAGE

02) COLL_END_L：最小化 END_OF_LIST

03) TOP_P_ONLY：仅打印TOP_OF_PAGE

04) EOL_P_ONLY：仅打印END_OF_LIST

05) NO_COLWOPT：不优化打印的列宽

06) EDT_CLL_CB：退出可编辑单元格时回调

其中，常用的是 EDT_CLL_CB 字段，该字段用于回调输入的变量；

即，当我们在ALV的显示界面可编辑字段上修改了数据，回车后会回调我们修改的数据到内表中，并对其修改；

这个字段在编辑操作中很关键。

示例代码如下：

7. IS_LAYOUT/ IS_LAYOUT_LVC 参数属性

关于该参数，前面文章《ALV简介和Fieldcat与Layout相关参数属性》中已经讲述过其相关参数属性；

可查看相关参数属性：Layout属性，这里列举下常用的一些属性:

7.1 设置grid的字段列宽度自动适应

7.2 设置grid的行颜色变换显示

7.3 设置弹出窗口的标题栏

7.4 设置grid的多行选择列，其中box必须为内表的一列,为一个字符长度

7.5 设置grid是否显示行分割线

7.6 设置grid的合计行显示在明细的上面

7.7 设置grid不显示弹出明细显示窗口

7.8 设置grid显示led列， light为内表字段，,一个字符长，,值范围为1-3

7.9 设置grid的没有标题

8. IT_FIELDCAT/ IT_FIELDCAT_LVC 参数属性

与 IS_LAYOUT/ IS_LAYOUT_LVC 参数一样，前面文章《ALV简介和Fieldcat与Layout相关参数属性》中已经讲述过该参数的相关属性；

可查看相关参数属性：Fieldcat属性，这里列举下常用的一些属性：

8.1 单列优化宽度

8.2 单列求和或者取消求和，添加属性

如若在IS_LAYOUT属性中加上下列属性，则求和后的行就会在第一行出现

8.3 对齐方式

默认情况下，ABAP 的各种数据类型优默认的对其方式：

字符串是默认为左对齐；

货币、数量默认为右对齐；

8.4 以图标方式输出

需要作为图标输出，首先要引入图标的信息：Include <list>;

然后在内表中添加显示图标的字段名称；

在 Fieldcat 添加属性的时候，则可以为内表显示图标的字段添加相关图标。

示例如下：

这样图标就可以在ALV界面中显示了，其中添加”热点”的目的是为了当用户点击该图标的时候，可以触发一系列的操作，如文件的选择等等；

注意：图标的名称用事务码”ICON“进入后,第二列就是图标代码，根据需要进行选择；

8.5 单元格的F1、F4帮助

8.5.1 F1帮助

在Fieldcat的RollName属性中，添加指定的数据元素，即可激活F1帮助；如：

8.5.2 F4帮助

在Fieldcat中添加下列属性：

这样在ALV的显示界面，在该字段处就可以按F4来查看相关的内容了；

8.6 字段类型保留

对于货币或数量字段，需要在其设置字段中再添加一个”指定数据类型”的属性，如下：

9. IT_EXCLUDING 参数属性

该参数可对ALV标准工具栏隐藏不必要的功能；

对于该参数的应用，需要知道ALV标准按钮对应的 FCode，这里在上面讲过，可以查看 CL_GUI_ALV_GRID 类的属性及其初始值；

示例代码如下：

10. IT_SORT/ IT_SORT_LVC 参数属性

ALV 字段排序设置；

两个参数的类型定义虽然不一样，但结构是一样的，所以操作上并无差异；

下面查看下IT_SORT参数的类型结构定义：

示例代码如下：

11. I_DEFAULT/ I_SAVE/ IS_VARIANT 参数属性

这三个参数都是用于ALV 布局的保存设置：

01). I_DEFAULT参数用于设置用户是否可以定义默认的布局: ’X' 可以定义默认布局， SPACE 不可以定义默认布局 （默认：X）

02). I_SAVE 参数 保存表格布局： ’X' 只能保存全局变式 ’U' 只能保存特定变式 ’A' 都可以保存 SPACE 不能保存变式 （默认：space）

03). IS_VARIANT 参数用于启用用户表格布局变式

12. IT_EVENTS 参数属性

IT_EVENTS 参数属性,传入一个 SLIS_T_EVENT 类型的内表，设置相应处理FORM；

通过与REUSE_ALV_EVENTS_GET函数配合使用，可自定义ALV事件。

首先，查看下SLIS_T_EVENT的类型结构定义，如下所示：

再看下 REUSE_ALV_EVENTS_GET 函数，该函数可以获取ALV中现有的事件，其参数也较为简单：

Import 参数：I_LIST_TYPE，类型为SLIS_LIST_TYPE，即为ALV事件的序号，其输入可以为：0,1,2,4

Export 参数：ET_EVENTS，类型为 SLIS_T_EVENT；

接下来，查看下示例：

通过IT_EVENTS 参数属性，就可以为ALV添加自定义的事件 CALLER_EXIT；

其事件的相应处理，则放在FORM中。