Функция SetMenuItemState

Назначение

Функция SetMenuItemState устанавливает состояние элемента меню

Описание

SetMenuItemState(menuID : longInt; itemName : string; itemCommand : integet; state : byte) : boolean

Параметры

menuID : longInt - идентификатор меню (значение, которое возвращает функция LoadMenu).

itemName : string - название элемента меню, у которого надо изменить статус.

itemCommand : integet - команда меню.

state : byte - устанавливаемое состояние пункта меню:

• mfEnabled - пункт меню отображается и доступно;

• mfDisabled - пункт меню отображается и не доступно;

• mfHidden - пункт меню не отображается;

Возвращаемое значение

В случае удачного изменения статуса пункта меню функция возвращает true, в случае неудачи возвращает false.

В случае если меню не загружено генерируется исключение ExMenuItemStateError.

Пример

cmHotkeys:
{
  var MenuID : LongInt;
  MenuID := LoadMenu('Testmenu');
// Сделать пункт меню недоступным:
  SetMenuItemState(MenuID, 'First item', cmFirstItem, mfDisabled);
  RunLoadMenu(MenuID);
}

Версия

Функция доступна начиная с Атлантис 3.03.23, Атлантис 5.1.32.