sAP ALV说明.docx

1、sAP ALV说明SAP ALV 详细说明2012-05-22 20:17:58|分类： 默认分类 |标签：sapalv详细说明 |字号大中小订阅 一.ALV介绍The ALV Grid Control (ALV = SAPList Viewer)是一个显示列表的灵活的工具,它提供了基本功能的列表操作,也可以通过自定义来进行增强,因此可以允许你可以在大型的应用程序中使用. SAP提示: 在SAP的开发项目中,ALV GRID也可以作为修改和创建数据的一种工具,然而,目前这个功能只在实验计划中使用,还没有向客户发布. 下面是一个ALV GRID的图片:它包括3大部分,工具栏,标题,用于显示数据的

2、网格控制器.如果有必要，用户可以隐藏标题和工具栏. 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

3、类 dataALV_GRID1 type refto cl_gui_alv_grid. ALV GRID继承结构:四、ALV GRID相关的几个控制结构 1.字段目录Field catalog字段目录是用来控制ALV显示的网格中每个字段的属性的,比如字段的顺序,对齐方式,可编辑状态,颜色,等等. 常用的控制字段如下:(下面的示例将说明这些字段的使用,参考STRUCTURE LVC_S_FCAT)2ROW_POSALV 控制:输出行 (内部使用)3COL_POSALV 控制:输出列列的位置,第几列,例如1,2,.4FIELDNAMEALV 控制:内部表字段的字段名称字段名称5TABNAMELVC

4、 标签名称表名，如果是内表，是16CURRENCYALV 控制:货币单位7CFIELDNAMEALV 控制:参考的当前单位的字段名称8QUANTITYALV 控制:计量单位9QFIELDNAMEALV 控制:参考计量单位的字段名称0IFIELDNAMEALV 控制:内部表字段的字段名称11ROUNDALV 控制: ROUND值12EXPONENTALV 控制：流动表示的指数13KEYALV 控制:关键字段关键字段,前面变蓝色14KEY_SELALV 控制:可以被隐藏的关键列可以被隐藏的关键列15ICONALV 控制:作为图标输出此列作为图标输出16SYMBOLALV 控制:输出作为符号17CH

5、ECKBOXALV 控制:作为复选框输出复选框输出18JUSTALV 控制:对齐对齐方式:R: right justifiedL: left justifiedC: centered19LZEROALV 控制:输出前导零X20NO_SIGNALV 控制：输出抑制符号X,不输出符号21NO_ZEROALV 控制:为输出隐藏零X,隐藏022NO_CONVEXTALV 控制:不考虑输出的转换退出23EDIT_MASKALV 控制:为输出编辑掩码格式24EMPHASIZEALV 控制:带有颜色的高亮列列的颜色25FIX_COLUMNALV 控制:固定列26DO_SUMALV 控制:总计列值X,合计27

6、NO_SUMALV 控制:没有总计列值X ,没有合计28NO_OUTALV 控制:列没有输出X ,隐藏此列29TECHALV 控制:技术字段X.也是隐藏，但是有点不一样30OUTPUTLENALV 控制:列的字符宽度输出的长度31CONVEXIT转换例程32SELTEXTALV 控制:对话功能的列标识符33TOOLTIPALV 控制:列抬头的工具提示34ROLLNAMEALV 控制: F1帮助的数据元素35DATATYPEABAP 字典中的数据类型ABAP 字典中的数据类型36INTTYPEABAP 数据类型(C,D,N,.)ABAP 数据类型(C,D,N,.)37INTLEN以字节计的内部长

7、度内容的长度38LOWERCASE允许/不允许小写字母X 允许大小写39REPTEXT标题40HIER_LEVELALV 控制:内部使用41REPREPALV 控制:价值是补充/补充接口的选择标准42DOMNAME定义域名43SP_GROUP组代码44HOTSPOTALV 控制:单击敏感X,下面出现下划线,响应单击45DFIELDNAMEALV 控制:数据库中列组的字段名称46COL_IDALV 控制:列 ID47F4AVAILABL字段有输入帮助吗X.此列有搜索帮助48AUTO_VALUEALV 控制:自动复制值49CHECKTABLE表名50VALEXI固定值存在51WEB_FIELDAL

