MapBasic. Руководство пользователя
Подождите немного. Документ загружается.
MapBasic
®
Среда разработчика
Руководство
пользователя
MapInfo Corporation
Troy, New York
Information in this document is subject to change without notice and does not represent a commitment on the
part of the vendor or its representatives. No part of this document may be reproduced or transmitted in any
form or by any means, electronic or mechanical, including photocopying, without the written permission of
MapInfo Corporation, One Global View, Troy, New York 121808399.
1992–2002 MapInfo Corporation. All rights reserved. MapInfo, MapInfo Professional, MapBasic, and the
MapInfo Logo are registered trademarks of MapInfo Corporation.
Руccк ий перевод ООО ЭCТИМЭП 2002.
Adobe Acrobat® is a registered trademark of Adobe Systems Incorporated in the United States.
libtiff
1988–1995 Sam Leffler, copyright
1991–1995 Silicon Graphics, Inc.
libgeotiff
1995 Niles D. Ritter.
Portions Copyright
1999 3D Graphics, Inc. All Rights Reserved.
HIL – Halo Imaging Library™ Copyright 1993, Media Cybernetics Inc. Halo Imaging Library is a trademark of
Media Cybernetics, Inc.
Portions hereof LEAD Technologies, Inc.
1991–1997. All Rights Reserved.
Portions Copyright
1993–2002 Ken Martin, Will Schroeder, Bill Lorensen. All Rights Reserved.
This software uses patented LZW technology for .GIF image compression and/or decompression. (Unisys
United States patent No. 4,558,302 and corresponding patents in Canada, France, Germany, Italy, Japan and
the United Kingdom). GIF images compressed or decompressed for transmission via the Internet or via any
other online communication capability may not be sold or licensed for revenue, or used by an Internet Service
Provider or in paid advertisements unless the user first enters into a written license agreement with Unisys.
For information concerning licensing, please contact:
Unisys Corporation
Welch Licensing Department C1SW19
Township Line & Union Meeting Roads
P.O. Box 500 Blue Bell PA 19424
Blue Marble
1993–2002.
ECW by ER Mapper
1998–2002.
VMGrid by Northwood Technologies, Inc., a Marconi Company
1995–2002 ™.
Portions
2002 Earth Resource Mapping, Ltd. All Rights Reserved.
Portions of this software are copyrighted by MERANT, 1991–2002.
MrSID, MrSID Decompressor and the MrSID logo are trademarks of LizardTech, Inc. used under license.
Portions of this computer program are copyright (c) 1995–1998 LizardTech and/or the university of California
or are protected by US patent nos. 5,710,835; 5,130,701; or 5,467,110 and are used under license. All rights
reserved. MrSID is protected under US and international patent & copyright treaties and foreign patent
applications are pending. Unauthorized use or duplication prohibited.
Universal Translator by Safe Software, Inc.
2002.
Crystal Reports® is proprietary trademark of Crystal Decisions. All Rights Reserved.
Products named herein may be trademarks of their respective manufacturers and are hereby recognized.
Trademarked names are used editorially, to the benefit of the trademark owner, with no intent to infringe on the
trademark.
This documentation reflects the contributions of almost all of the women and men that work for MapInfo
Corporation. It was specifically produced by Gayle Patenaude and Marie Costa, with the help of Juliette
Funiciello, Colleen Cox, and Ed McElroy. Dave Smith, now back in Engineering, is the ‘godfather’ of this
volume. The Documentation Department is indebted to MapInfo’s Quality Assurance Department and, of
course, to all the members of the Product Development team that engineered this project.
MapInfo welcomes your comments and suggestions.
May 2002
MapInfo Corporate Headquarters: MapInfo Europe Headquarters: Germany:
Voice: (518) 2856000 Voice: +44 (0)1753 848 200 Voice: +49 (0)6142 203 400
Fax: (518) 2856060 Fax:+44 (0)1753 621 140 Fax: +49 (0)6142 203 444
Sales Info Hotline: (800) 3278627 email:uk@mapinfo.com email:germany@mapinfo.com
Federal Sales: (800) 6192333
Technical Support Hotline:
(518) 2857283
Technical Support Fax:
(518) 2856080
Tollfree telephone support is available in the U.S. and Canada. Contact your
MapInfo sales representative for details. For international customers, please
use the Technical Support Fax number.
СОДЕРЖАНИЕ
MapBasic Руководство пользователя
1
СОДЕРЖАНИЕ
СОДЕРЖАНИЕ
Глава 1: Введение . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Требования к системе и компьютеру . . . . . . . . . . . . . . . . . . . . . . . 6
Установка среды разработчика MapBasic . . . . . . . . . . . . . . . . . . . . 6
Стандартные имена файлов и типы файлов MapBasic . . . . . . . . . . 7
Установка документации MapBasic . . . . . . . . . . . . . . . . . . . . . . . . 8
Соглашения об обозначениях . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Глава 2: Обзор языка MapBasic . . . . . . . . . . . . . . . . . . . . . . . 13
Главные особенности языка MapBasic . . . . . . . . . . . . . . . . . . . . . 16
Как осваивать MapBasic?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Глава 3: Работа в интегрированной среде
разработки программ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Введение в интегрированную среду MapBasic . . . . . . . . . . . . . . . 22
Как ввести или отредактировать программу . . . . . . . . . . . . . . . . 22
Компиляция программ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Проект: Сборка приложения из нескольких модулей . . . . . . . . . 28
Обзор меню среды разработки программ MapBasic . . . . . . . . . . . 33
Глава 4: Основы языка MapBasic . . . . . . . . . . . . . . . . . . . . . 39
Общие замечания о синтаксисе языка MapBasic . . . . . . . . . . . . . 40
Переменные . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Выражения . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Циклы и другие управляющие операторы . . . . . . . . . . . . . . . . . . 59
Процедуры . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Процедурыобрабочики системных событий . . . . . . . . . . . . . . . . 69
Рекомендации по использованию процедуробработчиков
системных событий . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Функции, созданные пользователем. . . . . . . . . . . . . . . . . . . . . . . 74
Директивы компилятора . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Организация программ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Глава 5: Отладка и обработка ошибок . . . . . . . . . . . . . . . . . 79
Обработка ошибок . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Глава 6: Интерфейс пользователя . . . . . . . . . . . . . . . . . . . . . 87
Программная обработка событий . . . . . . . . . . . . . . . . . . . . . . . . . 89
Меню . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Стандартные диалоговые окна . . . . . . . . . . . . . . . . . . . . . . . . . . 102
СОДЕРЖАНИЕ
2 MapBasic Руководство пользователя
Новые диалоговые окна . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Окна. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Инструментальные панели . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Запуск программы в среде MapInfo. . . . . . . . . . . . . . . . . . . . . . . 135
Рекомендации по повышению производительности . . . . . . . . . 137
Глава 7: Работа с таблицами . . . . . . . . . . . . . . . . . . . . . . . . . 139
Открытие таблиц с помощью MapBasic. . . . . . . . . . . . . . . . . . . . 140
Создание файла отчета из открытой таблицы MapInfo . . . . . . . 142
Запись значений в таблицу . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Создание новых таблиц . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Изменение структуры таблицы . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Работа с таблицей Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Доступ к Косметическому слою с помощью таблицы “CosmeticN" 156
Доступ к окнам Отчетов с помощью таблиц “LayoutN" . . . . . . 156
Редактирование в многопользовательской среде . . . . . . . . . . . . 157
Файлыкомпоненты таблицы . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Таблицы, содержащие растровые изображения . . . . . . . . . . . . 163
Работа с метаданными . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Работа со сшитыми таблицами . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Доступ к удаленным данным. . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Доступ и изменения в удаленных базах данных при
помощи связанных таблиц . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Прямой доступ к удаленным базам данных . . . . . . . . . . . . . . . . 174
Рекомендации по повышению производительности при
работе с таблицами . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Глава 8: Ввод/Вывод в файлы . . . . . . . . . . . . . . . . . . . . . . . 177
Обзор файлового ввода/вывода . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Файлы последовательного доступа . . . . . . . . . . . . . . . . . . . . . . . 180
Файлы произвольного доступа . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Двоичные файлы . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Особенности работы с файлами в различных операционных системах и с
национальными наборами символов . . . . . . . . . . . . . . . . . . . . . 183
Функции, имеющие дело с режимами файлового ввода/вывода 185
Глава 9: Графические объекты . . . . . . . . . . . . . . . . . . . . . . . 187
Переменные типа Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Работа с колонкой “Obj" . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Определение атрибутов объекта . . . . . . . . . . . . . . . . . . . . . . . . . 191
СОДЕРЖАНИЕ
MapBasic Руководство пользователя
3
Создание новых объектов . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Создание новых объектов на основе уже существующих . . . . . 202
Изменение объектов. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Работа с подписями . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Координаты и единицы измерения . . . . . . . . . . . . . . . . . . . . . . 211
Географические запросы . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Глава 10: Особенности MapBasic в среде
Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Добавление Справочной системы к Вашему приложению . . . . 237
Глава 11:Интегрированная Картография . . . . . . . . . . . . . . . 239
Как выглядит приложение с Интегрированной Картой? . . . . . 240
Концепции Интегрированной Картографии . . . . . . . . . . . . . . . 241
Технические аспекты Интегрированной Картографии . . . . . . . 243
Простейший пример . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Подробное обсуждение Интегрированной Картографии . . . . . . 245
Использование уведомляющих вызовов (Callbacks) для получения
информации из MapInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Другие способы использования уведомлений . . . . . . . . . . . . . . 260
Справочная система . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Полезные операторы и функции языка MapBasic . . . . . . . . . . . 262
Объектная модель механизма управления объектами OLE. . . . 264
Аргументы командной строки MapInfo . . . . . . . . . . . . . . . . . . . 276
Введение в Интегрированную Картографию с
поддержкой Visual C++ и MFC . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Добавление кнопок и процедуробработчиков . . . . . . . . . . . . . . 283
Где получить дополнительную информацию . . . . . . . . . . . . . . . 288
Приложение A: Примеры программ . . . . . . . . . . . . . . . . . . . 291
Приложение B: Действия операторов . . . . . . . . . . . . . . . . . . 295
Приложение C: Что нового в MapBasic 7.0 . . . . . . . . . . . . . . 299
Приложение D: Поддерживаемые типы таблиц ODBC . . . . 301
Приложение E: Присвоение геоинформации
удаленной таблице . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Создание каталога Карт MapInfo . . . . . . . . . . . . . . . . . . . . . . . . 304
Приложение F: Установка и управление данными . . . . . . . 307
СОДЕРЖАНИЕ
4 MapBasic Руководство пользователя
Глава
Глава 1: Введение
Введение
Ãëàâà 1: Ââåäåíèå
Добро пожаловать в среду
разработчика MapBasic 7.0, мощный и
одновременно простой в использовании
язык программирования, который
позволит Вам создавать собственные
приложения в среде MapInfo
Professional. В этой главе будет
описана процедура установки
MapBasic. Общая информация о
возможностях и назначении языка
MapBasic начинается с главы 2: "Обзор
языка MapBasic".
>Требования к системе
>Установка MapBasic
>Стандартные имена
файлов и типы файлов
MapBasic
>Соглашения об
обозначениях
1
Глава 1: Введение
6 MapBasic Руководство пользователя
Требования к системе и компьютеру
Требования к системе
Чтобы использовать MapBasic для Windows, Ваш компьютер должен
удовлетворять следующим требованиям::
Совместимость между версиями
Программы, созданные в ранних версиях MapBasic, будут работать под
Mapinfo Professional.
Смотрите более подробную информацию:
• Приложение C: Новое в версии MapBasic 7.0
• Приложение F: Установка и управление данными
Установка среды разработчика MapBasic
Перед тем как начать
Процедура установки MapBasic описана ниже. Сделайте следующее:
• Установите MapInfo перед установкой MapBasic. Внимательно
прочитайте в Руководстве пользователя MapInfo как это
правильно сделать.
• Запишите серийный номер MapBasic в месте, где его легко
обнаружить в случае необходимости.
Требования
Операционная
система
Microsoft Windows XP/2000/98 или Windows NT 4.0/
2000
Дисплей Любой адаптор дисплея поддерживаемый Windows
Мышь Мюбая мышь поддерживаемая Windows
Жесткий диск 10 Mb
Глава 1: Введение
MapBasic Руководство пользователя
7
Установка
1. Вставьте компакт диск с MapInfo Pro CD дисковод, выберите
Установку MapBasic 7.0 и следуйте инструкциям в экранных
диалогах.
По умолчанию MapBasic устанавливается в директорию под
MapInfo (т.е. C:\MAPINFO\MAPBASIC\MAPBASIC.EXE)
.
Если компакт диск автоматически не запускается, то нажмите Setup.
Запуск MapBasic
Чтобы запустить среду разработки MapBasic,
1. Выполните команду Windows ПУСК>ПРОГРАММЫ
2. Чтобы запустить MapBasic, выберите MapBasic из программной
группы MapInfo.
Можно проверить, нуждается ли MapBasic в обновлении, для этого
выполните команду
СПРАВКА > ПРОВЕРИТЬ ВЕРСИЮ.
Стандартные имена файлов и типы файлов MapBasic
Процедура установки языка MapBasic переносит на Ваш компьютер
следующие стандартные файлы:
errors.doc: Текстовый файл со списком сообщений об ошибках MapBasic
mapbasic.exe: Исполняемый файл, позволяющий Вам работать в среде
MapBasic
mapbasic.def: Файл заголовков, содержащий объявления стандартных
переменных
menu.def: Файл заголовков, содержащий объявления стандартных
переменных, относящихся к системе меню MapInfo
icons.def: Файл заголовков, содержащий объявления стандартных
переменных, относящихся к виду кнопок и курсоров в MapInfo
mapbasic.hlp: Справочный файл по языку MapBasic
mapbasic.h: Файл заголовков для программистов на языках C/C++;
аналогичен MAPBASIC.DEF
mapbasic.bas: Файл заголовков для программистов на языке Visual Basic;
аналогичен MAPBASIC.DEF
mapbasic65.isu Файл для удаления MapBasic.
mbres650.dll Часть программной среды; содержит ресурсы диалоги и строки.
milib650.dll Часть программной среды; содержит выполняемый код XVT
Глава 1: Введение
8 MapBasic Руководство пользователя
При работе в среде MapBasic используются следующие стандартные
расширения:
Установка документации MapBasic
В дополнение к Руководству пользователя, документация MapBasic
включает в себя электронную версию этой книги, электронную версию
Справочника и электронную Справочную систему.
Справочник MapBasic
®
Электронный справочник MapBasic является полным описание команд
и функция языка MapBasic. Смотрите Главу 24, Использование окна
MapBasic, в этой главе обсуждается, какие команды MapBasic могут
использоваться в этом окне.
Установка электронной документации
Можно пользоваться доступом к электронным Справочнику MapBasic
или Руководству пользователя с компакт диска MapBasic, или
установить программу Adobe
®
Acrobat Reader для локального доступа к
документации.
Для локальной установки документации на Ваш компьютер:
1. Установите Acrobat
®
Reader.
2.
Скопируйте с компакт диска файлы из папки
[CD_ROM]:\PDF_DOCS в папку на компьютере.
papersize.def Файл для разработчиков программ в MB; содержит определения
для управлением печатью операторами MapBasic
usrinfmb.log Содержит информацию для процесса установки.
samples folder содержит примеры программ filename.mb, filename.mbp;
filename.mb Программный файл (исходный текст на языке
MapBasic)
filename.mbx Откомпилированный (выполняемый) файл
filename.mbp Файл описания модулей (содержит список всех
модулей, собираемых в единую программу)
filename.mbo Объектный файл (создается при сборке программы из
нескольких модулей)
filename.err Список сообщений об ошибках, полученный при
компиляции программы, записанной на диске.
errors.doc: Текстовый файл со списком сообщений об ошибках MapBasic