| 345 | == !QueryMapFeatures == |
| 346 | === Overview === |
| 347 | === Parameters === |
| 348 | || '''Name''' || '''Value''' || '''Required''' || '''Description''' || |
| 349 | || [#Operation1.0 OPERATION] || GETMAPIMAGE || Yes || Operation to execute || |
| 350 | || [#Version1.0 VERSION] || 1.2.0 || Yes || Operation version || |
| 351 | || [#Session1.0 SESSION] || session identifier || Yes || !MapGuide session identifier containing map to display. || |
| 352 | || [#MapName1.0 MAPNAME] || text || Yes ||Name of the map to display.[[BR]]This corresponds to the !GetName() value for the resource identifier. || |
| 353 | || [#LayerNames1.0 LAYERNAMES] || text || Optional || Comma separated list of layer names. || |
| 354 | || [#MaxFeatures1.0 MAXFEATURES] || integer || Yes || Maximum number of features to select. || |
| 355 | || [#Geometry1.0 GEOMETRY] || text || Yes || WKT string representing the selection geometry. || |
| 356 | || [#SelectionVariant1.0 SELECTIONVARIANT] || text || Yes || Geometric operation to use while selecting. || |
| 357 | || [#Persist1.0 PERSIST] || 0/1 || Yes || If true, selection is saved to map. || |
| 358 | || [#LayerAttributeFilter1.0 LAYERATTRIBUTEFILTER] || integer || Optional || Filter based on layer attributes. || |
| 359 | || [#FeatureFilter1.0 FEATUREFILTER] || text || Optional || Filter based on previous selected features. || |
| 360 | ==== LAYERNAMES Parameter ==== #LayerNames1.0 |
| 361 | Comma separated list of layer names to restrict the selection to. Names can be obtained from !MgLayer.!GetName() |
| 362 | ==== MAXFEATURES Parameter ==== #MaxFeatures1.0 |
| 363 | Maximum number of features to select. If this value is set to "-1", all matching features will be selected. |
| 364 | ==== GEOMETRY Parameter ==== #Geometry1.0 |
| 365 | WKT string representing the selection geometry, eg. "POLYGON((10 10, 10 20, 20 20, 20 15, 10 10))" |
| 366 | ==== SELECTIONVARIANT Parameter ==== #SelectionVariant1.0 |
| 367 | Geometric operation to use for testing features against the supplied geometry. The following operations are supported: |
| 368 | * "TOUCHES" - Feature geometry touches supplied geometry |
| 369 | * "INTERSECTS" - Feature geometry intersects supplied geometry |
| 370 | * "WITHIN" - Feature geometry lies within supplied goemetry |
| 371 | * "ENVELOPEINTERSECTS" - Envelopes of feature and supplied geometry intersect. '''Note: This was added in !MapGuide 2.1.0''' |
| 372 | ==== PERSIST Parameter ==== #Persist1.0 |
| 373 | If set to "1", the resulting selection from !QueryMapFeatures will be persisted to the map and visible on the next call to !GetDynamicMapOverlayImage or !GetMapImage. |
| 374 | ==== LAYERATTRIBUTEFILTER Parameter ==== #LayerAttributeFilter1.0 |
| 375 | Bitmask specifying the attributes a layer must have to be considered in the selection process. The following attributes are supported: |
| 376 | * 1 - Layer is visible |
| 377 | * 2 - Layer is selectable |
| 378 | * 4 - Layer has a tooltip defined |
| 379 | |
| 380 | Combinations of one or more attributes |
| 381 | |
| 382 | ==== FEATUREFILTER Parameter ==== #FeatureFilter1.0 |
| 383 | XML filter describing a set of previously selected features. This paramter is useful for obtaining the attribute values for a set of selected features. The XML text can be retrieved from !MgSelection.!ToXml(). |
| 384 | |
| 385 | === Usage === |
| 386 | === Technical Notes === |