- •Add Cartographic Frame
- •Оператор Alter Button
- •Оператор Alter ButtonPad
- •Оператор Alter MapInfoDialog
- •Оператор Alter Menu
- •Оператор Alter Menu Item
- •Оператор Alter Object
- •Оператор Alter Table
- •Оператор Autolabel
- •Оператор Beep
- •Оператор Browse
- •Предложение Brush
- •Оператор Call
- •Предложение CharSet
- •Функция ChooseProjection$()
- •Оператор Close All
- •Оператор Close File
- •Оператор Close Table
- •Оператор Close Window
- •Оператор Commit Table
- •Оператор Continue
- •Предложение Control CheckBox
- •Предложение Control EditText
- •Предложение Control GroupBox
- •Предложение Control RadioGroup
- •Оператор Create Arc
- •Оператор Create ButtonPad
- •Оператор Create ButtonPads As Default
- •Оператор Create Cartographic Legend
- •Оператор Create Collection
- •Оператор Create Ellipse
- •Оператор Create Frame
- •Оператор Create Grid
- •Оператор Create Index
- •Оператор Create Legend
- •Оператор Create Line
- •Оператор Create Map
- •Оператор Create Map3D
- •Оператор Create Menu
- •Оператор Create Menu Bar
- •Оператор Create MultiPoint
- •Оператор Create Point
- •Оператор Create PrismMap
- •Оператор Create Ranges
- •Оператор Create Rect
- •Оператор Create Redistricter
- •Оператор Create Region
- •Оператор Create Report From Table
- •Оператор Create RoundRect
- •Оператор Create Styles
- •Оператор Create Table
- •Оператор Create Text
- •Оператор DDEExecute
- •Оператор DDEPoke
- •Оператор DDETerminate
- •Оператор DDETerminateAll
- •Оператор Declare Function
- •Оператор Declare Sub
- •Оператор Define
- •Оператор Delete
- •Оператор Dialog
- •Оператор Dialog Preserve
- •Оператор Dialog Remove
- •Оператор Dim
- •Оператор Do Case...End Case
- •Оператор Do...Loop
- •Оператор Drop Index
- •Оператор Drop Map
- •Оператор Drop Table
- •Оператор End MapInfo
- •Оператор End Program
- •Процедура EndHandler
- •Оператор Error
- •Оператор Exit Do
- •Оператор Exit For
- •Оператор Exit Function
- •Оператор Exit Sub
- •Оператор Export
- •Оператор Fetch
- •Оператор Find
- •Оператор Find Using
- •Предложение Font
- •Процедура ForegroundTaskSwitchHandler
- •Функция FormatDate$
- •Оператор Function...End Function
- •Оператор Get
- •Оператор Graph
- •оператор Import
- •Оператор Include
- •Оператор Input #
- •Оператор Insert
- •Функция IsPenWidthPixels()
- •Оператор Kill
- •Оператор Line Input
- •Процедура Main
- •Оператор Map
- •Оператор Menu Bar
- •Оператор Metadata
- •Оператор Note
- •Оператор Objects Check
- •Оператор Objects Clean
- •Оператор Objects Combine
- •Оператор Objects Disaggregate
- •Оператор Objects Enclose
- •Оператор Objects Erase
- •Оператор Objects Intersect
- •Оператор Objects Overlay
- •Оператор Objects Snap
- •Оператор Objects Split
- •Оператор OnError
- •Оператор Open File
- •Оператор Open Table
- •Оператор Open Window
- •Предложение Pen
- •Функция PenPattern()
- •Функция PenWidthToPoints()
- •Функция PointsToPenWidth()
- •Оператор Print
- •Оператор PrintWin
- •Оператор ProgressBar
- •Оператор Put
- •Оператор Randomize
- •Оператор ReDim
- •Оператор Register Table
- •Оператор Reload Symbols
- •Процедура RemoteMapGenHandler
- •Процедура RemoteMsgHandler
- •Оператор Rename File
- •Оператор Rename Table
- •Оператор Reproject
- •Оператор Resume
- •Оператор Rollback
- •Оператор Run Application
- •Оператор Run Command
- •Оператор Run Menu Command
- •Оператор Run Program
- •Оператор Save File
- •Оператор Save Workspace
- •Оператор Seek
- •Процедура SelChangedHandler
- •Оператор Select
- •Оператор Server Begin Transaction
- •Оператор Server Bind Column
- •Оператор Server Close
- •Оператор Server Commit
- •Оператор Server Create Map
- •Оператор Server Create Table
- •Оператор Server Create Style
- •Оператор Server Disconnect
- •Оператор Server Fetch
- •Оператор Server Refresh
- •Оператор Server Rollback
- •Оператор Server Set Map
- •Оператор Set Application Window
- •Оператор Set Area Units
- •Оператор Set Browse
- •Оператор Set Cartographic Legend
- •Оператор Set Command Info
- •Оператор Set CoordSys
- •Оператор Set Date Window
- •Оператор Set Digitizer
- •Оператор Set Distance Units
- •Оператор Set Drag Threshold
- •Оператор Set Event Processing
- •Оператор Set File TimeOut
- •Оператор Set Format
- •Оператор Set Graph
- •Оператор Set Handler
- •Оператор Set Layout
- •Оператор Set Legend
- •Оператор Set Map
- •Оператор Set Map3D
- •Оператор Set Next Document
- •Оператор Set Paper Units
- •Оператор Set PrismMap
- •Оператор Set ProgressBars
- •Оператор Set Redistricter
- •Оператор Set Resolution
- •Оператор Set Shade
- •Оператор Set Table
- •Оператор Set Target
- •Оператор Set Window
- •Оператор Shade
- •Оператор StatusBar
- •Оператор Stop
- •Оператор Sub...End Sub
- •Предложение Symbol
- •Оператор Terminate Application
- •Функция Time()
- •Процедура ToolHandler
- •Оператор Type
- •Оператор UnDim
- •Оператор Unlink
- •Оператор Update
- •Оператор Update Window
- •Оператор While...Wend
- •Процедура WinChangedHandler
- •Процедура WinClosedHandler
- •Процедура WinFocusChangedHandler
- •Оператор Objects Move
- •Оператор Objects Offset
- •Функция Offset()
- •Функция SphericalOffset()
- •Функция SphericalOffsetXY()
- •Функция CartesianOffsetXY()
- •Функция LayerInfo( )
- •Оператор Register
- •Оператор Server Create Map
- •Функция TableInfo( )
Оператор Include
Оператор Include
Назначение:
Объединяет содержимое отдельного текстового файла с текстом программы MapBasic.
Синтаксис:
Include "filename"
где
filename – имя текстового файла.
Предупреждение:
Вы не можете использовать оператор Include в окне MapBasic.
Описание:
Когда MapBasic компилирует программный файл с оператором Include, текст определенного в этом операторе файла рассматривается как часть текста программы. Файл, заданный параметром filename, должен состоять из допустимых операторов MapBasic.
Если имя файла в параметре filename задано без каталога и этот файл не находится в активном каталоге, то компилятор языка MapBasic делает попытку найти его в том каталоге, в котором расположен программный файл MapBasic. Это позволяет Вам не копировать каждый раз файлы стандартных определений (такие, как MAPBASIC.DEF) в каталог разрабатываемой программы.
Оператор используется для подсоединения к файлам стандартных определений, таких, как MAPBASIC.DEF и MENU.DEF. В них с помощью оператора Define целочисленным кодам заданы имена (например, TRUE и FALSE), использование которых в Вашей программе делает ее текст более понятным.
Однако, если Вы изменили содержимое текстового файла, подсоединенного оператором Include, то для внесения этих изменений в программу ее необходимо перекомпилировать.
Пример:
Include ”MAPBASIC.DEF”
286 |
Справочник MapBasic |
Оператор Input #
Оператор Input #
Назначение:
Читает данные из файла и помещает их в переменные.
Синтаксис:
Input #filenum , var_name [, var_name ... ]
где
filenum – номер файла, под которым он был открыт оператором Open File; var_name – имя переменной.
Описание:
Оператор Input # читает данные из файла, открытого в режиме последовательного доступа (INPUT, OUTPUT или APPEND), и присваивает их как значения одной или более переменным MapBasic.
Оператор Input # читает данные последовательно от верхней строки к последней, присваивая каждую порцию одной переменной var_name. Оператор Input # считывает порции данных из файла, используя в качестве разделителей запятую и символ конца строки. Поэтому, чтобы прочитать одну строку с запятыми в одну строковую переменную, надо использовать оператор Line Input #.
Когда оператор Input # читает пустую строку, то значением строковой переменной будет пустая строка (""). Если переменная была объявлена численным типом, то значением будет ноль.
После выполнения оператора Input # применение функции EOF( ) помогает определить корректность результата чтения. Если чтение произошло успешно, результатом функции EOF( ) будет логическое "нет" (FALSE), и, если был прочитан признак конца файла, EOF( ) вернет логическое "да" (TRUE).
Пример использования оператора Input # Вы можете увидеть в программе NVIEWS ("Виды") из стандартной поставки MapBasic.
Смотрите также:
EOF( ), Line Input #, Open File, Write #
Справочник MapBasic |
287 |
Оператор Insert
Оператор Insert
Назначение:
Добавляет новую строку в открытую таблицу
Синтаксис:
Insert Into table [ ( columnlist ) ]
{ Values ( exprlist ) | Select columnlist From table }
где
table – имя открытой таблицы; columnlist – список выражений;
exprlist – одно выражение или список, разделенный запятыми.
Описание:
Оператор Insert вставляет новую строку в открытую таблицу. Этот оператор применяется в двух формах, позволяющих либо добавлять таблице по одной строке, либо добавлять группы строк из другой таблицы. В каждом случае порядок и количество значений в списке exprlist, которые будут вставлены в поля новой строки, должны соответствовать колонкам, перечисленным в списке column list. Если колонки не перечислены, то будут рассматриваться все поля в новой строке. Если Вы хотите сохранить таблицу с новыми строками на диске, то после ввода используйте оператор Commit Table.
Если Вы точно знаете, сколько колонок в таблице, и если Вам уже известно, какие именно величины в какие поля надо поместить, то можно опустить предложение (columnlist). Достаточно составить список величин в порядке расположения полей в таблице. В следующем примере результатом оператора будет новая строка в таблице, состоящей из четырех колонок ("Имя", "Адрес", "Город", "Область"), и каждому полю будет определено значение:
Insert Into customers
Values ("Мария Павловна Носова", "ул. Солнечная, 2, 23",
"Троицк", "Московская")
Результатом этого оператора может быть ошибка, если таблица будет иметь больше или меньше колонок, чем четыре. Если Вы не знаете точно, сколько колонок составляют таблицу, или не знаете, в каком порядке расположены колонки в таблице, необходимо в операторе использовать список имен колонок (columnlist).
Следующий оператор создает новую строку со значением в поле "Имя". Для успешного выполнения оператора необязательно знать, сколько всего полей в структуре таблицы.
Insert Into customers ( Имя )
Values ("Степан Иванович Гарин")
Следующий оператор создает точечный объект и вставляет его в поле "Obj" новой записи в таблице SITES. Таким образом, мы создаем новую чистую запись с присоединенным точечным объектом.
Insert Into sites (Obj)
Values ( CreatePoint( 73.5, 42.8) )
Следующий пример иллюстрирует, как оператором Insert можно добавить запись в таблицу, используя запись из другой. Допустим, что в таблице NY_ZIPS содержатся ZIP-коды штата НьюЙорк и в таблице NJ_ZIPS содержатся ZIP-коды штата Нью-Джерси. Добавим все ZIP-коды из одной таблицы в другую. Такая операция иногда необходима для поиска, так как оператор Find может работать только с одной таблицей.
288 |
Справочник MapBasic |
Оператор Insert
Insert Into NY_ZIPS
Select * From NJ_ZIPS
В следующем примере берутся все объекты из таблицы WORLD и каждый подсоединяется к новой строке таблицы OUTLINE.
Open Table "world"
Open Table "outline"
Insert Into outline (Obj)
Select Obj From World
Смотрите также:
Commit, Delete, Rollback
Справочник MapBasic |
289 |
Функция InStr( )
Функция InStr( )
Назначение:
Возвращает позицию первого символа подстроки в строке.
Синтаксис:
InStr(position, string, substring)
где
position – стартовая позиция для поиска, положительное целое число; string – строковое выражение;
substring – строковое выражение.
Величина, полученная в результате:
Целое число. Величина типа Integer.
Описание:
Функция InStr( ) проверяет, входит ли в состав строки, представленной выражением string, другая строка (или символ), представленная выражением substring, и возвращает позицию вхождения. Поиск в первой строке начинается с символа, номер которого задается параметром position. Если position равен единице, MapBasic начинает поиск с начала строки string.
Если строка substring не входит в string, то результатом функции InStr( ) будет 0 (ноль).
Если строка substring найдена в string, то функция InStr( ) вернет номер символа в строке string, который является первым в substring.
Если параметр substring – пустая строка, то результатом будет 0 (ноль).
Функция InStr( ) различает строчные и прописные буквы. Другими словами, функция InStr( ) не найдет подстроку "ИЯ" в строке "Россия" и вернет ноль.
Ошибки:
В результате выполнения функции может генерироваться код ошибки ERR_FCN_ARG_RANGE, если position больше, чем количество символов в строке string.
Пример:
Dim fullname As String, pos As Integer
fullname = "Галина Петровна Соколова" pos = InStr(1, fullname, "Галина")
'
' переменная pos равна 1 (единице)
'
pos = InStr(1, fullname, "Сокол")
'
' теперь pos равна 17 (семнадцати)
'
pos = InStr(1, fullname, "СОКОЛ")
'
' теперь pos равна 0 (нулю);
'
Смотрите также:
Mid$( )
290 |
Справочник MapBasic |
Функция Int( )
Функция Int( )
Назначение:
Возвращает целую часть действительного числа.
Синтаксис:
Int(num_expr)
где
num_expr – численное выражение.
Величина, полученная в результате:
Целое число. Величина типа Integer.
Описание:
Функция отсекает дробную часть от действительного числа, полученного в результате вычисления выражения num_expr, и возвращает целую часть.
Функция Int( ) похожа на функцию Fix( ), но не идентична. Функции различаются способом удаления дробной части отрицательного числа. Когда num_expr представляет отрицательное число, функция Fix( ) возвращает ближайшее целое, большее или равное оригиналу. Например:
Fix( 2.3)
возвращает значение -2. В случае функции Int( ) результатом будет ближайшее целое, меньше или равное оригиналу. Например:
Int( 2.3)
возвращает значение -3.
Пример:
Dim whole As Integer whole = Int(5.999)
' whole сейчас имеет значение 5. whole = Int( 7.2)
' whole сейчас имеет значение 8.
Смотрите также:
Fix( ), Round( )
Справочник MapBasic |
291 |
Функция IntersectNodes( )
Функция IntersectNodes( )
Назначение:
Вычисляет точки пересекающихся объектов и возвращает полилинию, имеющую узлы в точках пересечения.
Синтаксис:
IntersectNodes(object1, object2, points_to_include)
где
object1 и object2 – объектные выражения, которые могут представлять объекты любого типа, кроме точечного и текстового;
points_to_include – один из следующих кодов:
INCL_CROSSINGS – функция возвращает узлы, в которых сегменты обоих объектов пересекаются;
INCL_COMMON – функция возвращает узлы отрезков, на которые накладываются сегменты обоих объектов;
INCL_ALL – функция возвращает узлы, в которых сегменты пересекаются и накладываются.
Величина, полученная в результате:
Полилиния. Величина типа Object.
Описание:
Функция IntersectNodes( ) возвращает объект типа "полилиния", узлы которого лежат в точках пересечения объектов object1 и object2.
292 |
Справочник MapBasic |