DeactivateMapFrame Method

In This Topic

Deactivate the ActivatedMapFrame on the layout view. This method must be called on the UI thread.

Syntax

Visual Basic (Declaration)
C#

Public Sub DeactivateMapFrame()

public void DeactivateMapFrame()

Exceptions

Exception	Description
System.InvalidOperationException	Needs to run on the GUI thread
System.InvalidOperationException	Layout view must be the active view

Remarks

This method must be called on the UI thread (and not the MCT as is most commonly the case with most other synchronous API methods) or an System.InvalidOperationException will be thrown. The layout view you are deactivating the ActivatedMapFrame "on" must be the current active view or an System.InvalidOperationException will be thrown. The deactivated map frame will remain selected.

Example

Deactivate Map Frame

{
  //Deactivate any activated map frame
  //Note: we are on the UI thread!
  layoutView.DeactivateMapFrame();//no-op if nothing activated

  //or - check if a  map frame is activated first...
  if (layoutView.ActivatedMapFrame != null)
    //Note: we are on the UI thread!
    layoutView.DeactivateMapFrame();
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.1 or higher.

Reference

LayoutView Class
LayoutView Members

Send feedback