Release Notes. MapBasic Version Contents:

Transcription

1 MapBasic Version 16.0 Contents: Introduction Locating Your Documentation Notes About this Release Known Issues Progress and Resolution of Outstanding Issues

2 Introduction This document provides information on new and enhanced features that have been introduced into MapBasic. It also contains sections on resolved customer issues and some remaining known issues that are important for MapBasic users to be aware of. MapBasic is the programming language that lets you customize and automate MapInfo Pro. Locating Your Documentation The table below lists the available MapBasic documents and explains how to access them. Document Description MapBasic User Guide Complete guide on how to use MapBasic. The PDF document can be accessed from following: View online at Installs with MapInfo Pro and can be accessed from the Documentation folder in the MapInfo Pro installation directory. MapBasic Reference Complete guide to all MapBasic commands. The PDF document can be accessed from following: View online at Installs with MapInfo Pro and can be accessed from the Documentation folder in the MapInfo Pro installation directory. MapBasic Help Includes all of the information in MapBasic Reference plus dialog and menu descriptions. The QT document can be accessed from following: Click Help, then click Contents in MapBasic. Installs with MapBasic and can be accessed by running the MapBasicHelp.exe executable in the MapBasic installation directory. 2

3 Document Description Extensibility Reference Help MapInfo Pro 64-bit.NET Object Model API. The QT document can be accessed from following: Installs with MapBasic and can be accessed by running the ExtensibilityReferenceHelp.exe executable in the MapBasic installation directory. Integrated Mapping Reference Help API documentation to add Integrated Mapping capabilities to your application. The QT document can be accessed from following: Installs with MapBasic and can be accessed by running the IntegratedMappingReferenceHelp.exe executable in the MapBasic installation directory. You must have the Adobe Acrobat reader installed to view PDF files. To download a free copy of the Adobe Acrobat Reader, go to Notes About this Release MapInfo MapBasic is 64-Bit This release of MapBasic is 64-bit. As a result: The submenus in the MapBasic application under Project > Run have been removed, because they are no longer required. MapInfoPro.exe is the executable for the 64-bit MapInfo Pro, so MapBasic launches MapInfoPro.exe by default from the menu or when you press Ctrl-U. MapBasic programs compiled as 64-bit cannot be executed with the Windows 32-bit version of MapInfow.exe. Some functions and statements that only work with the older 32-bit versions of MapBasic are not available with this release, such as Create Report From Table statement, Graph statement, Open Report statement, and Set Graph statement. Preview of Layout Undo We are working on a new feature for the Layout window that lets you undo and redo your last action. This feature is still in development, but a preview is available in MapInfo Pro There are two new MapBasic functions available for performing an undo or redo: 3

4 Set Undo statement turns the Layout Designer window s Undo feature on or off. UndoInfo() function returns information about Undo stack functionality for a Layout Designer window. Activating Undo or Redo To activate this feature, which is hidden by default, you can either run MapInfo Pro from the command line with a flag to activate Undo for the session or edit the MapInfoPro.exe.config. Configuration settings apply every time you launch MapInfo Pro, because it reads the configuration file on start up. To run MapInfo Pro from the command line with the Layout Undo feature turned on: 1. On the Windows Start menu type cmd in the search field. This opens the command line window. 2. In the command line window, change directories (cd) to the folder that has the MapInfoPro.exe file in it. 3. Type MapInfoPro.exe -LayoutUndo to launch MapInfo Pro and activate the Layout Undo feature. To edit the MapInfo configuration file and activate the Layout Undo feature in MapInfo Pro: 1. Open the MapInfoPro.exe.config file in a text editor. This file is in the directory where MapInfo Pro is installed (as an example, C:\Program Files\MapInfo\Professional) 2. Under the appsettings section, remove the comment tags from the following line, <add key="layoutundo" value="true"/>. Changing true to false deactivates this feature (or add comment tags to the line). How to Perform an Undo or Redo in MapInfo Pro The Undo and Redo functions are available as ribbon commands on the LAYOUT tab in the Clipboard group. You can also perform an undo by pressing Ctrl+Z. When deleting a frame that does not support the Undo feature, a Confirm Frame Removal dialog displays. If you choose Yes to continue, MapInfo Pro removes the frame (or frames) and clears the Undo history. This dialog does not display when using a MapBasic statement to remove one or more frames (such as for the Remove Designer Frame statement). What You can Undo and Redo The Undo feature is still in development, so not all actions can be undone. You can Undo and Redo after creating or deleting text objects, images, shapes (line, polyline, ellipse, rectangle, rounded rectangle, polygon) and symbols. You cannot use Undo and Redo when creating a map, browser, legend, or custom frames (including the scale bar frame). If you delete one of these frames, a prompt displays as described in the previous section. You can Undo and Redo after resizing or moving items on the layout, including the frames mentioned above. This also applies when using the MapBasic statement Alter Designer Frame. 4

