在 SAP ABAP 开发中，cl_gui_alv_grid 是一个非常重要的类，它用于创建和控制 ALV Grid 控件。ALV Grid 是一个强大的表格控件，可以用来展示和编辑大量的表格数据。ALV Grid 提供了很多强大的功能，例如排序、过滤、总结、打印、导出等。
TOOLBAR 是 cl_gui_alv_grid 的一个公共事件，它的作用主要是用来自定义 ALV Grid 的工具栏。在默认情况下，ALV Grid 的工具栏包含了一些常见的功能按钮，例如刷新、打印、导出等。但是，在某些情况下，我们可能需要添加一些自定义的功能按钮，或者移除一些不需要的默认按钮。这时候，我们就可以通过处理 TOOLBAR 事件来实现。
处理 TOOLBAR 事件的方法是在创建 cl_gui_alv_grid 对象的时候，注册一个处理 TOOLBAR 事件的方法。然后，在这个方法中，我们可以使用 e_object->mt_toolbar 结构来获取和修改工具栏的配置。
以下是一个简单的例子，演示了如何添加一个自定义的功能按钮。
首先，我们需要在程序中定义一个处理 TOOLBAR 事件的方法。在这个方法中，我们创建一个新的按钮，设置它的文本和图标，然后添加到工具栏中。
METHOD on_toolbar.
DATA: ls_button TYPE s_tbutton.
ls_button-butn_type = ' '.
ls_button-text = '我的按钮'.
ls_button-quickinfo = '点击这里'.
ls_button-icon = '@0D@'.
APPEND ls_button TO e_object->mt_toolbar.
ENDMETHOD.
然后，我们在创建 cl_gui_alv_grid 对象的时候，注册这个方法。
DATA: lo_alv TYPE REF TO cl_gui_alv_grid.
CREATE OBJECT lo_alv
EXPORTING
i_parent = cl_gui_container=>screen0.
SET HANDLER: on_toolbar FOR lo_alv.
CALL METHOD lo_alv->set_table_for_first_display
EXPORTING
i_structure_name = 'SFLIGHT'
CHANGING
it_outtab = lt_sflight.
在这个例子中，我们添加了一个名为 "我的按钮" 的新按钮到 ALV Grid 的工具栏中。当用户点击这个按钮的时候，SAP 系统会触发一个名为 USER_COMMAND 的事件，我们可以在处理这个事件的方法中，根据用户点击的按钮执行相应的操作。