topic How to programmatically rotate map in a map frame on layout? in ArcGIS Pro SDK Questions

How to programmatically rotate map in a map frame on layout?

GISTaldor — Tue, 21 Jun 2022 14:13:06 GMT

Hi.

I'm trying to make a rotated map ona layout - i.e. not rotate the map frame itself, but rather the map inside it (since I want it to be on a "landscape" page and some of my data extents are "thin" and long).

I figured out how this can be achieved manually (either by choosing Properties of this map in "Contents" view):

or Map Frame properties on the layout:

Both settings are actually the same one (at least it seems so) and when one is changed, another is also updated automatically.

Here's an example of a map rotated 90 degrees, so that its corresponding north arrow points to the left edge of the layout.

Now, my question is: how can I do this programmatically. I couldn't find any property/method for that.

If I use this - the map frame itself (i.e. the layout element) is rotated, which isn't what I want.

And I need the map frame to remain as it is and the map inside it to rotate.

Thanks.

Re: How to programmatically rotate map in a map frame on layout?

CharlesMacleod — Tue, 21 Jun 2022 16:23:30 GMT

This will get a lot easier at 3.0 (which will be released on Thurs). Display constraints, at 3.0 can be set using a "GetAutoCamera()/SetAutoCamera(autoCamera)" method pair. Display constraints will be explained here: https://github.com/esri/arcgis-pro-sdk/wiki/ProConcepts-Layouts#map-frame-display-constraints

This link will be broken until Thursday because it has not been released yet.

In the interim, u can use this code. Be advised that not all map frames can be rotated, especially if the map frame is linked or is a map series frame. Generally speaking, if the current display constraint is any of these then it should be fine. I did add a some defensive code to check for the most obvious conditions (such as 3D).

internal class RotateTheMap : Button { private static double _angle = 0; protected override void OnClick() { if (LayoutView.Active == null) return; var layout = LayoutView.Active.Layout; var mapFrame = layout.Elements.OfType<MapFrame>().FirstOrDefault(); if (mapFrame == null) return; QueuedTask.Run(() => { var def = mapFrame.GetDefinition() as CIMMapFrame; if (def.View.ViewingMode != MapViewingMode.Map) return; //2D only _angle -= 15;//Counter-clockwise if (_angle < -345) _angle = 0; var autoCamera = def.AutoCamera; if (autoCamera == null) { //unusual def.AutoCamera = new CIMAutoCamera() { Camera = new CIMViewCamera(), AutoCameraType = AutoCameraType.Extent }; } else if (autoCamera.Source != AutoCameraSource.None && autoCamera.Source != AutoCameraSource.Fixed) { return; } def.View.Camera.Heading = _angle; mapFrame.SetDefinition(def); }); } }

Re: How to programmatically rotate map in a map frame on layout?

GISTaldor — Wed, 22 Jun 2022 11:26:44 GMT

Hi.

Thanks for the code sample, it really helped.