5 Known Issues Behavior Change for LabelOverrideInfo( ) In previous versions, the LabelOverrideInfo( ) function returned indirect information for attributes. When querying for the label override expression, LabelOverrideInfo( ) would return an empty string if the label override was not edited. An empty string indicates that the expression was not overridden. This has a negative side effect when determining label position. If the label position was not changed in the label override, then the return value is zero (0). However, zero means that the label position was not overridden or the label position is set to (center, center). The same issue occurs for Boolean (True, False) attributes. To resolve these, MapBasic now returns the attribute value as it is in the label override. For an expression, MapBasic returns the label override expression and not an indication of whether it was edited. StringByteLength( ) Function Limitation The new StringByteLength( ) function returns the number of bytes in a string for a given charset. This function works with non-english versions of MapInfo Pro It works with all versions of MapInfo Pro including the English version. Align Keyword Clarification and Update MapInfo Pro introduced the MapBasic Align keyword as part of the struct declaration statement to address multiple struct alignment problems in 64-bit, especially with strings. This includes passing a default struct argument that is aligned to the default packing for Visual Studio, which is eight (8) bytes for 64bit platforms and four (4) bytes for 32bit platforms. You do not need to build custom DLLs with a one-byte alignment (/Zp1). This change better supports the DLLs built on 64-bit platforms as well as the default Windows API calls, while still accommodating user specific struct packing. Struct alignment issues manifest by passing corrupt struct data members into or out of the DLL call. MapInfo Pro now assumes a default alignment value that matches the Visual Studio default, so to successfully integrate a MapBasic program with a custom DLL, you should either: 5

6 modify the MapBasic struct declaration to match the alignment value to the DLL (such as Align1); or rebuild the DLL using the default struct member alignment (/Zp). Japanese Characters do not Display Correctly Japanese characters do not display correctly for after registering a MapBasic tool with the MapBasic TOOLTABL.DLL. This is because the TOOLTABL.DLL delivered with 15.2.x releases supports Unicode for 64-bit operating systems. A modified version of TOOLTABL.DLL is included with this release that reverts legacy interfaces back and adds explicit Unicode WideChar support as separate function and structure definitions (RegisterTool and RegisterToolW). The workaround on a 15.2.x release is to modify the *.MB to set modify the.mb, specifying WideChars on the function declaration. The following is an example of this: Declare Function RegisterTool Lib "tooltabl" WideChars ( ByVal stitle As String, ByVal snote As String, ByVal slocation As String, ByVal sowner As String, ByVal bautoload As Logical ) As Integer In version 16.0, this becomes: Declare Function RegisterTool Lib "tooltabl" ( ByVal stitle As String, ByVal snote As String, ByVal slocation As String, ByVal sowner As String, ByVal bautoload As Logical ) As Integer The *W version will be declared as: Declare Function RegisterToolW Lib "tooltabl" WideChars ( ByVal stitle As String, ByVal snote As String, ByVal slocation As String, ByVal sowner As String, ByVal bautoload As Logical ) As Integer Version 16.0 includes a new MapBasic definition file called ToolTabl.def that contains all the public function and data structure definitions exported from TOOLTABL.DLL. 6

7 Progress and Resolution of Outstanding Issues Issue Number Description and Resolution MIPRO There are performance issues with MapCAD SplitToLines. Resolution: Fixed. The MapBasic Set Table statement has a new Redraw clause that suspends redrawing the map when there are changes to a table, such as for insert, update, or delete operations. This significantly improves processing time depending on the complexity of the map and the table update action. MIPRO For the 64-bit MapBasic, there is a Unicode issue with the string equals operator. Resolution: Fixed. 7

8 3001 Summer Street Stamford CT USA Pitney Bowes Software Inc. All rights reserved