ALV GRID参考文档 ( 2 ) - 通过CREATE OBJECT来实例化类

通过CREATE OBJECT来实例化类，在上面的一小段代码中使用了cl_gui_alv_grid的两个实例方法。第一个便是‘set_table_for_first_display’,他的名字也就说明了他的用途。创建了alv grid的实例后我们使用这个实例来显示ABAP报表。通过这个方法来传入list data table, field catalog, layout structure以及其他一些信息。下面是帮助文档中这些参数的含义：

Parameter

Meaning

I_BUFFER_ACTIVE

如果方法的调用是静态的，这个参数被设置。这意味着这个方法总是用同样的field catalog来调用。这种情况下，field catalog被保存到特殊的缓存区域中。这边加速了列表的显示。

I_STRUCTURE_NAME

要显示的数据表的数据字典结构，如果给了这个参数field catalog会被自动产生。

IS_VARIANT

决定了数据表格的显示格式。如果用这个参数的话必须这是结构类型DISVARIANT的REPORT字段。

I_SAVE

决定了用户是否可以保存显示样式：

‘X’: global saving only

 ‘U’ user-specific saving only

 ‘A’ corresponds to ‘X’ and ‘U’

SAPCE：no saving

I_DEFAULT

决定了用户是否可以设置缺省的显示样式：

‘X’ default layouts allowed

SPACE default layouts not allowed

如果显示样式已存在并且在IS_LAYOUT中没有其他的显示样式，在调用这个方法时这个样式将被自动调用

IS_LAYOUT

用来决定grid control的属性。它与过滤，排序和字段的属性无关。

IS_PRINT

与打印相关的参数

IT_SPECIA_GOUPS

在FIELD CATALOG中如果字段被SP_GROUP分组，你必须为这些组传输一个文本表。通过这个参数你就可以限制这些组中的某一组的列

IT_TOOLBAR_EXCLUDING

这个表用来包含想在工具条中隐藏某些功能的功能代码。这些功能代码都是一些常量属性，都以MC_FC_开头。

IT_HYPERLINK

这个表为每个操作柄(field HANDLE OF LVC_S_HYPE)提供了一个超级链接(field HREF OF LVC_S_HYPE)

IT_ALV_GRAPHICS

用来在ALV中显示图片，这个表的行类型有两个字段（variables/value pairs）： PROP_ID：把以CO_PROP_ID_开头的类CL_ALV_GRAPHICS_CU的常量属性付给这个字段来决定对图像所做的个改变。用CL_GUI_ALV_GRAPHICS_CU=>CO_PROPID_TITLE来决定图片的标题。

IT_OUTTAB

要显示的数据的表

IT_FIELDCATALOG

决定了要显示表的结构和数据的显示方式

IT_SORT

各个列的初始的排序方式

IT_FILTER

一些列的初始的筛选方式

这段代码中还使用了grid实例的另外一个方法; refresh_table_display , 正如他的名字，它是用来刷新alv表的显示，我们并不希望每次的PBO事件中都创建ALV列表。开始的时候我们需要创建它而这之后我们只需刷新它就可以了。然而，有些时候我们需要改变列表的显示方式，比如layout ,field catalog等，这种情况下我们可能需要ALV GRID的其他方法来实现这一目的，这个方法有下面两个参数：

 

Parameter

meaning

IS_STABLE

用来固定某行或某列的位置，在使用滚动条时，保证这些位置不变。

I_SOFT_REFRESH

这个参数用来保证等你刷新列表示，以前产生的总计，排序和筛选等保持不变。如果你只是想刷新列表的显示格式时，比如layout ,fieldcatalog 等时，这个参数非常有用。

建立FIELD CATALOG

正如前面所提到的建立field catalog需要三个步骤。如果我们的表与数据字典中的表的结构一样的话，我们就可以用最简单的方式实现。我们就可以省去form: prepare_catalog只把数据字典中的结构名字传给参数I_STRUCTURE_NAME就可以了。首先我们来看一下field

Catalog的结构。

FIELD CATALOG的结构

FIELD CATALOG的行类型是LVC_S_FCAT，这里提供了很多字段来确定列表字段的显示方式。下表列出了一些基础的字段：

FIELDNAME

这个字段的名字便是要显示的内表中的一个字段，下面的一些设置都是针对的这个字段。

REF_FIELD

如果要显示的内表中的字段在数据字典中有某个字段可以描述，但是数据字典中的字段的名字和内表中的字段的名字不一致，那么这个字段必须设置。如果一致的话那只要制定数据字典的结构或REF_TABLE就可以了

REF_TABLE

如果要显示的内表中的字段需要用数据字典中的字段加以描述，那么必须设置这个参数。

CHECKBOX

该字段显示为checkbox

COL_POS

如果想使alv中显示列的顺序与field catalog中字段的顺序不一致，那么就可以使用这个参数。如果这个参数为空的话，alv显示的顺序便于field catalog中字段的顺序一致。

DO_SUM

如果这个值被选中的话，那么这个字段会被进行汇总计算。

EMPHASIZE

如果这字段被设置成‘X’，alv就会用高亮的方式用预定义的颜色显示这个字段。如果被设置成’Cxyz‘下面列出了他们的含义：

X；color number

Y: intensified on/off

Z: inverse display on/off

HOTSPOT

如果这个字段被设置，那么这个字段的框都会有热点感应

ICON

如果这个字段被设置那么这个字段将被设置为图标，要显示的内表中的字段的值必须是正确的图标字符串。

JUST

只对NUMC和CHAR类型的字段有效，它有三个值：即R，L，C，字段的头信息和字段的内容的对齐方式是一致的。

LZERO

只对NUMC类型的字段有关。缺省的情况下ALV不显示签到零。如果你设置了这个字段，他就会显示前导零。

COLDDICTXT

只对参考数据字典的字段有效。通过值’L’,’M’,’S’或者’R’来决定要显示什么样的列头。

COLTEXT

列头的内容，如果你没有指定参考数据字典，那么需要设置这个值。

REPTEXT

只对参考数据字典的字段有效。对于这些字段ALV会把相应的数据元素的描述信息拷贝过来。

SCRTEXT_L

只对参考数据字典的字段有效。设置这个字段，alv会把数据元素的长文本拷贝过来

SCRTEXT_M

只对参考数据字典的字段有效。设置这个字段，alv会把数据元素的较长文本拷贝过来

SCRTEXT_S

只对参考数据字典的字段有效。设置这个字段，alv会把数据元素的较短文本拷贝过来

SELDDICTXT

只对参考数据字典的字段有效。选择字段文本通过使用值L，M，S，OR R使用SCRTEXT_L，SCRTEXT_M，SCRTEXT_S或REPTEXT

SELTEXT

如果这个字段没有参考数据字典的话，在选择字段的时候来决定选择字段的文本。

TIPDDICTXT

只对参考数据字典的字段有效。TIP文本通过使用值L，M，S，OR R使用SCRTEXT_L，SCRTEXT_M，SCRTEXT_S或REPTEXT

TOOLTIP

决定TOOLTIP的文本，如果该字段没有参考数据字典的话。

INITYPE

ABAP数据类型

SP_GROUP

使用它可以用来给显示的字段分组。