函数参考


_GUICtrlHeader_InsertItem

插入新的标题项目

#include <GuiHeader.au3>
_GUICtrlHeader_InsertItem($hWnd, $iIndex, $sText [, $iWidth = 50 [, $iAlign = 0 [, $iImage = -1 [, $fOnRight = False]]]])

参数

$hWnd 控件句柄
$iIndex 插入位置的上一个项目索引.
如果索引大于或等于控件项目数, 插入新的项目在控件末尾
如果索引为 0, 插入新的项目在控件的顶部.
$sText 标题项目文本.参考备注.
$iWidth [可选参数] 项目宽度
$iAlign [可选参数] 文本对齐方式:
0 - 左对齐
1 - 右对齐
2 - 居中对齐
$iImage [可选参数] 图像在图像列表的 0 基索引
$fOnRight [可选参数] 如设置为 True, 列图像显示在文本右侧.

返回值

成功: 返回项目索引
失败: 返回 -1

注意/说明

If a notification callback is needed, you have to specify $sText = -1 (LPSTR_TEXTCALLBACK).

相关

_GUICtrlHeader_AddItem, _GUICtrlHeader_DeleteItem

示例/演示


#include <GUIConstantsEx.au3>
#include <GuiHeader.au3>

$Debug_HDR = False ; 检查传递给函数的类名, 设置为True并输出到一个控件的句柄,用于检查它是否工作

_Main()

Func _Main()
    Local $hGUI, $hHeader

    ; 创建 GUI
    $hGUI = GUICreate("Header", 400, 300)
    $hHeader = _GUICtrlHeader_Create($hGUI)
    GUISetState()

    ; 添加列
    _GUICtrlHeader_AddItem($hHeader, "Column 1", 100)
    _GUICtrlHeader_AddItem($hHeader, "Column 2", 100)
    _GUICtrlHeader_AddItem($hHeader, "Column 3", 100)

    ; Insert new column
    _GUICtrlHeader_InsertItem($hHeader, 1, "Column X", 100, 2)

    ; 循环直到用户退出
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>_Main