Оператор Menu Bar

Оператор Menu Bar

Назначение:

Показывает или скрывает строку меню.

Синтаксис:

Menu Bar { Hide | Show }

Описание:

Оператор Menu Bar управляет отображением строки меню в рабочем окне MapInfo. Программа, используя этот оператор, может освободить больше места на экране для окна Карты, Списка, Отчета или Графика.

Чтобы вновь показать строку меню, скрытую оператором Menu Bar Hide, используйте оператор Menu Bar Show. Вам следует аккуратно использовать этот оператор, так как пользователь может быть поставлен в тупик, оказавшись без строки меню. За каждым оператором Menu Bar Hide, по возможности, должен следовать оператор Menu Bar Show.

Пока строка меню отсутствует, MapInfo будет игнорировать клавишные сокращения для вызова команд. Т.е., например, для вызова диалога команды ФАЙЛ > ОТКРЫТЬ Вы можете использовать клавиши CTRL+O, но, если строка меню скрыта, то нажатие на эти клавиши ни к чему не приведет.

Заметим, что в MapInfo для Macintosh оператор Menu Bar Hide не может скрыть меню.

Смотрите также:

Alter Menu Bar, Create Menu Bar

340	Справочник MapBasic

Функция MenuitemInfoByHandler( )

Функция MenuitemInfoByHandler( )

Назначение:

Возвращает информацию об элементе меню MapInfo.

Синтаксис:

MenuitemInfoByHandler(handler , attribute )

где

handler – либо строка с именем процедуры-обработчика, заданной для элемента меню предложением Calling, или целое число (тип Integer), код, который был задан в предложении Calling;

attribute – целое число типа Integer, код, задающий, какая информация необходима в результате.

Величина, полученная в результате:

Тип величины зависит от значения парметра attribute.

Описание:

Параметр handler может быть как строковым, так и численным. Если Вы выбрали строковый вид (имя процедуры), и соответствующую процедуру вызывают два или более элемента меню, то MapInfo будет рассматривать первый элемент, вызвавший эту процедуру. Поэтому, если Вам необходима информация о другом элементе, то используйте для идентификации ID-номер, который был назначен элементу меню в операторе Create Menu и используйте функцию MenuitemInfoByID( ) вместо

MenuitemInfoByHandler( ).

Значение параметра attribute должно быть целочисленным кодом. В следующей таблице в первой колонке приводятся имена кодов, установленных в файле стандартных определений MapBasic MAPBASIC.DEF.

Справочник MapBasic

341

Функция MenuitemInfoByHandler( )

Значения attribute	Результат
MENUITEM_INFO_ACCELERATOR	Строка, величина типа String:
	строковый код акселератора элемента меню
	(например, “/W^Z” или “/W#%119”)
	или пустая стока, акселератор не был назначен.
	Информацию о назначении элементу меню
	акселератора смотрите в описании оператора Create
	Menu.
MENUITEM_INFO_CHECKABLE	Логическая величина:
	“Да” (TRUE), если элемент меню фиксируется
	(рядом с именем элемента в меню может появляться
	галочка)
MENUITEM_INFO_CHECKED	Логическая величина:
	“Да” (TRUE), если элемент меню можно
	фиксировать и в данный момент он фиксирован (есть
	галочка);
	“Да” (TRUE) также, если элемент меню имеет
	несколько вариантов текста (например, “Показать
	что-то” и “Скрыть что-то”) и при этом элемент меню
	находится в состоянии “Показать”;
	“Нет” (FALSE) во всех остальных случаях.
MENUITEM_INFO_ENABLED	Логическая величина:
	“Да” (TRUE), если элемент меню активен.
MENUITEM_INFO_HANDLER	Целое число типа Integer:
	Номер обработчика элемента меню. Если при
	создании элемента меню в предложении Calling был
	задан код (например, Calling M_FILE_SAVE), то
	результатом будет значение этого кода. Если
	предложение Calling задало “OLE”, “DDE” или имя
	процедуры, то результатом будет уникальное целое
	число, которое может быть использовано функцией
	MenuitemInfoByHandler( ) и оператором Run Menu
	Command.
MENUITEM_INFO_HELPMSG	Строка, величина типа String:
	подсказка для элемента меню, которая была
	назначена в предложении HelpMsg оператора Create
	Menu
	или пустая строка, если подсказка не назначалась.
MENUITEM_INFO_ID	Целое число типа Integer:
	идентификатор элемента меню, который был
	назначен предложением ID в операторе Create Menu
	или 0, если элемент меню не имеет идентификатора.

342	Справочник MapBasic

	Функция MenuitemInfoByHandler( )
MENUITEM_INFO_SHOWHIDEABLE	Логическая величина:
	“Да” (TRUE), если элемент меню имеет несколько
	вариантов текста (например, “Показать что-то” и
	“Скрыть что-то”). Несколько вариантов текста
	задаются помещением символа “!” в начало строки
	описания элемента меню (в операторах Create Menu
	или Alter Menu) и символа “^” перед началом
	альтернативного текста.
MENUITEM_INFO_TEXT	Строка, величина типа String:
	полный текст, используемый при создании элемента
	меню (например, в операторе Create Menu).

Смотрите также:

MenuItemInfoByID( ), Create Menu, Alter Menu

Справочник MapBasic

343

Функция MenuitemInfoByID( )

Функция MenuitemInfoByID( )

Назначение:

Возвращает информацию об элементе меню MapInfo.

Синтаксис:

MenuitemInfoByID(menuitem_ID, attribute )

menuitem_ID – целое число типа Integer, идентификатор элемента меню, который он получил при создании в предложении ID оператора Create Menu;

attribute – целое число типа Integer, код, задающий, какую информацию необходимо вернуть.

Величина, полученная в результате:

Тип величины зависит от значения параметра attribute.

Описание:

Функция работает аналогично функции MenuitemInfoByHandler( ). Различие состоит в том, как задается элемент меню в первом параметре. В функции MenuitemInfoByID( ) используется его идентификатор. В функции MenuitemInfoByHandler( ) элемент меню задается обработчиком, который запускается, когда пользователь выберет элемент меню.

Параметр attribute должен быть целочисленным кодом, одним из тех, имена которым присвоены в файле MAPBASIC.DEF (например, MENUITEM_INFO_CHECKED). Список возможных значений параметра attribute и какой результат должен быть получен в результате тот же, что и для функции MenuitemInfoByHandler( ) (смотрите описание функции выше).

Смотрите также:

MenuItemInfoByHandler( )

344	Справочник MapBasic