MapBasic. Руководство пользователя
Подождите немного. Документ загружается.
Глава 11:Интегрированная Картография
MapBasic Руководство пользователя
259
CommandInfo(5) + ”,” + CommandInfo(6) + ”,” +
CommandInfo(7) + ”,” + CommandInfo(8)
Предположим, что Ваше приложение добавляет команду меню к
локальному меню MapInfo. Каждый раз, когда пользователь выбирает
команду меню, MapInfo посылает OLEметоду строку. Если команда
меню имеет номер 101, строка будут выглядеть следующим образом:
”MI:,,,,,,,101”
В этом случае большинство элементов строки пусто, потому что
функция CommandInfo( ) может возвращать только эту одну часть
информации.
Теперь предположим, что Вы создаете кнопку панели MapInfo, которая
позволяет пользователю линии на Карте. Строка теперь будет
выглядеть следующим образом:
”MI:73.5548,42.122,F,F,72.867702,43.025,202,”
Теперь строка включает несколько элементов. Первые два элемента
содержат x– и y–координаты точки, на которую пользователь указал
мышкой; следующие два элемента сообщают, была ли нажата клавиша
SHIFT или CTRL; следующие два элемента содержат координаты
точки, где пользователь отпустил кнопку мышки; и последний элемент
указывает номер идентификатора кнопки.
Внимание: Если Вы приписываете уникальный идентификатор
каждой из Ваших кнопок, Вы можете сделать так, что все
кнопки будут вызывать один и тот же метод. Ваш метод может
определять, какая из кнопка вызвала его, используя восьмой
аргумент в переданной строке.
Разбор содержания строки возлагается на Ваше приложение.
Синтаксис C/C++ для функций уведомления
В предыдущем разделе были описаны обратные вызовы в контексте
Visual Basic. Здесь мы рассмотрим синтаксис языка C.
Если Вы используете метод MapInfo SetCallback, MapInfo может
автоматически генерировать обратные вызовы для Вашего объекта
IDispatch. Обратные вызовы стандарта MapInfo имеют следующий
синтаксис:
SCODE SetStatusText(LPCTSTR lpszMessage)
MapInfo вызывает метод SetStatusText всякий раз, когда изменяется
содержание строки сообщений в MapInfo. Единственный аргумент –
текст сообщения в строке состояний.
SCODE WindowContentsChanged(Unsigned Long windowID)
Глава 11:Интегрированная Картография
260 MapBasic Руководство пользователя
MapInfo вызывает метод WindowContentsChanged всякий раз, когда
изменяется содержание окна Карты. Единственный аргумент
представляет собой идентификатор этого окна. Этот повторный вызов
аналогичен процедуре MapBasic WinChangedHandler.
Другие способы использования уведомлений
Как говорилось ранее, MapInfo может использовать обратные вызовы
OLE, чтобы послать информацию Вашей клиентской программе. В
некоторых случаях, однако, Вы должны применять повторные
вызовы, которые не используют OLE. Например, если Вы пишете
программы в Visual Basic 3.0, Вы не можете использовать OLE, потому
что Visual Basic 3.0 не позволяет создавать Ваши собственные серверы
Автоматизации OLE.
MapInfo поддерживает два типа уведомлений, которые не используют
механизм OLE: использующие DDE, и использующие приложения
MapBasic (файлы MBX).
Обратные вызовы DDE
Когда Вы создаете кнопки на инструментальной панели или команды
меню, Вы указываете предложение Calling. Чтобы пользоваться
обратным вызовом посредством DDE, используйте синтаксис вызова
DDEсервера. Всякий раз, когда пользователь использует кнопку или
команду меню, MapInfo открывает DDEсвязь с DDEсервером, и затем
посылает строку Вашему объекту. Строка использует формат,
обсужденный в предыдущей секции (например, " MI:,,,,,, 101 ").
Пример смотрите в программе FindZip. Процедура Form Load посылает
MapInfo оператор Alter ButtonPad ... Add с предложением
Calling DDE ”FindZip”, ”MainForm”
Всякий раз, когда пользователь применяет инструмент, MapInfo
открывает DDE связь с программой FindZip и посылает строку "Main
Form" объекту. ("MainForm" – значение свойства формы LinkTopic).
Подробнее смотрите в Главе 11.
Обратные вызовы MBX
Если Вы создаете приложение MapBasic (файл MBX), Вы можете
сконструировать Ваши кнопки и команды меню так, чтобы они
вызвали MapBasic процедуры в MBX. В предложении вызова
используйте синтаксис вызова процедуры
Calling MapBasic
программы.
После того, как Ваше приложение на языке Visual Basic запустит Map
Info, запустите MBX, послав MapInfo строку вида:
mapinfo.do ”Run Application ””C:\MB\MYAPP.MBX”” ”
Подробности о создании кнопок и команд меню смотрите в главе 6.
Глава 11:Интегрированная Картография
MapBasic Руководство пользователя
261
Справочная система
Приложение с Интегрированной Картой может активировать окна диа
лога MapInfo посредством OLEметода RunMenuCommand. Если Ваше
приложение, таким образом, активизирует окно диалога MapInfo, Вы
можете контролировать доступность Справочной системы для этого
окна.
Вызов стандартного Справочного файла MapInfo
Вы можете разрешить Вашим пользователям вызов стандартного
Справочного файла MapInfo из диалогового окна. Такая конфигурация
принимается по умолчанию. Если пользователь нажимает клавишу F1
в активном окне диалога MapInfo, Справочная система выводит на дис
плей соответствующий раздел стандартного Справочного файла Map
Info MAPINFOW.HLP.
Внимание: После вывода на дисплей окна Справки MapInfo
пользователь может щелкать по различным навигационным
кнопкам для просмотра Справочного файла. Пользователи
могут посчитать такую конфигурацию неудобной, так как в
Справочном файле MapInfo описан пользовательский
интерфейс MapInfo, а не пользовательский интерфейс Вашего
приложения с Интегрированной Картой.
Запрещение вызова Справочной системы
Вы можете полностью запретить вызов Справочной системы для диало
говых окон MapInfo выдачей следующего оператора языка MapBasic:
Set Window Help Off
После исполнения оператора Set Window Help Off нажатие клавиши
F1 в активном окне диалога MapInfo игнорируется.
Вызов специализированного Справочного файла
Вы можете сконфигурировать MapInfo для вызова Справочной систе
мой специализированного Справочного файла. Например, следующий
MapBasicоператор указывает MapInfo на необходимость использова
ния Справочного файла CUSTOM.HLP вместо MAPINFOW.HLP:
Set Window Help File ”CUSTOM.HLP” Permanent
После исполнения оператора Set Window Help File...Permanent нажа
тие клавиши F1 приводит к вызову приложением MapInfo Справочной
системы Windows, но при этом на дисплей выводится специфицирован
ный Вами Справочный файл вместо Справочного файла MAPIN
FOW.HLP. Используйте такую конфигурацию, если Вы хотите
обеспечить Справку для одного или нескольких окон диалога MapInfo,
но при этом не желаете предоставлять пользователю доступ ко всему
содержимому стандартного Справочного файла MapInfo.
Глава 11:Интегрированная Картография
262 MapBasic Руководство пользователя
Если Вы хотите предоставить специализированную Справку для окон
диалога MapInfo, Вы должны обеспечить соответствие контекстных
IDномеров (Context ID) в Вашем Справочном файле IDномерам диало
говых окон MapInfo. Для определения IDномера диалогового окна
MapInfo:
1. Запустите MapInfo с аргументом helpdiag в командной строке.
2. Активируйте диалог MapInfo, для которого Вы хотите создать
Справку.
3. Нажмите клавишу F1. Вследствие использования аргумента
helpdiag вместо отображения Справочного файла MapInfo
покажет IDномер диалога, который Вам следует записать.
4. Используя программное обеспечение создания Справочных
файлов, отредактируйте Ваш Справочный файл таким образом,
чтобы IDномер темы в Вашем файле совпадал с IDномером
соответствующего окна диалога MapInfo.
Например, диалоговое окно MapInfo “Поиск” имеет IDномер 2202.
Если Вы хотите обеспечить вывод Вашей собственной Справки для
этого окна, присвойте значение 2202 контекстному IDномеру (Context
ID) соответствующей темы Вашего Справочного файла.
Учтите следующие факторы:
• В комплект поставки языка MapBasic не включен компилятор
Справочных файлов в формате Windows (.HLP).
• IDномера диалоговых окон MapInfo могут быть изменены в
будущих версиях программы.
Полезные операторы и функции языка MapBasic
В этом разделе перечислены некоторые операторы и функции языка
MapBasic, применение которых особенно полезно в приложениях с
Интегрированной Картой. Детальное обсуждение этих операторов и
функций смотрите в Справочнике MapBasic или Справочной системе.
Имя оператора или
функции
Описание
Create Legend Создает новое окно Легенды; позволяет Вам
создать окно Легенды как подчиненное окно
Вашей программы.
Map Создает новое окно Карты.
MenuitemInfoByID( )
MenuitemInfoByHandler( ),
Возвращает статус команды меню в MapInfo
(отмечена галочкой или нет).
Глава 11:Интегрированная Картография
MapBasic Руководство пользователя
263
Open Table Открывает таблицы MapInfo.
RemoteQueryHandler( ) Позволяет MapBasicпрограммам обрабатывать
запросы на чтение от DDEклиентов.
Run Menu Command Имитирует выбор пользователем команды меню
MapInfo или кнопки на инструментальной
панели (ButtonPad).
SearchInfo( ) Возвращает информацию о результатах
исполнения функций SearchPoint( ) и
SearchRect( ).
SearchPoint( ), SearchRect( ) Осуществляют поиск в выбранных слоях окна
Карта объектов в точке с заданными
координатами (x,y) или в заданной
прямоугольной области соответственно. Эти
функции позволяют Вам эмулировать
инструменты MapInfo Информация и Подпись.
Set Application Window Обеспечивает переподчинение окон диалога и
сообщений об ошибках MapInfo. Выдайте этот
оператор в Вашей клиентской программе после
запуска MapInfo или подключения к
работающему экземпляру MapInfo.
Set Map Управляет различными режимами
представления окон типа Карты.
Set Next Document Переподчиняет окно MapInfoдокумента
(например, окно Карты или Легенды) так, что
оно становится порожденным окном Вашей
программыклиента.
Set Window Управляет различными режимами
представления окон MapInfo.
Shade, Set Shade Создает или изменяет тематические слои Карты.
SystemInfo( ) Некоторые значения, возвращаемые этой
функцией, предназначены специально для
Интегрированной Картографии.
Пример: задайте в качестве аргумента
SYS_INFO_APPLICATIONWND, чтобы
получить HWNDномер приложения.
WindowID( )
WindowInfo( )
Возвращают информацию об окнах MapInfo, в
том числе переподчиненных.
Имя оператора или
функции
Описание
Глава 11:Интегрированная Картография
264 MapBasic Руководство пользователя
Объектная модель механизма управления объектами
OLE
На следующей диаграмме приведена схема MapInfo 6.5 OLE Automation
Type Library.
Методы и Свойства (Properties) детально описываются на
следующих страницах
.
Объект Application (Приложение) представляет работающий экзем
пляр MapInfo.
Семейство MBApplications (MapBasicПриложения) представляет спи
сок MapBasicприложений, работающих в данный момент.
Семейство MBGlobals (Глобальные переменные в среде MapBasic)
представляет список глобальных переменных, объявленных одним из
работающих MapBasicприложений.
Глава 11:Интегрированная Картография
MapBasic Руководство пользователя
265
Следующая диаграмма показывает дополнительные объекты возможные в
MapInfo’s 6.5 OLE Automation Type Library. Методы и Свойства описываются
в дальнейшем.
Objects Methods Properties
TableName, Rows,
Fields
Object
Object and Collection
MIMapGen
MISearchInfo
MIRows
MIFields
MISelection
MIRows
MIFields
Workspace, MBApp,
LongLat, SuppressDlgs,
ImageWidth, ImageHeight,
CenterX, CenterY, Zoom
ZoomCenterMap, RenderMap, ZoomMap,
ClickCenterMap, ClickCenterZoomMap,
ClearCosmeticLayer, SQLUnselectAll,
SearchRadius, SearchRadiusExt, SearchPoint,
SearchRect, GetTable, ExportMap,
ExportMapEx, RefreshProperties,
ScreenToMap, MapGenHandler
Value
Name, Type, Width,
DecimalPlaces
TableName, Rows,
Fields
Value
Name, Type, Width,
DecimalPlaces
Do, Eval,
RunCommand,
RunMenuCommand,
DataObject,
SetCallBack
Name, FullName,
Application, Parent,
Version, ProductLevel,
Visible, LastErrorCode,
LastErrorMessage
Application
Объекты Методы Свойства
MISearchInfo
MIFields
MIFields
Глава 11:Интегрированная Картография
266 MapBasic Руководство пользователя
Свойства объекта Application
В следующей таблице перечислены свойства, применимые к объекту
Application. Все свойства в этой таблице разрешены только для чтения,
за исключением свойств Visible и LastErrorCode.
Имя свойства Функциональность
Name Возвращает имя приложения (например, “MapInfo”).
Стандартное свойство OLE.
Свойство по умолчанию для объекта Application.
FullName Возвращает полный маршрут к исполняемому файлу
приложения. Стандартное свойство OLE.
Application Возвращает значение IDispatch объекта Application.
Стандартное свойство OLE.
Parent Возвращает значение IDispatch порождающего объекта;
для объекта Application возвращает себя самого.
Стандартное свойство OLE.
Version Возвращает текстовое представление номера текущей
версии, умноженного на 100 (например, MapInfo 6.0.0
возвращает “600”).
ProductLevel Возвращает целое значение, обозначающее “уровень”
программы MapInfo. Для MapInfo Professinal возвращает
200.
Visible Разрешена для записи. Логическое значение,
контролирующее видимость окна приложения.
Считывание позволяет определить видимость окна;
присваивание свойству значения устанавливает видимость
или невидимость окна.
LastErrorCode Разрешено для записи/чтения. Целое значение,
указывающее кодовый номер последней MapBasicошибки,
случившейся в процессе вызова метода Do, Eval или
RunCommand. Коды ошибок, возвращаемые этим
свойством, превышают на 1000 соответствующие коды
ошибок в среде MapBasic. Эти коды ошибок автоматически
заменяются кодом следующей ошибки, но никогда
автоматически не сбрасываются в 0.
LastErrorMessage Возвращает строку, представляющую текст сообщения об
ошибке, соответствующей значению LastErrorCode.
Глава 11:Интегрированная Картография
MapBasic Руководство пользователя
267
Методы объекта Application
Например, следующая VBинструкция использует метод Do для
передачи программе MapInfo оператора Map, открывающего окно
Карта:
mapinfo.Do ”Map From World”
Следующая инструкция использует метод RunMenuCommand для
выполнения команды меню MapInfo, имеющей значение кода 1702,
которая выбирает MapInfoинструмент Ладошка. (Для определения
конкретного значения кода интересующей Вас команды меню
смотрите файл MENU.DEF; 1702 является значением кода
M_TOOLS_RECENTER.)
Имя метода Имя метода
Do( string ) Интерпретирует строку string как оператор языка
MapBasic, затем выполняет этот оператор.
Eval( string ) Интерпретирует строку string как MapBasicвыражение,
вычисляет выражение и возвращает его значение. Если
выражение логическое, то возвращает “T” или “F”.
RunCommand( string
)
Интерпретирует строку string как оператор языка
MapBasic; является синонимом “Do”.
RunMenuCommand(
menuid )
Исполняет команду меню, указанную аргументом menuid
типа Integer. Пример смотрите ниже
DataObject( windowID
)
По целочисленному IDномеру окна windowID возвращает
интерфейс IUnknown, представляющий это окно. Для
получения графического представления окна в виде
метафайла используйте QueryInterface для интерфейса
IDataObject. Только значения Idata и ObjectIUnknown
разрешены для этого объекта.
Замечание: Это “продвинутая” возможность для
программистов, использующих язык программирования C.
Смотрите далее в этой главе “Уведомления вызывающего
приложения“.
SetCallBack(
IDispatch )
Регистрирует объект механизма управления объектами
OLE (OLE Automation) как получатель уведомлений,
генерируемых программой MapInfo. Только одна функция
уведомления может быть зарегистрирована в каждый
данный момент.
Замечание: Это “продвинутая” возможность для
программистов, использующих язык программирования C.
Смотрите далее в этой главе “Уведомления вызывающего
приложения".
Глава 11:Интегрированная Картография
268 MapBasic Руководство пользователя
mapinfo.RunMenuCommand 1702
Свойства семейства MBApplications
Семейство MBApplications включает в себя все MapBasicприложения,
работающие в среде MapInfo в данный момент. Все свойства,
перечисленные в следующей таблице, разрешены только для чтения.
Свойства объекта в семействе MBApplications
Каждый объект в семействе MBApplications является работающим
MapBasicприложением. Для все свойств, перечисленных в следующей
таблице, разрешено только чтение.
Имя свойства Функциональность
Item Возвращает значение IDispatch конкретного объекта
programobject. Аргумент имеет тип VARIANT,
который может приводиться к целочисленному
индексу в диапазоне (1..Count) или строковому
значению (имя программы). Является стандартным
свойством для семейства MBApplications.
Count Возвращает длинное целое число объектов в
семействе (т.е. число работающих приложений).
Application Возвращает значение IDispatch приложения Map
Info.Стандартное свойство OLE..
Parent Возвращает значение IDispatch порождающего
объекта; для семейства MBApplications это
приложение MapInfo.
Стандартное свойство OLE.
Имя свойства Функциональность
Name Возвращает имя приложения (например,
“FOO.MBX”).
Стандартное свойство OLE для объекта
MBApplication.
FullName Возвращает полный DOSмаршрут к исполняемому
.MBX файлу MapBasicприложения.
Стандартное свойство OLE.
Application Возвращает значение IDispatch MapBasic
приложения.
Стандартное свойство OLE.
Parent Возвращает значение IDispatch порождающего
объекта; для programobject это приложение MapInfo.
Стандартное свойство OLE.