MapBasic. Руководство пользователя
Подождите немного. Документ загружается.
Глава 6: Интерфейс пользователя
MapBasic Руководство пользователя
99
Команда MapBasic, эквивалентная выбору команды в меню
Можно активировать команду MapInfo как если бы пользователь выбрал
строку меню, для этого используйте оператор Run Menu Command. Например,
следующий оператор открывает диалог MapInfo "Открыть таблицу", как если
бы пользователь выполнил команду Ф
АЙЛ > ОТКРЫТЬ ТАБЛИЦУ:
Run Menu Command M_FILE_OPEN
Код M_FILE_OPEN определен в файле menu.def.
Задание клавишных комбинаций
Клавишные комбинации позволяют пользователю открывать меню,
выполнять команды и операции прямо с клавиатуры. В меню обычно
применяются клавишные сокращения, представленные подчеркнутой
буквой в названии меню или команды. Например, клавишным
сокращением для меню Ф
АЙЛ является ALT+Ф, что явствует из
подчеркивания под буквой Ф. При создании элемента меню можно
добиться подчеркивания буквы, поместив перед ней знак амперсанда
(&). Амперсанд автоматически задает клавишное сокращение как в
Windows, так и в Macintosh.
В следующем фрагменте программы создается команда С
ОЗДАТЬ
РАМКИ, вызываемая с клавиатуры комбинацией ALT+ C:
Create Menu "Рамка" As
"&Создать рамки..." Calling create_sub,
...
"Горячие" клавиши (или акселераторы на жаргоне программистов)
являются другой разновидностью клавишных комбинаций. "Горячие"
клавиши позволяют выполнять некоторые команды и операции
напрямую, без обращения к меню. В следующем примере команде
меню сопоставляется "горячая" клавишная комбинация CTRL+Z:
Alter Menu "Запрос" Add
"Новый отчет" + Chr$(9) + "CTRL8Z/W^%122" Calling
new_sub
Текст "CTRL+Z" появляется в меню, и пользователь может видеть, что
команда снабжена "горячими" клавишами.
Инструкция "+ Chr$(9)" вставляет пробел размером в один табулятор
между командой и клавишной комбинацией. Табуляторы позволяют
единообразно выравнивать "горячие" комбинации с правой стороны
меню.
Инструкция "/w^%122" определяет клавишную комбинацию как
одновременное нажатие на клавиши CTRL и Z. Код "/w^%122" Map
Info интерпретирует следующим образом: "/w" говорит о том, что это
код для MapInfo для Windows, символ "^" определяет нажатие
Глава 6: Интерфейс пользователя
100 MapBasic Руководство пользователя
клавиши CTRL, а код "%122" определяет нажатие клавиши “z" (122 –
это ASCIIномер буквы "z"). При задании "горячей" клавиши нужно
ориентироваться на английские буквы, которые им соответствуют
стандартно; при этом действующая в системе Windows раскладка
клавиатуры может быть другой, даже русской; например, в русской
версии MapInfo комбинация CTRL+Я будет работать так же, как
CTRL+Z.
Список кодов, управляющих созданием “горячих” клавиш, приведен в
описании оператора CreateMenu в Справочнике MapBasic.
Управление системой меню через файл MAPINFOW.MNU
Стандартная система меню MapInfo версии 3 содержится в
специальном текстовом файле. При желании Вы можете настроить
меню MapInfo по своему вкусу, изменив этот файл.
В системе UNIX этот файл называется MAPINFO.MNU; в MapInfo для
Machintosh – Mapinfo.Menus; в MapInfo для Windows – MAP
INFO.MNU.
Если Вы откроете этот файл в текстовом редакторе, то увидите, что он
построен как фрагмент программы MapBasic. Если Вы измените
описание элемента меню в файле MAPINFOW.MNU, то этот элемент
будет выглядеть поновому при следующем запуске MapInfo. Таким
образом, манипулируя текстами в файле MAPINFOW.MNU, Вы
можете переопределять стандартную систему меню напрямую, без
участия программ MapBasic.
Внимание: Внимание: Прежде чем изменять чтолибо в файле
MAPINFOW.MNU, сохраните его резервную копию,
например, в файле BACKUP.MNU. Ибо, если файл
MAPINFOW.MNU будет испорчен или уничтожен, то MapInfo,
возможно, не запустится. Запустить MapInfo можно будет
только восстановив файл MAPINFOW.MNU из резервной
копии. Если же файл MAPINFOW.MNU поврежден, а
резервной копии нет, то Вам придется полностью
переустановить пакет MapInfo.
Файл MAPINFOW.MNU содержит несколько операторов Create Menu;
они и задают стандартную систему меню MapInfo (Ф
АЙЛ, ПРАВКА и
т.д.). Чтобы удалить один или несколько элементов меню, можно
просто удалить соответствующую строку из оператора Create Menu.
Например, команда MapInfo Т
АБЛИЦА > ИЗМЕНИТЬ обычно открывает
подменю с командами П
ЕРЕСТРОИТЬ, УДАЛИТЬ, ПЕРЕИМЕНОВАТЬ и
У
ПАКОВАТЬ.
Глава 6: Интерфейс пользователя
MapBasic Руководство пользователя
101
Изучив файл MAPINFOW.MNU, Вы обнаружите, что меню ИЗМЕНИТЬ
определено следующим образом:
Create Menu "&Изменить" As
"&Перестроить..." calling 404,
"У&далить..." calling 409,
"Пере&именовать..." calling 410,
"&Упаковать..." calling 403
...
Команда У
ДАЛИТЬ может быть Вам не нужна, и Вы хотите удалить ее из
меню И
ЗМЕНИТЬ. Для этого можно просто удалить соответствующую
строку (“У&далить..." Calling 409) из файла MAPINFOW.MNU; в
результате оператор Create Menu, описывающий меню И
ЗМЕНИТЬ,
примет следующий вид:
Create Menu "&Изменить" As
"&Перестроить..." calling 404,
"Пере&именовать..." calling 410,
"&Упаковать..." calling 403
...
При следующем запуске MapInfo меню Т
АБЛИЦА > ИЗМЕНИТЬ
предстанет в сокращенном виде:
Глава 6: Интерфейс пользователя
102 MapBasic Руководство пользователя
Аналогично, чтобы удалить меню полностью, со всеми командами,
нужно найти соответствующий оператор Create Menu Bar в меню MAP
INFOW.MNU и удалить его.
Если пакет MapInfo установлен на сети и Вы изменили файл MAPIN
FOW.MNU в том же каталоге, в котором установлена программа Map
Info, то изменения в системе меню распространятся на всех
пользователей MapInfo в сети. Этим можно воспользоваться,
например, для придания единообразия интерфейсу или для сокрытия
от не в меру активных пользователей потенциально опасных команд
типа У
ДАЛИТЬ.
Иногда требуется лишить пользователей некоторых прав, но оставить
эти права за собой или за администратором сети. Например, команду
У
ДАЛИТЬ можно скрыть от пользователей, но оставить в распоряжении
администратора.
Для того, чтобы создать персональный вариант файла MAPIN
FOW.MNU для отдельного пользователя, поместите его в личный
каталог пользователя. В системе Windows личный каталог – это тот, в
котором содержится файл WIN.INI.
Как только пользователь запускает MapInfo, то сначала проверяется
наличие файла MAPINFOW.MNU в личном каталоге пользователя.
Если файл MAPINFOW.MNU присутствует в личном каталоге, MapInfo
загружает из него систему меню. Если же в личном каталоге MAPIN
FOW.MNU не найден, то MapInfo загружает систему меню из каталога,
в котором установлен пакет MapInfo.
Таким образом, Вы можете добиться того, чтобы один вариант файла
MAPINFOW.MNU был доступен всем пользователям, а другие –
индивидуальным пользователям. Версия MAPINFOW.MNU,
предназначенная для общего пользования, помещается в один каталог
с MapInfo, а версии для индивидуальных пользователей – в их личные
каталоги.
Стандартные диалоговые окна
Диалоговые окна (или диалоги) являются существенным элементом
интерфейса. В арсенале MapBasic содержится несколько операторов и
функций, украшающих Вашу программу диалоговыми окнами:
Показ простого сообщения
Оператор Note показывает простейшее диалоговое окно с сообщением и
кнопкой OK.
Глава 6: Интерфейс пользователя
MapBasic Руководство пользователя
103
Показ диалога с двумя кнопками
Функция Ask( ) показывает диалог с вопросом и двумя кнопками. На
двух кнопках обычно написано "OK" и "Cancel", но Вы можете
использовать свои надписи. Если пользователь выберет кнопку "OK",
функция вернет логическую истину (TRUE) или вернет логическую
ложь (FALSE) в противном случае.
Диалог открытия файла
Функция FileOpenDlg( ) показывает стандартный диалог команды
Ф
АЙЛ > ОТКРЫТЬ. Если пользователь выберет один из файлов, то
функция вернет его имя. Если пользователь нажмет кнопку "Отмена",
функция возвратит пустую строку.
Функция FileOpenDlg( ) создает диалог, который выглядит так:
Глава 6: Интерфейс пользователя
104 MapBasic Руководство пользователя
Функция FileSaveAsDlg( ) показывает стандартный диалог
"Сохранить как", и возвращает имя файла, введенное пользователем.
Показ диалога>индикатора процента выполнения
Оператор ProgressBar показывает диалог с процентом выполнения и
кнопкой "Отмена".
Глава 6: Интерфейс пользователя
MapBasic Руководство пользователя
105
Показ только одной записи
В MapInfo нет стандартного диалога, который показывает только одну
запись из таблицы. Для этого можно использовать окно Информация.
Ниже в этой главе описано, как управлять этим окном из программы
MapBasic.
Более подробно упомянутые в этом разделе операторы и функции
описаны в Справочнике MapBasic. Если Вам недостаточно стандартных
диалоговых окон, воспользуйтесь оператором Dialog и постройте
собственное, новое диалоговое окно.
Новые диалоговые окна
Оператор Dialog описывает новый диалог. Когда этот оператор
выполняется, MapInfo показывает диалог и пользователь может с ним
взаимодействовать. Как только пользователь закрывает диалоговое
окно (кнопками "OK" или "Отмена"), MapInfo выполняет операторы,
следующие за оператором Dialog. После выполнения оператора Dialog
можно с помощью функции CommandInfo( ) определить, какой
кнопкой ("OK" или "Отмена") был закрыт диалог.
Все, что может появиться в диалоге, называется элементами. Каждый
элемент описывается отдельным предложением Control в операторе
Dialog. Например, следующий оператор создает диалог с четырьмя
элементами: текст (элемент StaticText); окошко, в которое
пользователь может ввести текст или числа (элемент EditText); кнопки
"OK" (элемент OKButton) и "Отмена" (элемент CancelButton).
Dim строка_поиска As String
Dialog
Title "Поиск"
Control StaticText
Title "Введите искомую строку:"
Control EditText
Into строка_поиска
Control OKButton
Control CancelButton
If CommandInfo(CMD_INFO_DLG_OK) Then
'
' ... если нажата кнопка "OK", то переменная типа
' String "строка_поиска" будет содержать
' значение, введенное пользователем.
Глава 6: Интерфейс пользователя
106 MapBasic Руководство пользователя
'
End If
Этот оператор Dialog показывает следующий диалог:
Размеры и положение элемента диалога
Для изменения ширины и высоты элемента диалога Вы должны
включить в его описательное предложение Control предложения Width
и Height соответственно. Если Вы хотите сменить положение элемента,
то включите в его описание предложение Position.
Например, Вы не удовлетворены видом предыдущего диалога и хотите
изменить положения и надписи на кнопках. Это достигается
применением предложений Position и Title (последнее заменяет
надпись на кнопке):
Dialog
Title "Поиск"
Control StaticText
Title "Введите искомую строку:"
Control EditText
Into строка_поиска
Control OKButton
Title "Найти"
Position 50, 30
Control CancelButton
Position 110, 30
Применение предложения Position в двух предложениях Control
изменяет вид диалога:
Глава 6: Интерфейс пользователя
MapBasic Руководство пользователя
107
Положение и размеры задаются в единицах измерения диалога.
Горизонтальная единица равна одной четверти ширины буквы
системного шрифта, а вертикальная – одной восьмой. За точку отсчета
с координатами 0, 0 принимается верхний левый угол диалога.
Следующее предложение Position определяет координаты в пять букв
от левого края диалога и в две буквы от верхнего края:
Position 20, 16
Значение горизонтальной позиции, равное 20, умноженное на четверть
ширины символа, определяет ширину в пять символов. Вертикальное
значение, равное 16, умноженное на одну восьмую высоты символа,
определяет высоту в два символа.
Предложение Position может присутствовать в описании каждого
элемента диалога. Так же и предложения Width и Height включаются
в описание элемента, размеры которого нужно изменить.
Элементы окна диалога
Предыдущие примеры представляли четыре вида элементов диалога
(текст, окошко ввода, кнопки подтверждения и отмены). Следующий
пример показывает все возможные в MapBasic элементы диалога.
Глава 6: Интерфейс пользователя
108 MapBasic Руководство пользователя
Элемент StaticText представляет из себя простую надпись, например:
Control StaticText
Title "Заголовок карты:"
Position 5, 10
Элемент EditText – это окошко, в которое можно вводить текст или
цифры. Например:
Control EditText
Value "Торговые точки"
Into maptitle
ID 1
Position 68, 8 Width 120
Элемент GroupBox создает рамку с надписью сверху. Рамки
выполняют декоративную функцию; они используются для собирания
в группы логически связанные элементы. Например:
Control GroupBox
Title "Уровень детализации"
Ɍɟɤɫɬ
StaticText
Ɋɚɦɤɚ
ɝɪɭɩɩɵ
(GroupBox)
ɉɟɪɟɤɥɸɱɚɬɟɥɢ(Ra
dioGroup)
ɋɩɢɫɨɤ
(ListBox)
Ʉɨɦɛɢɧɢɪɨ-ɜɚɧɧɵɣ
ɫɩɢɫɨɤ
(PopupMenu)
Ʉɧɨɩɤɚ
(Button)
Ɍɟɤɫɬɨɜɨɟ ɨɤɨɲɤɨ
(EditText)
Ʉɧɨɩɤɚ ɩɨɞɛɨɪɚ
(SymbolPicker)
ɋɩɢɫɨɤ ɞɥɹ
ɦɧɨɠɟɫɬɜɟɧ-ɧɨɝɨ
ɜɵɛɨɪɚ
(MultiListBox)
Ɏɥɚɠɨɤ
(CheckBox)
Ʉɧɨɩɤɚ ɩɨɞɬɜɟɪɠɞɟɧɢɹ
(OKButton)
Ʉɧɨɩɤɚ ɨɬɦɟɧɵ
(CancelButton)