Struct Connector 

pub struct Connector {
    pub id: u32,
    pub name: String,
    pub properties: ShapeProperties,
    pub start_connection: Option<ShapeConnection>,
    pub end_connection: Option<ShapeConnection>,
}

A straight/elbow/curved connector line (<p:cxnSp>, CT_Connector), typically used to visually link two other shapes.

Not grounded on a real fixture — see this module’s own top-level doc comment. Structure follows ECMA-376’s CT_Connector/ CT_ConnectorNonVisual directly: a connector’s own <p:spPr> is the exact same CT_ShapeProperties content type an autoshape’s <p:spPr> uses (position/geometry/fill/line), so properties reuses drawing::ShapeProperties verbatim, same as AutoShape — only the non-visual wrapper element name (p:cxnSp/p:nvCxnSpPr instead of p:sp/p:nvSpPr) and the optional start/end shape attachments differ. When properties.geometry is unset, the writer defaults to <a:prstGeom prst="line"> (a straight connector) rather than AutoShape’s own rect default — the same “always write geometry explicitly” discipline, just with a connector-appropriate default preset.

Fields

id: u32

<p:cNvPr id=".."> — same uniqueness rules as AutoShape::id.

name: String

<p:cNvPr name="..">.

properties: ShapeProperties

<p:spPr>’s content — position/size, outline geometry, fill, line.

start_connection: Option<ShapeConnection>

<p:nvCxnSpPr><p:cNvCxnSpPr><a:stCxn id=".." idx=".."/> — which other shape (and which of its connection sites) this connector’s start point is attached to. None for a floating, unattached start point (positioned by properties’ own xfrm alone).

end_connection: Option<ShapeConnection>

<a:endCxn id=".." idx=".."/> — same as start_connection, for the connector’s end point.

Implementations

impl Connector

pub fn new(id: u32, name: impl Into<String>) -> Connector

Creates a floating connector (no shape attachments) with no explicit position/size/line.

Examples found in repository

examples/pptx_grouping_and_connectors.rs (line 105)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_grouping_and_connectors.pptx");

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());
    Ok(())
}

pub fn with_properties(self, properties: ShapeProperties) -> Connector

Sets this connector’s position/size/line/fill.

Examples found in repository

examples/pptx_grouping_and_connectors.rs (lines 106-118)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_grouping_and_connectors.pptx");

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());
    Ok(())
}

pub fn with_start_connection(self, shape_id: u32, index: u32) -> Connector

Attaches this connector’s start point to another shape’s connection site.

Examples found in repository

examples/pptx_grouping_and_connectors.rs (line 119)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_grouping_and_connectors.pptx");

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());
    Ok(())
}

pub fn with_end_connection(self, shape_id: u32, index: u32) -> Connector

Attaches this connector’s end point to another shape’s connection site.

Examples found in repository

examples/pptx_grouping_and_connectors.rs (line 120)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_grouping_and_connectors.pptx");

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());
    Ok(())
}

Trait Implementations

impl Clone for Connector

fn clone(&self) -> Connector

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Connector

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl PartialEq for Connector

fn eq(&self, other: &Connector) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Connector