8、V 控制:内部表字段的字段名称52HREF_HNDL自然数热点连接的句柄53STYLEALV 控制:样式下面有例子会介绍,比如PUSHBUTTION54STYLE2ALV 控制:样式55STYLE3ALV 控制:样式56STYLE4ALV 控制:样式57DRDN_HNDL自然数下拉的句柄58DRDN_FIELDALV 控制:内部表字段的字段名称下拉的字段59NO_MERGING字符字段长度 1相同的值不合并60H_FTYPEALV 树控制:功能类型 (总计,平均,最大.最小, .)61COL_OPT可选列优化的条目62NO_INIT_CH字符字段长度 163DRDN_ALIAS字符字段长度 1

9、64REF_FIELDALV 控制:内部表字段的参考字段名称65REF_TABLEALV 控制:内部表字段的参考表名称66TXT_FIELDALV 控制:内部表字段的字段名称67ROUNDFIELDALV 控制:带有 ROUND 说明的字段名称68DECIMALS_OALV 控制:输出小数位的编号69DECMLFIELDALV 控制:带有 DECIMALS 说明的字段名称70DD_OUTLENALV 控制:输出字符长度71DECIMALS小数点后的位数设置小数的位数72COLTEXTALV 控制:列标题列标题73SCRTEXT_L长字段标签74SCRTEXT_M中字段标签75SCRTEXT_S

10、短字段标签76COLDDICTXTALV 控制:确定 DDIC 文本参考77SELDDICTXTALV 控制:确定 DDIC 文本参考78TIPDDICTXTALV 控制:确定 DDIC 文本参考79EDITALV 控制:准备输入输出状态.X可输入80TECH_COLALV 控制:内部使用81TECH_FORMALV 控制:内部使用82TECH_COMPALV 控制:内部使用83HIER_CPOSALV 控制:层次列位置84H_COL_KEY树控制: 列名称/项目名称85H_SELECT标识是否可以选择树控制中的列86DD_ROLL数据元素 (语义域)87DRAGDROPIDALV 控制:拖&

11、放处理拖放对象88MAC字符字段长度 189INDX_FIELD自然数90INDX_CFIEL自然数91INDX_QFIEL自然数92INDX_IFIEL自然数93INDX_ROUND自然数94INDX_DECML自然数95GET_STYLE字符字段长度 196MARK字符字段长度 12.布局控制layout 布局是用来控制整个ALV的一个布局，比如ALV的标题,是否可编辑,行颜色,列颜色.参照ALV的控制结构LVC_S_LAYO,以后的例子我将详细介绍如何设置行颜色和列颜色. 详细的结构说明字段名描述Value rangeCWIDTH_OPT最优化宽度SPACE, XSMALLTITLE小标

12、题,如果设置了这个字段，则标题与列标题大小一样SPACE, XGRID_TITLE标题,在网格和工具条之间最长70个字符NO_HEADERS如果被设置,列标题隐藏SPACE, XNO_HGRIDLN隐藏水平线SPACE, XNO_MERGING禁用单元格合并SPACE, XNO_ROWMARK如果被设置,选择列在选择模式为D和A的时候隐藏SPACE, XNO_TOOLBAR隐藏工具条SPACE, XNO_VGRIDLN隐藏垂直线SPACE, XSEL_MODE选择模式SPACE, A, B, C, DEXCP_CONDS合计例外SPACE, XEXCP_FNAME字段名称带有例外编码最长30个

13、字符EXCP_LED例外作为 LEDSPACE, XEXCP_ROLLN例外文档的数据元素SPACE, XCTAB_FNAME带有复杂单元格颜色编码的字段名称最长30个字符INFO_FNAME带有简单行彩色代码的字段名称最长30个字符ZEBRA可选行颜色,如果设置了，出现了间隔色带SPACE, XNO_TOTLINE没有总计SPACE, XNUMC_TOTAL可以对NUMC字段进行合计SPACE, XTOTALS_BEF总计输出在第一行,小计在新的值之前SPACE, XSTYLEFNAME设置单元格,比如PUSHBUTTON最长30个字符3.打印和排序,过滤控制 打印的参数控制请参考结构 LV

14、C_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.存放数据的内表,最好内表的结构和字段目录是一致

15、的,否则可能会出现一些无法预知的错误,当然你说我非要不一样,那也不一定会出现错误.我建议是最好一样的. 这2个是必须的,布局的话,应该是可以不设置的,使用默认的就可以了.第一步:创建个SCREEN,在屏幕上创建个容器,CONTAINER.定义变量. DATA:WCL_CONTAINERTYPEREFTOCL_GUI_CUSTOM_CONTAINER,WCL_ALVTYPEREFTOCL_GUI_ALV_GRID.*- 存放字段目录的内表DATA gt_fieldcat TYPE lvc_t_fcat .*- 布局结构DATA gs_layout TYPE lvc_s_layo .*-声明需要显

