MapBasic. Руководство пользователя
Подождите немного. Документ загружается.
Глава 10: Особенности MapBasic всреде Microsoft Windows
MapBasic Руководство пользователя
229
В среде Windows новые пиктограммы помещаются в файле DLL. Перед
тем как разрабатывать свои пиктограммы, нужно создать DLLфайл
или воспользоваться имеющимся. Такой DLLфайл может быть
“пустышкой" (т.е. файл, который не содержит никаких процедур).
Для пиктограммы на кнопке можно создать две растровые картинки.
Первая картинка должна быть размером 18 пикселов в ширину на 16
пикселов в высоту; эта картинка предназначена для показа на экране с
относительно низким разрешением. Вторая картинка имеет размеры
26 на 24 пикселов; она предназначена для экранов с высоким
разрешением (например, 1024 x 768). Вы должны обязательно создать
обе картинки, даже если одна Вам не нужна. В MapInfo можно
включать режим “Большие кнопки” в диалоге команды Н
АСТРОЙКИ >
И
НСТРУМЕНТАЛЬНЫЕ ПАНЕЛИ.
Создание пиктограммы состоит из следующих этапов:
• Подобрать или создать DLLфайл, в который будут помещены
новые пиктограммы.
• Открыть этот DLLфайл в редакторе ресурсов, таких, как
AppStudio.
• Для каждой пиктограммы создать две растровые картинки
(BMPресурс): одну размером 18 пикселов в ширину на 16
пикселов в высоту и другую размером 26 на 24 пикселов.
• Не забывайте, что создается ресурс типа “курсор”, а не
“иконка”.
• Назначить последовательные номера (ID) обоим растровым
ресурсам. Например, если Вы назначили ID равный 100
картинке 18 X 16 пикселов, то картинке 26 x 24 пикселов нужно
присвоить IDномер равный 101.
Создав пару растровых ресурсов, Вы можете в приложении MapBasic
использовать их с помощью операторов Create ButtonPad и Alter
ButtonPad. Из текста программы Вы должны обращаться к меньшей
(18 на 16) картинке. Например, если Вы назначите IDномера 100 и 101
новой пиктограмме, то программа должна обращаться к номеру 100,
как показано в следующем примере:
Alter ButtonPad "Программы"
Add PushButton
Icon 100 File "MBICONS1.DLL"
HelpMsg "Добавить новую запись"
Calling new_route
Show
Глава 10: Особенности MapBasic всреде Microsoft Windows
230 MapBasic Руководство пользователя
DLLфайл, в котором помещаются пиктограммы (в примере выше это
MBICONS1.DLL), должен быть установлен в Вашей системе по одному
из следующих маршрутов: в том же каталоге, что и MBXфайл,
который его использует; в личном каталоге пользователя; в каталоге,
содержащем пакет файлов MapInfo; в каталогах WINDOWS или
WINDOWS\SYSTEM. Если MapInfo не находит DLLбиблиотеку ни в
одном из этих каталогов, то поиск продолжается по каталогам,
описанным в системной переменной PATH.
Вы можете, разумеется, явно указать каталог.
Функции ProgramDirectory$( )и ApplicatopnDirectory$( ) помогут Вам
построить нужные имена каталогов из MBXпрограммы.
Создание новых курсоров в Windows
Процесс создания нового курсора почти в точности повторяет процесс
создания пиктограммы, описанный выше. Курсор, правда, имеет
несколько особенностей, например, “точку указывания” (“hot spot").
Новый курсор помещается в виде CURSORресурса в DLLфайл. Вы
можете помещать в один DLLфайл как CURSORресурсы, так и BMP
ресурсы.
Связь между приложениями с использованием DDE
Связь между приложениями является обобщенным термином для
обмена информацией между отдельными пакетами программ. Windows
поддерживает ее через протокол Динамического обмена данными,
обычно известный как DDE.
Если два приложения Windows оба поддерживают DDE, приложения
могут обмениваться командами и данными. Например, Windows
программа типа Microsoft Excel, может дать команду MapInfo
(например, Map From world).
Обзор DDE>обмена
DDEсвязь – процесс, который может происходить между двумя
приложениями Windows. Оба приложения должны быть запущены, и
оба должны поддерживать протокол DDE. В одном сеансе обмена могут
участвовать только две программы; однако, программы (MapInfo, Excel
и другие) могут одновременно участвовать во многих сеансах.
В диалоге одно приложение активно; это начинает диалог. Это
приложение называется клиентом. Другое, пассивное, приложение
называется сервером. Клиент управляет обменом; например, посылает
инструкциизапросы серверу. Сервер только выполняет команды и
отсылает запрошенные данные.
Глава 10: Особенности MapBasic всреде Microsoft Windows
MapBasic Руководство пользователя
231
MapBasic как DDE>клиент
Язык MapBasic поддерживает следующие операторы и функции,
позволяющие приложению MapBasic действовать как клиент при DDE
обмене.
См. также описание этих операторов и функций в Справочнике
MapBasic.
Для того, чтобы начать сеанс DDEобмена, нужно вызвать функцию
DDEInitiate( ). Функции DDEInitiate( ) нужно задать два параметра:
имя приложения application и название объекта topic.
Обычно параметр application – это имя сервера (например, имя “Excel”
при DDEобмене обозначает Microsoft Excel). Список параметров topic
зависит от программы. Обычно, параметром topic бывает имя файла
или документа, открытого программойсервером.
Например, пусть в Excel открыта таблица TRIAL.XLS, тогда
приложение MapBasic может начать сеанс обмена следующими
операторами:
Dim channelnum As Integer
channelnum = DDEInitiate("Excel", "TRIAL.XLS")
В этом примере Excel – имя приложения (application), а TRIAL.XLS –
имя объекта (topic).
Многие программы, поддерживающие DDE (и MapInfo тоже),
поддерживают специальный объект по имени “System”. Начав сеанс
обмена с использованием объекта ”System”, Вы впоследствии можете в
этом сеансе получить список всех доступных объектов.
Каждый сеанс DDE обменивается данными через собственный
уникальный канал (channel). Функция DDEInitiate( ) возвращает
номер канала в виде целого числа. Этот номер в дальнейшем
используется другими операторами DDE–обмена.
DDEInitiate( ) Открывает сеанс обмена;
DDERequest$( ) Запрашивает информацию у сервера;
DDEPoke Посылает информацию серверу;
DDEExecute Посылает серверу команды;
DDETerminate
DDETerminateAll
Закрывает один или все сеансы DDEобмена.
Глава 10: Особенности MapBasic всреде Microsoft Windows
232 MapBasic Руководство пользователя
После установления связи приложение MapBasic может посылать
команды серверу посредством оператора DDEExecute. Например,
приложение MapBasic может заставить программусервер открывать
или закрывать файлы.
Используя функцию DDERequest$( ), приложение MapBasic
запрашивает информацию у сервера. При вызове DDERequest$( )
нужно определить имя элемента (item), чтобы сервер точно определил,
какую именно информацию от него требуют. Например, если сервером
является электронная таблица, то запрашиваемым элементом может
быть имя ячейки.
Используя функцию DDEPoke, можно посылать информацию
программесерверу. Послание данных из приложения MapBasic через
DDEсвязь имитирует ввод данных пользователем в соответствующий
документ программысервера. В следующем примере приложение
MapBasic помещает фразу “Привет, друзья!" в ячейку электронной
таблицы.
DDEPoke channelnum, "R1C2", "Привет, друзья!"
При вызове функции DDEPoke нужно точно задавать имя элемента,
принимающего данные (в примере это R1C2, т.е. Строка 1, Столбец 2).
Когда все работы по DDEсвязи выполнены, обмен должен быть
завершен клиентом (приложением MapBasic), для чего выполняются
операторы DDETerminate или DDETerminateAll. Оператор
DDETerminate закрывает один канал DDEобмена; DDETerminateAll
закрывает все DDEканалы, открытые из данного приложения. При
этом другие приложения MapBasic, поддерживающие в это время свои
сеансы DDEобмена, не затрагиваются.
Когда приложение MapBasic является клиентом, то во время работы
может порождаться ошибка, если сервер долгое время не отвечает.
Время, которое сервер может не отвечать клиенту без порождения
ошибки, устанавливается в WIN.INI – стартовом файле Windows.
MapInfo создает раздел [MAPINFO] в WIN.INI и задает время задержки
в строке DDETimeout:
DDeTimeout=10000
Число представляет собой количество миллисекунд; стандартное
значение времени задержки равно десяти тысячам (десять секунд).
Если приложениеклиент часто исчерпывает время ожидания в
сеансах DDEсвязи, и порождается ошибка, Вы можете увеличить
значение задержки.
Глава 10: Особенности MapBasic всреде Microsoft Windows
MapBasic Руководство пользователя
233
MapInfo в роли DDE>сервера
MapInfo выступает в роли сервера, когда другая Windowsпрограмма
начинает сеанс DDEобмена. Программаклиент может передавать
операторы MapBasic, читать значения глобальных переменных
MapBasic и изменять их.
Windowsпрограмма, поддерживающая протокол DDE, может
выполнять различные действия в MapInfo, такие, как открытие
таблиц, показ Карт и Списков. Однако, управляющие операторы
MapBasic не могут быть выполнены MapInfo как сервером.
Операторы и функции поддержки DDEсвязи могут в других
программах называться подругому. Вы должны изучить
документацию каждой из программ, чтобы можно было наладить DDE
связь.
Программы и приложения, выступающие в роли DDEклиентов по
отношению к MapBasic, должны задавать параметры application, topic
и item, значения которых описаны выше.
Чтобы начать сеанс DDEсвязи с MapInfo как с сервером, нужно задать
“MapInfo" как значение параметра application.
В качестве параметра topic можно задать “System" или имя
действующего в настоящий момент приложения MapBasic (например,
“C:\MAPBASIC\GRIDS.MBX"). При этом нужно точно задавать
строчные и прописные буквы.
Параметр item зависит от темы (topic). В следующей таблице
приведены различные сочетания объектов и элементов, которые можно
использовать, если MapInfo выступает в роли DDEсервера.
Application:“MapInfo”
Topic:“System”
Команды и темы, поддерживаемые в сеансе обмена DDE:
Действие Параметр item Результат
Запрос на
считывание
данных
”SysItems” На запрос клиента с именем элемента Sysitems Map
Info возвращает разделенный табуляторами список
элементов объекта System: Sysitems Topics Formats
Запрос на
считывание
данных
”Topics” На запрос клиента с именем элемента Topics Map
Info возвращает разделенный табуляторами список
доступных объектов (System и названия всех
приложений MapBasic, действующих или
пребывающих в режиме ожидания).
Глава 10: Особенности MapBasic всреде Microsoft Windows
234 MapBasic Руководство пользователя
Например, следующая MapBasicпрограмма, которую Вы можете
напечатать непосредственно в окне MapBasic, проводит простой DDE
диалог, используя "MapInfo" как application и "System" как topic.
Dim i_channel As Integer
i_channel = DDEInitiate(”MapInfo”, ”System”)
Print DDERequest$(i_channel, ”Version”)
DDETerminate i_channel
Функция DDEInitiate( ) начинает сеанс DDEобмена. Затем функция
DDERequest$( ) производит запрос, используя “Version” как item.
Если Вы используете имя приложения MapBasic (например,
“C:\MB\SCALEBAR.MBX” или “SCALEBAR.MBX” или “SCALEBAR”)
как DDEtopic, Вы можете использовать следующие имена в качестве
item:
Запрос на
считывание
данных
”Formats” На запрос клиента с именем элемента Formats Map
Info возвращает список всех поддерживаемых Map
Info форматов обмена через Clipboard (TEXT и
другие).
Запрос на
считывание
данных
”Version” MapInfo возвращает текстовую строку,
представляющую номер версии MapInfo,
умноженный 100. Например, MapInfo 4.0.0
возвратит "400". См. пример ниже.
Запрос на
считывание
данных
Выражение MapBasic MapInfo интерпретирует строку как выражение
MapBasic и возвращает значение в виде строки.
Выражение ”If” недопустимо, MapInfo возвращает
ошибку.
Эта функциональная возможность появилась в
MapInfo 4.0.
Execute Текстовое послание MapInfo пробует выполнять сообщение как
оператор MapBasic, словно пользователь набрал его
в окне MapBasic.
Оператор не может содержать обращения к
нестандартным (пользовательским) функциям,
хотя может содержать обращения к стандартным
функциям.
Оператор не может ссылаться на переменные,
которые определены в оттранслированных
прикладных программах (.MBХфайлах). Однако
оператор может ссылаться на переменные, которые
были определены при помощи оператора Dim в окне
MapBasic.
Глава 10: Особенности MapBasic всреде Microsoft Windows
MapBasic Руководство пользователя
235
Application:“MapInfo”
Topic: Имя запущенной MapBasicпрограммы
Команды и темы, поддерживаемые в сеансе обмена DDE:
Например, следующая программа MapBasic, которую Вы можете
напечатать непосредственно в MapBasicокне, проводит простой DDE
диалог, используя "SCALEBAR.MBX" как topic.
При помощи этого диалога выводится список глобальных переменных,
используемых приложением SCALEBAR.MBX. Обратите внимание:
Этот диалог будет только работать, если приложение SCALEBAR.MBX
уже выполняется.
Dim i_channel As Integer
i_channel = DDEInitiate(”MapInfo”, ”SCALEBAR.MBX”)
Print DDERequest$(i_channel, ”{items}” )
DDETerminate i_channel
Как MapInfo обрабатывает сообщение DDE>Execute
Имеются два способа, которыми клиентское приложение может
посылать MapInfo запрос на выполнение действий:
Действие Параметр item Результат
Запрос на
считывание
данных
”{items}” MapInfo возвращает разделенный символами
табуляции список глобальных переменных,
определенных в приложении. См. пример
ниже.
Запрос на
считывание
данных
Имя глобальной
переменной
MapInfo возвращает строку, представляющую
собой значение глобальной переменной.
Запрос на
считывание
данных
Строка, не являющаяся
именем глобальной
переменной
Если приложение MapBasic содержит функцию
с именем
RemoteQueryHandler( ), MapInfo вызовет ее.
Внутри тела функции можно определить имя
item посредством вызова:
CommandInfo(CMD_INFO_MSG)
Это новое свойство в MapInfo 4.0.
Поместить
данные (Poke)
Имя глобальной
переменной.
MapInfo изменит значение переменной на
новое.
Execute Текстовое послание Если в приложении MapBasic есть процедура с
именем RemoteMsgHandler, MapInfo вызовет
ее. Внутри тела процедуры можно узнать
содержание текстового послания при помощи
вызова CommandInfo(CMD_INFO_MSG).
Глава 10: Особенности MapBasic всреде Microsoft Windows
236 MapBasic Руководство пользователя
• Когда DDEдиалог использует " System " как topic и клиентское
приложение посылает запрос на выполнение действия, MapInfo
пробует выполнять определенное сообщение как оператор
MapBasic.
• Когда диалог использует имя приложения MapBasic как topic, и
клиент посылает запрос на выполнение действия, MapInfo
вызывает процедуру RemoteMsgHandler приложения, которая
может затем вызывать CommandInfo () чтобы определить текст
сообщения.
Приложение MapBasic может действовать как клиент в одном DDE
диалоге, и одновременно как сервер в другом диалоге. Приложение
MapBasic может инициализировать диалог с другим приложением
MapBasic или непосредственно с MapInfo.
Связь с приложениями Visual Basic с использованием DDE
Программист может расширить возможности MapBasic за счет более
мощного языка Microsoft Visual Basic. Например, можно создавать
средствами Visual Basic диалоговые окна более сложные, чем позволяет
оператор MapBasic Dialog. Например, Visual Basic позволяет добавлять
управляющие элементы диалога, которые нельзя задать оператором
Dialog.
Приложение MapBasic может связываться с приложением Visual Basic
с использованием DDE (или автоматизации OLE). Более подробная
информация приведена в главе 12.
Пример DDE>обмена
Пример чтения/записи в таблицу Excel с помощью DDEсвязи
приведен в описании функции DDEInitiate( ) в Справочнике MapBasic.
Программа Watcher (WATCHER.MB), поставляемая вместе с пакетом,
содержит более сложный пример DDEобмена. WATCHER
используется при отладке: если Вы запустили приложение MapBasic и
следом за ним программу Watcher, то последняя открывает таблицу в
Excel и помещает в нее текущие значения глобальных переменных
приложения, подвергаемого отладке. Другими словами, WATCHER
позволяет просматривать глобальные переменные программы в
таблице Excel.
Программа WATCHER проводит несколько сеансов DDEобмена:
• Сначала WATCHER проводит сеанс DDEобмена, используя
“MapInfo" и “System" как параметры application и topic, и
запрашивает список действующих приложений MapBasic. Затем
WATCHER показывает диалоговое окно, в котором Вы можете
выбрать одно из приложений для отладки.
Глава 10: Особенности MapBasic всреде Microsoft Windows
MapBasic Руководство пользователя
237
• Затем WATCHER начинает второй сеанс DDEобмена,
обращаясь к выбранному в первом сеансе приложению
MapBasic, как к объекту (topic). Используя оператор
DDERequest$( ), Вы получаете список глобальных переменных
этого приложения.
• И, наконец, WATCHER проводит третий сеанс, на этот раз с
Excel. Используя оператор DDEPoke, WATCHER , с помощью
макропрограммы Excel, размещает значения переменных и их
названия в таблице Excel.
Контроль глобальных переменных с помощью DDE
Когда MapInfo выступает в роли сервера в DDEобмене, во время сеанса
можно поддерживать как "теплую", так и "горячую" связь. Когда
приложение Windows начинает сеанс DDEобмена, контролирующий
значения переменных MapBasic, то Windows может уведомлять
клиента об изменении значения глобальной переменной
автоматически или по запросу.
Когда приложение MapBasic выступает в роли DDEклиента, подобный
автоматический контроль невозможен.
Добавление Справочной системы к Вашему
приложению
Если Вы разрабатываете сложное приложение, Вы можете снабдить его
своей Справочной системой. Чтобы создать собственную Справочную
систему, Вам нужен специальный компилятор. Среда разработки
MapBasic его не содержит. Вы можете воспользоваться компилятором
Справочников для Windows (Microsoft Windows Help Compiler),
описание которого Вы можете найти в документации фирмы Microsoft
Corp.
Если вы создадите Справочник для работы в среде MapInfo для
Windows, то он не будет работать в MapInfo для Macintosh или в
MapInfo для UNIX. Последние две среды используют свои Справочные
системы.
Из программы Вы можете управлять Справочником с помощью
операторов Open Window, Close Window и Set Window. Например,
следующий оператор открывает окно Справочника и показывает
оглавление (Contents):
Set Window Help Contents
Глава 10: Особенности MapBasic всреде Microsoft Windows
238 MapBasic Руководство пользователя
Оператор Set Window можно использовать поразному (см. описание
этого оператора в Справочнике MapBasic). Многие формы оператора
Set Window требуют задания целочисленного идентификатора окна; в
случае же со Справочной системой достаточно указать слово Help.
Если Вы создали свой Справочный файл и назвали его DISPATCH.HLP,
то его можно открыть оператором
Set Window Help File ”C:\MAPINFO\DISPATCH.HLP”
Следующий оператор открывает Справочную систему на теме,
имеющей внутренний номер 500:
Set Window Help ID 500
Внутренние номера (IDномера) определяются в разделе [MAP] файла
проекта Справочника (например filename.hpj). Подробно структура
этого файла описана в документации к Windows Software Developers
Kit (SDK).
Если нужно снабдить Справочником диалоговое окно, созданное в
Вашей программе, поместите в диалог кнопку (Button control) с
надписью “Help" или “Справка” с помощью следующей конструкции:
Control Button
Title ”Справка”
Calling show_help_sub
Назначьте кнопке "Справка" процедуруобработчик, в которую
поместите оператор Set Window. Пользователь, нажав на кнопку
«Справка», откроет окно Справочника. Подробнее о процедурах
обработчиках см. главу 6.