feat(working-with-shapes): add 459 compiler-validated C# examples - Working With Shapes [26.8.0/net8.0]

[agent-aspose-diagram-examples]

Working With Shapes — Compiler-Validated C# Examples

What this PR does

Adds 459 AI-generated, compiler-validated C# examples for the Working With Shapes category of Aspose.Diagram for .NET.

All examples were generated by the Aspose.Diagram Examples Generator Agent and passed the full three-attempt validation pipeline before being included.

Validation Summary

Check	Result
dotnet build	✅ Passed — zero compiler errors
dotnet run	✅ Passed — clean execution
Aspose.Diagram Version	26.8.0
Target Framework	net8.0
Examples Added	459

Pipeline

Each example was generated and validated through:

1. Attempt 1 — MCP direct code retrieval and assembly
2. Attempt 2 — MCP retrieval with injected API correction rules
3. Attempt 3 — LLM repair pass with compiler errors and rules

Only examples that passed both dotnet build and dotnet run are included in this PR.

Examples Added

File	Task Description
access-a-shape-using-its-name-and-compare-its-id-with-the-expected-identifier.cs	Access a shape using its name and compare its id with the expected identifier
access-line-property-details-like-dash-style-and-thickness-when-line-inheritance-is-enabled.cs	Access line property details like dash style and thickness when line inheritance is enabled
access-the-inheritfill-property-of-a-shape-to-retrieve-inherited-fill-settings.cs	Access the inheritfill property of a shape to retrieve inherited fill settings
access-the-layout-property-of-a-connector-shape-and-modify-its-x-and-y-coordinates-programmatically.cs	Access the layout property of a connector shape and modify its x and y coordinates programmatically
add-a-circle-shape-with-a-specific-radius-to-the-diagram-s-shapes-collection.cs	Add a circle shape with a specific radius to the diagram s shapes collection
add-a-custom-connection-point-at-coordinates-1-2-3-4-to-a-shape-using-connections-add-method.cs	Add a custom connection point at coordinates 1 2 3 4 to a shape using connections add method
add-a-master-shape-from-a-stencil-file-to-the-retrieved-page-using-its-master-name.cs	Add a master shape from a stencil file to the retrieved page using its master name
add-a-new-rectangle-shape-to-the-page-using-diagram-addshape-with-master-id-and-position.cs	Add a new rectangle shape to the page using diagram addshape with master id and position
add-a-rectangle-shape-with-defined-width-and-height-to-the-diagram-s-shapes-collection.cs	Add a rectangle shape with defined width and height to the diagram s shapes collection
add-a-triangle-shape-and-set-its-geometry-points-before-inserting-into-the-shapes-collection.cs	Add a triangle shape and set its geometry points before inserting into the shapes collection
add-connection-points-at-the-four-corners-of-a-rectangular-shape-by-calculating-corner-coordinates-from-locpin-values.cs	Add connection points at the four corners of a rectangular shape by calculating corner coordinates from locpin values
add-custom-property-to-a-shape-indicating-the-applied-theme-name-for-future-reference.cs	Add custom property to a shape indicating the applied theme name for future reference
add-error-handling-to-skip-shapes-lacking-locpinx-y-cells-while-calculating-absolute-coordinates.cs	Add error handling to skip shapes lacking locpinx y cells while calculating absolute coordinates
add-the-modified-shape-back-to-the-page-s-shapes-collection-and-ensure-it-appears-in-the-diagram.cs	Add the modified shape back to the page s shapes collection and ensure it appears in the diagram
adjust-line-inheritance-flag-based-on-shape-type-enabling-inheritance-for-connectors-only.cs	Adjust line inheritance flag based on shape type enabling inheritance for connectors only
adjust-the-duplicated-shape-s-position-by-ten-units-and-assign-it-a-new-unique-id.cs	Adjust the duplicated shape s position by ten units and assign it a new unique id
adjust-the-layout-geometry-of-a-shape-after-theme-change-to-maintain-proper-alignment-on-the-page.cs	Adjust the layout geometry of a shape after theme change to maintain proper alignment on the page
adjust-the-perspective-angle-of-a-shape-to-30-degrees-before-exporting-to-pdf.cs	Adjust the perspective angle of a shape to 30 degrees before exporting to pdf
adjust-the-width-of-a-group-sub-shape-to-5-0-inches-by-invoking-setwidth-with-double-precision.cs	Adjust the width of a group sub shape to 5 0 inches by invoking setwidth with double precision
adjust-the-y-coordinate-of-a-shape-by-adding-a-defined-offset-value.cs	Adjust the y coordinate of a shape by adding a defined offset value
after-adding-a-shape-immediately-retrieve-its-geometry-data-to-confirm-correct-placement.cs	After adding a shape immediately retrieve its geometry data to confirm correct placement
after-rotating-a-shape-capture-its-new-bounding-box-coordinates-and-write-them-to-a-json-report.cs	After rotating a shape capture its new bounding box coordinates and write them to a json report
apply-a-10-degree-rotationzangle-to-all-shapes-and-export-the-diagram-to-pdf.cs	Apply a 10 degree rotationzangle to all shapes and export the diagram to pdf
apply-a-3-d-rotation-transformation-to-a-shape-after-theme-assignment-to-create-perspective-view.cs	Apply a 3 d rotation transformation to a shape after theme assignment to create perspective view
apply-a-5-degree-rotationxangle-to-shapes-taller-than-200-points-and-export-to-pdf.cs	Apply a 5 degree rotationxangle to shapes taller than 200 points and export to pdf
apply-a-dashed-line-style-to-a-shape-by-assigning-the-appropriate-dash-pattern.cs	Apply a dashed line style to a shape by assigning the appropriate dash pattern
apply-a-global-line-style-change-to-all-shapes-and-save-the-updated-diagram.cs	Apply a global line style change to all shapes and save the updated diagram
apply-a-global-setting-to-enforce-fill-inheritance-across-all-shapes-in-a-diagram-before-export.cs	Apply a global setting to enforce fill inheritance across all shapes in a diagram before export
apply-a-gradient-fill-theme-to-shapes-whose-area-exceeds-a-specified-size-threshold.cs	Apply a gradient fill theme to shapes whose area exceeds a specified size threshold
apply-a-gradient-fill-to-shapes-while-preserving-existing-paragraph-formatting-and-colors.cs	Apply a gradient fill to shapes while preserving existing paragraph formatting and colors
apply-a-predefined-theme-to-the-newly-created-shape-and-confirm-theme-properties-are-applied.cs	Apply a predefined theme to the newly created shape and confirm theme properties are applied
apply-a-rotation-of-45-degrees-to-a-shape-s-xform-and-verify-orientation.cs	Apply a rotation of 45 degrees to a shape s xform and verify orientation
apply-a-scaling-factor-of-1-2-to-both-width-and-height-of-a-shape-using-setwidth-and-setheight.cs	Apply a scaling factor of 1 2 to both width and height of a shape using setwidth and setheight
apply-a-theme-to-shapes-only-when-their-existing-fill-color-matches-a-specific-rgb-value.cs	Apply a theme to shapes only when their existing fill color matches a specific rgb value
apply-a-theme-to-shapes-whose-names-start-with-process-using-a-case-insensitive-comparison.cs	Apply a theme to shapes whose names start with process using a case insensitive comparison
apply-a-uniform-distancefromground-of-15-points-to-all-shapes-in-the-diagram.cs	Apply a uniform distancefromground of 15 points to all shapes in the diagram
apply-combined-x-y-and-z-rotations-of-30-degrees-each-to-a-shape.cs	Apply combined x y and z rotations of 30 degrees each to a shape
apply-conditional-formatting-to-paragraphs-based-on-their-length-using-larger-fonts-for-longer-texts.cs	Apply conditional formatting to paragraphs based on their length using larger fonts for longer texts
apply-conditional-logic-to-enable-fill-inheritance-only-for-shapes-whose-area-exceeds-a-threshold.cs	Apply conditional logic to enable fill inheritance only for shapes whose area exceeds a threshold
apply-conditional-logic-to-set-shape-height-only-if-current-height-is-less-than-a-specified-threshold.cs	Apply conditional logic to set shape height only if current height is less than a specified threshold
apply-different-themes-to-shapes-based-on-their-layer-assignment-within-the-diagram.cs	Apply different themes to shapes based on their layer assignment within the diagram
apply-the-preset-theme-bubble-to-the-retrieved-shape-and-confirm-theme-properties-changed.cs	Apply the preset theme bubble to the retrieved shape and confirm theme properties changed
assign-a-custom-property-category-to-a-shape-and-later-query-shapes-sharing-this-property.cs	Assign a custom property category to a shape and later query shapes sharing this property
attach-a-newly-created-connector-to-a-gluing-enabled-shape-and-verify-successful-attachment.cs	Attach a newly created connector to a gluing enabled shape and verify successful attachment
automatically-disable-gluing-on-shapes-once-they-reach-a-maximum-number-of-attached-connectors.cs	Automatically disable gluing on shapes once they reach a maximum number of attached connectors
batch-convert-all-shapes-across-multiple-diagrams-to-high-resolution-png-files.cs	Batch convert all shapes across multiple diagrams to high resolution png files
batch-convert-all-shapes-on-a-specific-page-to-individual-svg-files.cs	Batch convert all shapes on a specific page to individual svg files
batch-job-sets-line-jump-style-to-arc-for-connectors-whose-source-shape-is-a-decision-node.cs	Batch job sets line jump style to arc for connectors whose source shape is a decision node
batch-process-a-folder-of-vsdx-files-setting-each-connector-s-jump-style-to-none.cs	Batch process a folder of vsdx files setting each connector s jump style to none
batch-process-diagrams-in-a-folder-rotating-all-shapes-named-arrow-by-ninety-degrees-before-saving.cs	Batch process diagrams in a folder rotating all shapes named arrow by ninety degrees before saving
batch-process-multiple-vsdx-files-in-a-directory-resizing-each-target-shape-to-a-predefined-width.cs	Batch process multiple vsdx files in a directory resizing each target shape to a predefined width
batch-rotate-all-shapes-with-ids-greater-than-50-by-fifteen-degrees-across-multiple-pages.cs	Batch rotate all shapes with ids greater than 50 by fifteen degrees across multiple pages
benchmark-performance-impact-of-toggling-fill-inherit-on-large-diagrams-containing-thousands-of-shapes.cs	Benchmark performance impact of toggling fill inherit on large diagrams containing thousands of shapes
calculate-absolute-pinx-and-piny-for-all-sub-shapes-within-a-group-and-log-results-to-console.cs	Calculate absolute pinx and piny for all sub shapes within a group and log results to console
calculate-the-bounding-box-of-a-group-shape-by-aggregating-absolute-pinx-y-values-of-its-child-shapes.cs	Calculate the bounding box of a group shape by aggregating absolute pinx y values of its child shapes
change-a-shape-s-line-color-to-blue-and-set-line-weight-to-two-points.cs	Change a shape s line color to blue and set line weight to two points
change-a-shape-s-line-weight-to-a-new-value-and-verify-the-update-via-the-line-property.cs	Change a shape s line weight to a new value and verify the update via the line property
change-the-fill-gradient-of-a-shape-to-a-two-color-scheme-after-theme-application.cs	Change the fill gradient of a shape to a two color scheme after theme application
change-the-second-paragraph-s-font-style-to-italic-and-set-its-text-color-to-dark-blue.cs	Change the second paragraph s font style to italic and set its text color to dark blue
change-the-shadow-effect-of-a-shape-after-applying-a-theme-to-enhance-visual-depth.cs	Change the shadow effect of a shape after applying a theme to enhance visual depth
check-for-missing-shapes-by-id-before-applying-themes-and-log-any-discrepancies-found.cs	Check for missing shapes by id before applying themes and log any discrepancies found
check-that-locpinx-and-locpiny-cells-contain-numeric-values-before-performing-absolute-pin-calculations.cs	Check that locpinx and locpiny cells contain numeric values before performing absolute pin calculations
check-the-line-inheritance-status-of-a-shape-by-reading-the-line-inherit-attribute.cs	Check the line inheritance status of a shape by reading the line inherit attribute
check-whether-a-shape-inherits-its-fill-from-a-master-and-log-the-inheritance-status.cs	Check whether a shape inherits its fill from a master and log the inheritance status
check-whether-a-shape-is-gluing-enabled-before-attempting-to-attach-a-connector.cs	Check whether a shape is gluing enabled before attempting to attach a connector
clone-a-shape-modify-its-width-and-place-the-cloned-instance-on-a-different-page.cs	Clone a shape modify its width and place the cloned instance on a different page
clone-a-shape-preserve-its-gluing-settings-and-insert-the-cloned-shape-elsewhere-in-the-diagram.cs	Clone a shape preserve its gluing settings and insert the cloned shape elsewhere in the diagram
clone-an-existing-shape-apply-a-different-theme-to-the-clone-and-place-it-on-another-page.cs	Clone an existing shape apply a different theme to the clone and place it on another page
combine-fill-and-line-inheritance-checks-to-determine-if-a-shape-fully-inherits-formatting-from-its-master.cs	Combine fill and line inheritance checks to determine if a shape fully inherits formatting from its master
compare-fill-inheritance-values-between-original-and-cloned-diagrams-to-ensure-consistency-after-duplication.cs	Compare fill inheritance values between original and cloned diagrams to ensure consistency after duplication
compare-line-jump-styles-between-two-diagram-versions-to-detect-visual-differences.cs	Compare line jump styles between two diagram versions to detect visual differences
compare-paragraph-text-between-two-versions-of-a-diagram-and-highlight-differences-programmatically.cs	Compare paragraph text between two versions of a diagram and highlight differences programmatically
compare-shape-appearance-before-and-after-theme-application-by-rendering-thumbnails-and-saving-them.cs	Compare shape appearance before and after theme application by rendering thumbnails and saving them
compare-the-fill-colors-of-two-shapes-and-log-a-warning-if-they-differ.cs	Compare the fill colors of two shapes and log a warning if they differ
compare-visual-output-of-shapes-with-keeptextflat-true-in-pdf-and-svg-formats.cs	Compare visual output of shapes with keeptextflat true in pdf and svg formats
configure-the-rotation-type-to-perspective-and-assign-a-45-degree-perspective-angle.cs	Configure the rotation type to perspective and assign a 45 degree perspective angle
connect-a-star-shape-to-a-rectangle-using-source-index-1-and-target-index-2.cs	Connect a star shape to a rectangle using source index 1 and target index 2
connect-sub-shapes-from-three-different-groups-using-separate-connectors-and-list-resulting-connection-ids.cs	Connect sub shapes from three different groups using separate connectors and list resulting connection ids
connect-two-sub-shapes-from-different-group-shapes-using-page-connectshapesviaconnector-method.cs	Connect two sub shapes from different group shapes using page connectshapesviaconnector method
convert-a-shape-to-html-format-preserving-visual-styling-accurately.cs	Convert a shape to html format preserving visual styling accurately
convert-a-shape-to-pdf-format-using-appropriate-save-options.cs	Convert a shape to pdf format using appropriate save options
convert-a-shape-to-svg-and-ensure-its-line-dash-pattern-is-preserved.cs	Convert a shape to svg and ensure its line dash pattern is preserved
convert-a-shape-to-svg-and-verify-that-text-elements-retain-original-fonts.cs	Convert a shape to svg and verify that text elements retain original fonts
convert-a-shape-to-svg-format-using-default-export-settings.cs	Convert a shape to svg format using default export settings
convert-a-shape-to-swf-format-and-handle-potential-conversion-errors.cs	Convert a shape to swf format and handle potential conversion errors
convert-multiple-shapes-to-svg-in-a-loop-appending-each-result-to-a-single-html-document.cs	Convert multiple shapes to svg in a loop appending each result to a single html document
copy-a-shape-s-custom-data-cells-to-another-shape-and-verify-data-integrity-after-copying.cs	Copy a shape s custom data cells to another shape and verify data integrity after copying
copy-an-entire-page-s-pagesheet-to-a-newly-created-page-while-preserving-background-settings.cs	Copy an entire page s pagesheet to a newly created page while preserving background settings
copy-an-existing-hexagon-shape-to-a-new-location-on-the-same-page-using-offset-coordinates.cs	Copy an existing hexagon shape to a new location on the same page using offset coordinates
copy-shapes-from-one-diagram-to-another-while-offsetting-ids-to-avoid-conflicts.cs	Copy shapes from one diagram to another while offsetting ids to avoid conflicts
copy-the-shape-together-with-its-paragraphs-to-another-page-named-page-3-preserving-formatting.cs	Copy the shape together with its paragraphs to another page named page 3 preserving formatting
count-the-number-of-shapes-on-each-page-of-a-diagram-and-generate-a-summary-report.cs	Count the number of shapes on each page of a diagram and generate a summary report
create-a-batch-job-that-disables-gluing-on-all-shapes-exceeding-a-defined-size-threshold.cs	Create a batch job that disables gluing on all shapes exceeding a defined size threshold
create-a-batch-script-that-processes-all-diagrams-in-a-zip-archive-adjusting-specified-shape-sizes.cs	Create a batch script that processes all diagrams in a zip archive adjusting specified shape sizes
create-a-connector-shape-between-two-existing-shapes-automatically-selecting-the-nearest-connection-points.cs	Create a connector shape between two existing shapes automatically selecting the nearest connection points
create-a-diagnostic-tool-that-flags-connectors-lacking-explicit-line-jump-style-definitions.cs	Create a diagnostic tool that flags connectors lacking explicit line jump style definitions
create-a-group-containing-all-connector-shapes-and-confirm-connections-after-saving.cs	Create a group containing all connector shapes and confirm connections after saving
create-a-linq-query-to-select-shapes-whose-names-start-with-connector-and-adjust-their-widths.cs	Create a linq query to select shapes whose names start with connector and adjust their widths
create-a-macro-that-automatically-adds-a-timestamp-paragraph-to-every-new-shape-on-a-page.cs	Create a macro that automatically adds a timestamp paragraph to every new shape on a page
create-a-macro-that-iterates-over-selected-shapes-and-flips-their-fill-inheritance-status.cs	Create a macro that iterates over selected shapes and flips their fill inheritance status
... and 359 more files	See branch for full list

Validation Details

• ✅ dotnet build — compiled without errors against Aspose.Diagram for .NET 26.8.0
• ✅ dotnet run — executed without unhandled exceptions
• 🤖 Generated by Aspose.Diagram Examples Generator Agent v2.0

---

This PR was created automatically by the Aspose.Diagram Examples Generator Agent. Merge after reviewing the examples above.