16、示的内表(以SFLIGHT为例)DATA BEGIN OF gt_list OCCURS 0 .INCLUDE STRUCTURE SFLIGHT .DATA END OF gt_list .第二步: 创建ALV这个对象，它的父组件是那个容器. 在PBO中写入如下代码: PROCESS BEFOREOUTPUT .MODULE display_alv . 创建DISPLAY_ALV的MODULE后,写下如下代码:MODULE display_alv OUTPUT .PERFORM display_alv .ENDMODULE . 在FORM DISPLAY_ALV中,判断ALV实例是否存在,如

17、果不存在,则创建: IF WCL_ALV IS INITIAL . CREATEOBJECT:WCL_CONTAINEREXPORTINGCONTAINER_NAME=ALV_CON. CREATEOBJECTWCL_ALVEXPORTINGI_PARENT=WCL_CONTAINER. *-准备获取字段目录PERFORM prepare_field_catalog CHANGINGgt_fieldcat . *-设置布局PERFORM prepare_layout CHANGING gs_layout . *-显示ALVCALL METHODgr_alvgrid-set_table_for_

18、first_displayEXPORTING* I_BUFFER_ACTIVE =* I_CONSISTENCY_CHECK =* I_STRUCTURE_NAME =* IS_VARIANT =* I_SAVE =* I_DEFAULT = Xis_layout = gs_layout* IS_PRINT =* IT_SPECIAL_GROUPS =* IT_TOOLBAR_EXCLUDING =* IT_HYPERLINK =CHANGINGit_outtab = gt_listit_fieldcatalog = gt_fieldcat* IT_SORT =* IT_FILTER =EXC

19、EPTIONSinvalid_parameter_combination = 1program_error = 2too_many_lines = 3OTHERS = 4 . ELSE .*-刷新ALVCALL METHODgr_alvgrid-refresh_table_display* EXPORTING* IS_STABLE =* I_SOFT_REFRESH =EXCEPTIONSfinished = 1OTHERS = 2 .IF sy-subrc 0.*-异常处理ENDIF. ENDIF .方法set_table_for_first_display的参数说明参数含义I_BUFFER

20、_ACTIVE如果方法调用是静态的,可以设置这个标记,这表示,如果每次显示ALV都是相同的字段目录.既然这样，那么字段目录会被放到一个特殊的缓存里,这样加速了ALV的显示I_STRUCTURE_NAME输出数据参考的数据字典的结构名,例如SFLIGHT.如果指定了这个参数,字段目录会自动生成,下面的参数IT_FIELDCATALOG不需要传值.IS_VARIANT决定布局显示的变式I_SAVE决定用户是否可以保存变式:X 只能保存全局变式U 只能保存特定变式A 都可以保存SPACE 不可以保存变式I_DEFAULT决定用户是否可以定义默认的布局:X 可以定义默认布局,这个参数是默认的SPACE

21、 不可以定义默认布局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输出数据存放的内表,

22、数据都是存放在这个内表里IT_FIELDCATALOG字段目录IT_SORT排序的标准IT_FILTER过滤的标准 方法REFRESH_TABLE_DISPLAY的参数说明参数含义IS_STABLE刷新的稳定性，有2个参数，一个是行，一个是列.如果设置了相应的值,那么对应的行，或者列，在刷新的时候,将会保持稳定，就是滚动条保持不动.I_SOFT_REFRESH这个参数只是在异常情况下被使用,如果设置了这个参数,任何创建的合计,任何排序次序,任何为了显示数据而设置的过滤都将保持不变.这个是非常有意义的.例如:当然你没有修改数据内表里的数据而想刷新ALV,仅仅只是改变一下布局和字段目录.第三步,获

23、取要显示数据的字段目录.有两种方式. 1.手动创建FORM prepare_field_catalog CHANGINGpt_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_

24、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 TYPElvc_t_fcat .DATA ls_fcat type

25、 lvc_s_fcat .CALL FUNCTION LVC_FIELDCATALOG_MERGEEXPORTINGi_structure_name = SFLIGHTCHANGINGct_fieldcat = pt_fieldcatEXCEPTIONSinconsistent_interface = 1program_error = 2OTHERS = 3.IF sy-subrc 0.*-Exception handlingENDIF.LOOP AT pt_fieldcat INTO ls_fcat .CASE pt_fieldcat-fieldname .WHEN CARRID .ls_f

26、cat-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 TYPElvc_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的常量属性