【資料名稱】：mapbasic 12.0用戶手冊(cè)

【資料作者】：Pitney Bowes

【資料日期】：2013-5-23

【資料語言】：英文

【資料格式】：PDF

【資料目錄和簡(jiǎn)介】：

Chapter 1: Getting Started.......................................................................................17
What's New.........................................................................................................................18
System Requirements.......................................................................................................18
System Notes.................................................................................................................18
Installing the MapBasic Development Environment......................................................18
Before You Begin...........................................................................................................18
Installation.....................................................................................................................19
Starting MapBasic..........................................................................................................19
MapBasic File Names and File Types..............................................................................19
MapBasic Documentation Set..........................................................................................20
Conventions Used in This Manual...................................................................................21
Terms............................................................................................................................21
Typographical Conventions............................................................................................21
Getting Technical Support................................................................................................22
Contacting Technical Support .......................................................................................22
Software Defects............................................................................................................23
Other Resources............................................................................................................23
Chapter 2: A Quick Look at MapBasic....................................................................25
Getting Started...................................................................................................................26
How Do I Create and Run a MapBasic Application?.....................................................26
What Are the Key Features of MapBasic?......................................................................27
MapBasic Lets You Customize MapInfo Professional....................................................27
MapBasic Lets You Automate MapInfo Professional.....................................................27
MapBasic Provides Powerful Database-Access Tools...................................................27
MapBasic Lets You Connect MapInfo Professional to Other Applications.....................28
How Do I Learn MapBasic?..............................................................................................28
The MapBasic Window in MapInfo Professional............................................................29
Training and On-Site Consulting....................................................................................30
Chapter 3: Using the Development Environment..................................................31
Introduction to MapBasic Development Environment...................................................32
Editing Your Program........................................................................................................32
Keyboard Shortcuts........................................................................................................32
Limitations of the MapBasic Text Editor.........................................................................35
Compiling Your Program..................................................................................................35
A Note on Compilation Errors........................................................................................36
Running a Compiled Application....................................................................................36
Using Another Editor to Write MapBasic Programs.......................................................37
Linking Multiple Modules Into a Single Project..............................................................38
What is a MapBasic Project File?..................................................................................38
Creating a Project File....................................................................................................39
Opening multiple files.....................................................................................................40
Calling Functions or Procedures From Other Modules .................................................41
Menu Summary in MapBasic Development Environment.............................................42
The File Menu................................................................................................................42
The Edit Menu................................................................................................................43
The Search Menu...........................................................................................................43
The Project Menu...........................................................................................................44
The Window Menu.........................................................................................................45
The Help Menu...............................................................................................................45
Chapter 4: MapBasic Fundamentals.......................................................................47
General Notes on MapBasic Syntax................................................................................48
Comments......................................................................................................................48
Case-Sensitivity.............................................................................................................48
Continuing a Statement Across Multiple Lines..............................................................48
Codes Defined In mapbasic.def.....................................................................................48
Typing Statements Into the MapBasic Window..............................................................49
Variables.......................................................................................................................49
Fixed-length and variable-length String variables..........................................................51
Array Variables...............................................................................................................51
Custom Data Types (Data Structures)...........................................................................52
Global Variables.............................................................................................................53
Scope of Variables.........................................................................................................53
Expressions......................................................................................................................54
What is a Constant?.......................................................................................................54
6 MapBasic 12.0
What is an Operator?.....................................................................................................54
What is a Function Call?................................................................................................55
A Closer Look At Constants...........................................................................................56
Variable Type Conversion..............................................................................................58
A Closer Look At Operators...........................................................................................59
MapBasic Operator Precedence....................................................................................63
Looping, Branching, and Other Flow-Control................................................................64
If...Then Statement.........................................................................................................64
Do Case Statement........................................................................................................65
GoTo Statement.............................................................................................................66
For...Next Statement......................................................................................................66
Do...Loop........................................................................................................................67
While...Wend Loop.........................................................................................................67
Ending Your Program.....................................................................................................68
Ending Your Program and MapInfo Professional...........................................................68
Procedures........................................................................................................................68
Main Procedure..............................................................................................................68
Calling a Procedure........................................................................................................69
Calling a Procedure That Has Parameters....................................................................69
Passing Parameters By Reference................................................................................70
Passing Parameters By Value........................................................................................70
Calling Procedures Recursively.....................................................................................71
Procedures That Act As System Event Handlers...........................................................71
What Is a System Event?...............................................................................................71
What Is an Event Handler?............................................................................................71
When Is a System Event Handler Called?.....................................................................73
Tips for Handler Procedures............................................................................................74
Keep Handler Procedures Short....................................................................................74
Selecting Without Calling SelChangedHandler..............................................................74
Preventing Infinite Loops...............................................................................................74
Custom Functions..........................................................................................................75
Scope of Functions........................................................................................................75
Compiler Instructions.......................................................................................................76
The Define Statement....................................................................................................76
The Include Statement...................................................................................................76
Program Organization.......................................................................................................77
Chapter 5: Debugging and Trapping Runtime Errors............................................79
User Guide 7
Runtime Error Behavior....................................................................................................80
Debugging a MapBasic Program.....................................................................................80
Summary of the Debugging Process.............................................................................80
Limitations of the Stop Statement..................................................................................81
Other Debugging Tools..................................................................................................82
Error Trapping....................................................................................................................82
Example of Error Trapping.............................................................................................82
Chapter 6: Creating the User Interface...................................................................85
Introduction to MapBasic User Interface Principles......................................................86
Event-Driven Programming..............................................................................................86
What Is an Event?..........................................................................................................86
What Happens When The User Generates A Menu Event?..........................................86
How Does a Program Handle ButtonPad Events?........................................................87
How Does a Program Handle Dialog Box Events?........................................................87
Menus................................................................................................................................88
Menu Fundamentals......................................................................................................88
Adding New Items to a Menu.........................................................................................89
Removing Items From a Menu.......................................................................................89
Creating A New Menu....................................................................................................90
Altering A Menu Item......................................................................................................91
Re-Defining The Menu Bar............................................................................................92
Specifying Language-Independent Menu References...................................................93
Customizing MapInfo Professional's Shortcut Menus....................................................93
Assigning One Handler Procedure To Multiple Menu Items..........................................94
Simulating Menu Selections...........................................................................................95
Defining Shortcut Keys And Hot Keys...........................................................................95
Controlling Menus Through the MapInfo Professional Menus File................................96
Standard Dialog Boxes.....................................................................................................98
Displaying a Message....................................................................................................98
Asking a Yes-or-No Question.........................................................................................98
Selecting a File...............................................................................................................99
Indicating the Percent Complete..................................................................................100
Displaying One Row From a Table..............................................................................100
Custom Dialog Boxes.....................................................................................................100
Sizes and Positions of Controls...................................................................................101
Control Types...............................................................................................................102
Specifying a Control's Initial Value...............................................................................105
8 MapBasic 12.0
Reading a Control's Final Value...................................................................................105
Responding to User Actions by Calling a Handler Procedure.....................................106
Enabled / Disabled Controls........................................................................................106
Letting the User Choose From a List...........................................................................107
Managing MultiListBox Controls..................................................................................107
Specifying Shortcut Keys for Controls.........................................................................108
Closing a Dialog Box....................................................................................................108
Windows..........................................................................................................................109
Specifying a Window's Size and Position....................................................................110
Map Windows...............................................................................................................110
Using Animation Layers to Speed Up Map Redraws...................................................111
Browser Windows........................................................................................................112
Graph Windows............................................................................................................113
Layout Windows...........................................................................................................113
Redistrict Windows.......................................................................................................113
Message Window.........................................................................................................114
ButtonPads (Toolbars)....................................................................................................115
What Happens When the User Chooses a Button?.....................................................115
MapBasic Statements Related To ButtonPads............................................................116
Creating A Custom PushButton...................................................................................117
Adding A Button To The Main ButtonPad....................................................................118
Creating A Custom ToolButton.....................................................................................118
Choosing Icons for Custom Buttons............................................................................119
Selecting Objects by Clicking With a ToolButton.........................................................120
Including Standard Buttons in Custom ButtonPads.....................................................121
Assigning Help Messages to Buttons..........................................................................122
Docking a ButtonPad to the Top of the Screen............................................................122
Other Features of ButtonPads ....................................................................................122
Cursors............................................................................................................................123
Integrating Your Application Into MapInfo Professional...............................................123
Loading Applications Through the Startup Workspace................................................124
Manipulating Workspaces through MapBasic..............................................................125
Performance Tips for the User Interface......................................................................125
Avoiding Unnecessary Window Redraws....................................................................125
Purging the Message Window.....................................................................................126
Suppressing Progress Bar Dialog Boxes.....................................................................126
Chapter 7: Working With Tables............................................................................127
User Guide 9
Opening Tables Through MapBasic..............................................................................128
Determining Table Names at Runtime.........................................................................128
Opening Two Tables With The Same Name................................................................128
Opening Non-Native Files As Tables...........................................................................129
Reading Row-And-Column Values From a Table.........................................................130
Alias Data Types as Column References....................................................................131
Scope..........................................................................................................................133
Using the "RowID" Column Name To Refer To Row Numbers....................................133
Using the "Obj" Column Name To Refer To Graphic Objects......................................133
Finding Map Addresses In Tables................................................................................134
Geocoding....................................................................................................................134
Performing SQL Select Queries...................................................................................134
Error Checking for Table and Column References......................................................135
Writing Row-And-Column Values to a Table.................................................................135
Creating New Tables.......................................................................................................135
Modifying a Table's Structure.......................................................................................136
Creating Indexes and Making Tables Mappable..........................................................136
Reading A Table's Structural Information.....................................................................137
Working With The Selection Table...............................................................................137
Changing the Selection................................................................................................138
Updating the Currently-Selected Rows........................................................................138
Using the Selection for User Input...............................................................................139
Accessing the Cosmetic Layer......................................................................................139
Accessing Layout Windows...........................................................................................140
Multi-User Editing............................................................................................................140
The Rules of Multi-User Editing...................................................................................141
Preventing Conflicts When Writing Shared Data.........................................................142
Opening a Table for Writing..........................................................................................144
Files that Make Up a Table..............................................................................................144
Raster Image Tables........................................................................................................144
Working With Metadata...................................................................................................146
What is Metadata?.......................................................................................................146
What Do Metadata Keys Look Like?............................................................................146
Examples of Working With Metadata...........................................................................147
Working With Seamless Tables......................................................................................149
What is a Seamless Table?..........................................................................................149
How Do Seamless Tables Work?.................................................................................149
MapBasic Syntax for Seamless Tables........................................................................150
10 MapBasic 12.0
Limitations of Seamless Tables....................................................................................150
Accessing DBMS Data....................................................................................................151
How Remote Data Commands Communicate with a Database..................................151
Connecting and Disconnecting....................................................................................151
PostGIS Geometry Conversion Behavior....................................................................152
Accessing/Updating Remote Databases with Linked Tables......................................153
Live Access to Remote Databases..............................................................................154
Performance Tips for Table Manipulation.....................................................................154
Set the Default View for Remote Tables......................................................................154
Minimize Transaction-File Processing.........................................................................154
Use Indices Where Appropriate...................................................................................155
Using Sub-Selects........................................................................................................155
Optimized Select Statements.......................................................................................155
Using Update Statements............................................................................................155
Chapter 8: File Input/Output...................................................................................157
Overview of File Input/Output........................................................................................158
Sequential File I/O...........................................................................................................159
Random File I/O...........................................................................................................160
Binary File I/O..............................................................................................................161
Platform-Specific & International Character Sets........................................................161
File Information Functions............................................................................................161
Chapter 9: Graphical Objects.................................................................................163
Using Object Variables....................................................................................................164
Using the "Obj" Column.................................................................................................164
Creating an Object Column..........................................................................................165
Limitations of the Object Column.................................................................................165
Querying An Object's Attributes....................................................................................166
Object Styles (Pen, Brush, Symbol, Font)...................................................................167
Understanding Font Styles...........................................................................................168
Stacked Styles.............................................................................................................168
Style Variables.............................................................................................................170
Selecting Objects of a Particular Style.........................................................................171
Creating New Objects.....................................................................................................173
Object-Creation Statements.........................................................................................173
Object-Creation Functions...........................................................................................173
Creating Objects With Variable Numbers of Nodes.....................................................174
User Guide 11
Storing Objects In a Table............................................................................................174
Creating Objects Based On Existing Objects...............................................................175
Creating a Buffer..........................................................................................................175
Using Union, Intersection, and Merge..........................................................................176
Creating Isograms........................................................................................................176
Creating Offset Copies.................................................................................................177
Modifying Objects...........................................................................................................177
General Procedure for Modifying an Object.................................................................177
Repositioning An Object..............................................................................................178
Moving Objects and Object Nodes..............................................................................178
Modifying An Object's Pen, Brush, Font, or Symbol Style...........................................178
Converting An Object To A Region or Polyline............................................................178
Erasing Part Of An Object............................................................................................178
Points Of Intersection...................................................................................................179
Working With Map Labels...............................................................................................179
Turning Labels On........................................................................................................179
Turning Labels Off........................................................................................................179
Editing Individual Labels..............................................................................................180
Querying Labels...........................................................................................................180
Other Examples of the Set Map Statement.................................................................180
Differences Between Labels and Text Objects............................................................181
Coordinates and Units of Measure................................................................................183
Units of Measure .........................................................................................................184
Advanced Geographic Queries......................................................................................185
Using Geographic Comparison Operators...................................................................185
Querying Objects in Tables..........................................................................................187
Using Geographic SQL Queries With Subselects........................................................188
Using Geographic Joins...............................................................................................189
Proportional Data Aggregation.....................................................................................189
Chapter 10: Advanced Features of Microsoft Windows......................................191
Declaring and Calling Dynamic Link Libraries (DLLs).................................................192
Specifying the Library..................................................................................................192
Passing Parameters.....................................................................................................192
Calling Standard Libraries............................................................................................193
Calling a DLL Routine by an Alias...............................................................................193
Array Arguments..........................................................................................................194
User-Defined Types.....................................................................................................194
12 MapBasic 12.0
Logical Arguments.......................................................................................................194
Handles........................................................................................................................194
Example: Calling a Routine in KERNEL......................................................................195
Troubleshooting Tips for DLLs.....................................................................................196
Creating Custom Button Icons and Draw Cursors......................................................197
Reusing Standard Icons...............................................................................................197
Custom Icons...............................................................................................................197
Custom Draw Cursors for Windows.............................................................................199
Inter-Application Communication Using DDE..............................................................199
Overview of DDE Conversations.................................................................................199
How MapBasic Acts as a DDE Client..........................................................................199
How MapInfo Professional Acts as a DDE Server.......................................................201
How MapInfo Professional Handles DDE Execute Messages.....................................203
Communicating With Visual Basic Using DDE ...........................................................203
Examples of DDE Conversations.................................................................................204
DDE Advise Links........................................................................................................204
Incorporating Windows Help Into Your Application.....................................................204
Chapter 11: Integrated Mapping............................................................................207
What Does Integrated Mapping Look Like?..................................................................208
Conceptual Overview of Integrated Mapping...............................................................208
Technical Overview of Integrated Mapping...................................................................210
System Requirements..................................................................................................210
Other Technical Notes..................................................................................................210
A Short Sample Program: "Hello, (Map of) World"......................................................210
A Closer Look at Integrated Mapping............................................................................211
Sending Commands to MapInfo Professional..............................................................212
Querying Data from MapInfo Professional...................................................................212
Customizing MapInfo Professional's Shortcut Menus..................................................217
Terminating Your Visual Basic Program.......................................................................218
A Note About MapBasic Command Strings.................................................................218
A Note About Dialog Boxes.........................................................................................219
A Note About Accelerator Keys...................................................................................219
Using Callbacks to Retrieve Info from MapInfo Professional.....................................219
Technical Requirements for Callbacks.........................................................................220
General Procedure for Using OLE Callbacks..............................................................220
Processing the Data Sent to a Callback......................................................................221
C/C++ Syntax for Standard Notification Callbacks......................................................223