_GUICtrlToolbar_AddButton
Добавляет кнопку
#include <GuiToolBar.au3>
_GUICtrlToolbar_AddButton($hWnd, $iID, $iImage [, $iString = 0 [, $iStyle = 0 [, $iState = 4 [, $iParam = 0]]]])
Параметры
$hWnd | Дескриптор элемента |
$iID |
Идентификатор кнопки |
$iImage |
Индекс изображения кнопки, отсчёт от 0. Установите параметр равным -1 и элемент будет высылать уведомление $TBN_GETDISPINFO, чтобы получить индекс изображения, когда это необходимо. Установите параметр равным -2, чтобы указать, что кнопка не имеет изображения. Компоновка кнопки будет включать только место для текста. Если кнопка является разделителем, то это определяет ширину разделителя в пикселях. |
$iString |
[необязательный] Индекс текста кнопки, устанавливаемый функцией _GUICtrlToolbar_AddString, отсчёт от 0. |
$iStyle |
[необязательный] Стиль кнопки. Это может быть комбинацией следующих значений: $BTNS_AUTOSIZE - Toolbar не должен назначать стандартную ширину кнопок $BTNS_BUTTON - Стандартная кнопка $BTNS_CHECK - Переключает между нажатым и отжатым положением $BTNS_CHECKGROUP - Кнопка остаётся нажатой до тех пор, пока не будет нажата иная кнопка в группе $BTNS_DROPDOWN - Создаёт кнопку со стилем раскрывающегося вниз списка $BTNS_GROUP - Кнопка остаётся нажатой до тех пор, пока не будет нажата иная кнопка в группе $BTNS_NOPREFIX - Текст кнопки не будет иметь префикс быстрой клавиши $BTNS_SEP - Создаёт разделитель $BTNS_SHOWTEXT - Указывает, что текст кнопки должен отображаться $BTNS_WHOLEDROPDOWN - Указывает, что кнопка будет иметь стрелку раскрывающегося списка |
$iState |
[необязательный] Состояния кнопки. Это может быть комбинацией следующих значений: $TBSTATE_CHECKED - Кнопка имеет стиль $TBSTYLE_CHECK и вид нажатой кнопки $TBSTATE_PRESSED - Нажатая кнопка $TBSTATE_ENABLED - Кнопка доступна $TBSTATE_HIDDEN - Кнопка скрыта $TBSTATE_INDETERMINATE - Кнопка серая $TBSTATE_WRAP - Кнопка сопровождается переносом на новую строку кнопок $TBSTATE_ELLIPSES - Текст кнопки обрезается и отображается многоточие $TBSTATE_MARKED - The button is marked |
$iParam |
[необязательный] Ассоциативное значение кнопки |
Возвращаемое значение
Успех: | Возвращает True |
Ошибка: | Возвращает False |
См. также
_GUICtrlToolbar_DeleteButton, _GUICtrlToolbar_InsertButtonПример
#include <GuiToolbar.au3>
#include <GUIConstantsEx.au3>
#include <WindowsConstants.au3>
#include <Constants.au3>
$Debug_TB = False ; Проверяет ClassName передаваемый в функции. Установите True и используйте дескриптор от другого элемента, чтобы увидеть как это работает
_Main()
Func _Main()
Local $hGUI, $hToolbar
Local Enum $idNew = 1000, $idOpen, $idSave, $idHelp
; Создаёт GUI
$hGUI = GUICreate(StringTrimRight(@ScriptName, 4), 400, 300)
$hToolbar = _GUICtrlToolbar_Create($hGUI)
GUISetState()
; Добавляет стандартный системный bitmaps
_GUICtrlToolbar_AddBitmap($hToolbar, 1, -1, $IDB_STD_LARGE_COLOR)
; Добавляет кнопки
_GUICtrlToolbar_AddButton($hToolbar, $idNew, $STD_FILENEW)
_GUICtrlToolbar_AddButton($hToolbar, $idOpen, $STD_FILEOPEN)
_GUICtrlToolbar_AddButton($hToolbar, $idSave, $STD_FILESAVE)
_GUICtrlToolbar_AddButtonSep($hToolbar)
_GUICtrlToolbar_AddButton($hToolbar, $idHelp, $STD_HELP)
; Цикл выполняется, пока окно не будет закрыто
Do
Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc ;==>_Main