Developer's Guide - MapGuide Open Source - OSGeo

Recommendations

Info

page, then emit a function containing the correct parameters. Use this technique when you want the Viewer to change when the page loads. ■ Execute the JavaScript inside the script frame. Use this technique when you want the Viewer to change as a result of an action in the Map<strong>Guide</strong> page, without reloading the page. ■ Call the Viewer API during client-side interaction with the page or using the Invoke Script command type in the web layout. Use this technique when you want to call the API directly from the tool bar. NOTE It is important to know the relationships between the frames. Pages in the task area must refer to parent.parent.mapFrame in order to traverse the frame hierarchy properly. However, if the same function executes from the script frame or the task bar, it only needs to refer to parent.mapFrame, because the script frame and the map frame are part of the same frame set. Many Viewer API calls will generate requests to the site server, either to refresh data in the Viewer or to notify the site server of a change in Viewer state. These requests are generated automatically. Calling the Viewer API from the Task Pane Use this technique when you want the Viewer API calls to be made when the page loads. For example, if you have a task in the task list that zooms the map to a pre-defined location, then you do not need any user input. The Viewer should zoom as soon as the page loads. The map frame contains a JavaScript function to center the map to a given coordinate at a given map scale. To call this function from a page loading in the task pane, create a function that will be executed when the onLoad event occurs. The following is a simple example. If you add this to the task list and select the task, the displayed map will reposition to the given location. 14 | Chapter 1 Introduction
Viewer Sample Application - Zoom function OnPageLoad() { parent.parent.ZoomToView(-87.7116768, 43.7766789973, 5000, true); } Zooming... Calling the Viewer API from the Script Frame Use this technique when you want the Viewer API calls to be made as a result of an action in the calling page, but you do not want to reload the page. For example, you may have a page that generates a list of locations and you would like the user to be able to jump directly to any location, while leaving the list still available in the task pane. In this case, your page can load another page in the hidden script frame, using target="scriptFrame" as part of the tag. This requires that you create a separate page to load in the script frame and that you pass the necessary parameters when the page loads. For example, the sample application includes a page named gotopoint.php. This is designed to be run in the script frame. The element is empty, so the page does not produce any output. Instead, it emits a JavaScript function to execute when the page loads. This function calls the ZoomToView() function in the Viewer API. To execute gotopoint.php from another page, create a hyperlink that passes the coordinates and zoom amount as HTTP GET parameters. Set target="scriptFrame". When a user clicks the link, gotopoint.php is loaded in the script frame, but the calling page does not change. For example, the following could be included as part of a page in the task pane: Map<strong>Guide</strong> Viewer API | 15
Page 1 and 2: MapGuide Open Source Developer’s
Page 3 and 4: Contents Chapter 1 Introduction . .
Page 5: Another Way To Create Layers . . .
Page 8 and 9: What This Guide Covers This guide d
Page 11 and 12: This next sample MapGuide page disp
Page 13 and 14: Example Code This sample illustrate
Page 15 and 16: echo 'Map ' . $map->GetName() . ' u
Page 17 and 18: displays the spatial reference syst
Page 19: Viewer Frames Most custom MSPs disp
Page 23 and 24: Embedding a Viewer in Your Own Page
Page 25 and 26: Resources and Repositories A MapGui
Page 27: $mapDefId = new MgResourceIdentifie
Page 30 and 31: Overview of Layers Layers represent
Page 32 and 33: Layer Style Layer Visibility The da
Page 34 and 35: function OnPageLoad() { parent.Zoom
Page 36 and 37: MgInitializeWebTier ($webconfigFile
Page 39 and 40: Working With Feature Data 3 In this
Page 41 and 42: Querying Feature Data In order to w
Page 43 and 44: Examples These examples assume that
Page 45 and 46: $districtQuery = new MgFeatureQuery
Page 47 and 48: $districtQuery = new MgFeatureQuery
Page 49 and 50: There are different selection tools
Page 51 and 52: Script command. See Example: Listin
Page 53 and 54: 4 Initialize the MgSelection object
Page 55 and 56: the $layerClassName = $layer->GetFe
Page 57 and 58: The PHP code in this example create
Page 59 and 60: $resourceService = $siteConnection-
Page 61 and 62: Modifying Maps and Layers In this c
Page 63 and 64: This example ■ loads a layer that
Page 65 and 66: } // ... The page then goes on to s
Page 67 and 68: Function CreateScaleRange() CreateA
Page 69 and 70: Function CreateLineTypeStyle() Crea
Page 71 and 72:
... //-----------------------------
Page 73 and 74:
Adding Layers To A Map The precedin
Page 75 and 76:
function add_layer_resource_to_map(
Page 77 and 78:
Analyzing Features In this chapter
Page 79 and 80:
■ MgLineString — a series of co
Page 81 and 82:
To create an MgCoordinateSystem obj
Page 83 and 84:
■ Determine the SRS for the featu
Page 85 and 86:
Inserting, Deleting, and Updating F
Page 87 and 88:
Example $queryOptions = new MgFeatu
Page 89 and 90:
} The geometries for the selected f
Page 91 and 92:
$map->Save($resourceService); The f
Page 93 and 94:
} 'ResourceId')->item(0); $featureS
Page 95 and 96:
Digitizing and Redlining In this ch
Page 97 and 98:
For example, see task_pane_redlinin
Page 99 and 100:
Create a temporary feature source t
Page 101 and 102:
Custom Output In this chapter ■ I
Page 103 and 104:
■ Images can be copied to the Win
Page 105:
$dwfVersion = new MgDwfVersion("6.0
Page 108 and 109:
G geographic coordinates 74 geometr
Page 110:
Viewer, embedded in HTML page 17 Vi
show all

Developer's Guide - MapGuide Open Source - OSGeo

Create successful ePaper yourself

Delete template?

Save as template?