ConvertToGraphics Method

Convert the element to graphics. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public Element[] ConvertToGraphics()

Public Function ConvertToGraphics() As Element()

Return Value

The list result will contain just one, selected GroupElement that contains all the individual element within it.

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method must be called within the lambda passed to QueuedTask.Run.
System.InvalidOperationException	Map has reached maximum graphics count limit of 4000 elements. One or more elements cannot be created.
System.InvalidOperationException	Map has reached maximum graphics size limit of 10 MB. One or more elements cannot be created.

Remarks

The element is removed from the layout and the new graphic elements are added in its place.

Example

//Convert a legend to a graphic and move the Title to the bottom of the legend and also move
//the label in the contents pane to the bottom of the list.

//Perform on the worker thread
await QueuedTask.Run(() =>
{
  Legend leg = layout.FindElement("Legend") as Legend;
  GroupElement result = leg.ConvertToGraphics().First() as GroupElement;
  Element firstElm = result.Elements.First();  //Note: Bottom element is first in drawing order.
  foreach (Element elm in result.Elements)
  {
    if (elm.Name == "Title")
    {
      elm.SetY(firstElm.GetY() - 0.25);  //Move title below other legend elements
      elm.SetTOCPositionAbsolute(result, false);  // Move Title item in TOC to bottom as well
    }
  }
});

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 7

Reference

Element Class
Element Members