ArcGIS Pro 3.2 API Reference Guide
ArcGIS.Desktop.Layouts Namespace / Element Class / ConvertToGraphics Method
Example

In This Topic
    ConvertToGraphics Method (Element)
    In This Topic
    Convert the element to graphics. This method must be called on the MCT. Use QueuedTask.Run.
    Syntax
    public IList<IElement> ConvertToGraphics()
    Public Function ConvertToGraphics() As IList(Of IElement)

    Return Value

    The list result will contain just one, selected GroupElement that contains all the individual element within it.
    Exceptions
    ExceptionDescription
    This method must be called within the lambda passed to QueuedTask.Run.
    Remarks
    If the element cannot be converted then null is returned. Refer to CanConvertToGraphics
    . The element is removed from the layout and the new graphic elements are added in its place.
    Example
    Element_ConvertToGraphics
    //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 11, Windows 10

    ArcGIS Pro version: 3 or higher.
    See Also