ArcGIS Pro 3.8 API Reference Guide
ArcGIS.Desktop.Reports Namespace / ReportElementFactory Class / Instance Property
Example

In This Topic
    Instance Property (ReportElementFactory)
    In This Topic
    Provides access to helper functions that create report elements.
    Syntax
    public static IReportElementFactory Instance {get;}
    Public Shared ReadOnly Property Instance As IReportElementFactory
    Example
    Create a new field in the report
    {
      //This is the gap between two fields
      double fieldIncrement = 0.9388875113593206276389;
      await QueuedTask.Run(() =>
      {
        //New field to add.
        var newReportField = new CIMReportField
        {
          Name = "POP1990",
          FieldOrder = 2,
        };
        //Get the "ReportSection element"
        var mainReportSection = report.Elements.OfType<ReportSection>().FirstOrDefault();
        if (mainReportSection == null)
          return;
    
        //Get the "ReportDetails" within the ReportSectionElement. ReportDetails is where "fields" are.
        var reportDetailsSection = mainReportSection?.Elements.OfType<ReportDetails>().FirstOrDefault();
        if (reportDetailsSection == null)
          return;
    
        //Within ReportDetails find the envelope that encloses a field.
        //We get the first CIMParagraphTextGraphic in the collection so that we can add the new field next to it.
        var lastFieldGraphic = reportDetailsSection.Elements.FirstOrDefault((r) =>
        {
          var gr = r as GraphicElement;
          if (gr == null)
          {
            return false;
          }
    
          return (gr.GetGraphic() is CIMParagraphTextGraphic ? true : false);
        });
        //Get the Envelope of the last field
        var graphicBounds = lastFieldGraphic.GetBounds();
    
        //Min and Max values of the envelope
        var xMinOfFieldEnvelope = graphicBounds.XMin;
        var yMinOfFieldEnvelope = graphicBounds.YMin;
    
        var xMaxOfFieldEnvelope = graphicBounds.XMax;
        var YMaxOfFieldEnvelope = graphicBounds.YMax;
        //create the new Envelope to be offset from the existing field
    
        MapPoint newMinPoint = MapPointBuilderEx.CreateMapPoint(xMinOfFieldEnvelope + fieldIncrement, yMinOfFieldEnvelope);
        MapPoint newMaxPoint = MapPointBuilderEx.CreateMapPoint(xMaxOfFieldEnvelope + fieldIncrement, YMaxOfFieldEnvelope);
        Envelope newFieldEnvelope = EnvelopeBuilderEx.CreateEnvelope(newMinPoint, newMaxPoint);
    
        //Create field
        GraphicElement fieldGraphic = ReportElementFactory.Instance.CreateFieldValueTextElement(reportDetailsSection, newFieldEnvelope, newReportField);
      });
    }
    Requirements

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

    ArcGIS Pro version: 3.0 or higher.
    See Also