Struct CategoryAxis 

pub struct CategoryAxis {
    pub id: u32,
    pub position: AxisPosition,
    pub cross_axis_id: u32,
    pub log_base: Option<f64>,
    pub min: Option<f64>,
    pub max: Option<f64>,
    pub reversed: bool,
    pub major_gridlines: bool,
    pub minor_gridlines: bool,
    pub title: Option<Title>,
}

The category axis (<c:catAx>, CT_CatAx) — paired with a ValueAxis for bar/line charts. Pie/Pie3D/Doughnut charts have no axes at all: confirmed structurally against the schema, CT_PieChart’s EG_PieChartShared group has no axId element whatsoever, unlike CT_BarChart/CT_LineChart which each require exactly two (axId minOccurs="2" maxOccurs="2").

Not modeled: delete, crosses/crossesAt (the axis-crossing-point choice, distinct from crossAxisId which only says which axis this one crosses, not where), numFmt, majorTickMark/minorTickMark/ tickLblPos (tick-mark cosmetics), lblAlgn/lblOffset/ tickLblSkip/tickMarkSkip/noMultiLvlLbl (category-axis-specific label placement details), spPr/txPr (axis line/text formatting — txPr specifically deferred everywhere in this crate, see lib.rs’s doc comment on why).

Fields

id: u32

position: AxisPosition

cross_axis_id: u32

<c:crossAx> — the id of the axis this one crosses (a ValueAxis in bar/line charts).

log_base: Option<f64>

<c:scaling><c:logBase val=".."/></c:scaling> — 2.=1000.

min: Option<f64>

max: Option<f64>

reversed: bool

<c:scaling><c:orientation val="maxMin"/></c:scaling> — true reverses the axis (maxMin); false/absent is the schema default (minMax).

major_gridlines: bool

minor_gridlines: bool

title: Option<Title>

Implementations

impl CategoryAxis

pub fn new(id: u32, position: AxisPosition, cross_axis_id: u32) -> CategoryAxis

Examples found in repository

examples/docx_images_and_charts.rs (line 58)

fn sample_chart_space() -> ChartSpace {
    let categories = StringData::new()
        .with_point(StringPoint::new(0, "Q1"))
        .with_point(StringPoint::new(1, "Q2"))
        .with_point(StringPoint::new(2, "Q3"));
    let values = NumericData::new()
        .with_point(NumericPoint::new(0, "1200"))
        .with_point(NumericPoint::new(1, "1350"))
        .with_point(NumericPoint::new(2, "980"));

    let series = BarSeries::new(0, 0)
        .with_categories(AxisDataSource::String(StringDataSource::literal(
            categories,
        )))
        .with_values(NumericDataSource::literal(values));

    let bar_chart = BarChart::new(BarDirection::Column, 1, 2).with_series(series);
    let category_axis = CategoryAxis::new(1, AxisPosition::Bottom, 2);
    let value_axis = ValueAxis::new(2, AxisPosition::Left, 1);

    let plot_area = PlotArea::new()
        .with_chart(ChartType::Bar(bar_chart))
        .with_axis(Axis::Category(category_axis))
        .with_axis(Axis::Value(value_axis));

    ChartSpace::new(Chart::new(plot_area))
}

examples/pptx_media.rs (line 98)

fn sample_chart_space() -> ChartSpace {
    let categories = StringData::new()
        .with_point(StringPoint::new(0, "Q1"))
        .with_point(StringPoint::new(1, "Q2"))
        .with_point(StringPoint::new(2, "Q3"));
    let values = NumericData::new()
        .with_point(NumericPoint::new(0, "1200"))
        .with_point(NumericPoint::new(1, "1350"))
        .with_point(NumericPoint::new(2, "980"));

    let series = BarSeries::new(0, 0)
        .with_categories(AxisDataSource::String(StringDataSource::literal(
            categories,
        )))
        .with_values(NumericDataSource::literal(values));

    let bar_chart = BarChart::new(BarDirection::Column, 1, 2).with_series(series);
    let category_axis = CategoryAxis::new(1, AxisPosition::Bottom, 2);
    let value_axis = ValueAxis::new(2, AxisPosition::Left, 1);

    let plot_area = PlotArea::new()
        .with_chart(ChartType::Bar(bar_chart))
        .with_axis(Axis::Category(category_axis))
        .with_axis(Axis::Value(value_axis));

    ChartSpace::new(Chart::new(plot_area))
}

examples/xlsx_images_and_charts.rs (line 70)

fn sample_chart_space() -> ChartSpace {
    let categories = StringData::new()
        .with_point(StringPoint::new(0, "Q1"))
        .with_point(StringPoint::new(1, "Q2"))
        .with_point(StringPoint::new(2, "Q3"));
    let values = NumericData::new()
        .with_point(NumericPoint::new(0, "1200"))
        .with_point(NumericPoint::new(1, "1350"))
        .with_point(NumericPoint::new(2, "980"));

    let series = BarSeries::new(0, 0)
        .with_categories(AxisDataSource::String(StringDataSource::literal(
            categories,
        )))
        .with_values(NumericDataSource::literal(values));

    let bar_chart = BarChart::new(BarDirection::Column, 1, 2).with_series(series);
    let category_axis = CategoryAxis::new(1, AxisPosition::Bottom, 2);
    let value_axis = ValueAxis::new(2, AxisPosition::Left, 1);

    let plot_area = PlotArea::new()
        .with_chart(ChartType::Bar(bar_chart))
        .with_axis(Axis::Category(category_axis))
        .with_axis(Axis::Value(value_axis));

    ChartSpace::new(Chart::new(plot_area))
}

pub fn with_min(self, min: f64) -> CategoryAxis

pub fn with_max(self, max: f64) -> CategoryAxis

pub fn with_log_base(self, log_base: f64) -> CategoryAxis

pub fn with_reversed(self, reversed: bool) -> CategoryAxis

pub fn with_major_gridlines(self, show: bool) -> CategoryAxis

pub fn with_minor_gridlines(self, show: bool) -> CategoryAxis

pub fn with_title(self, title: Title) -> CategoryAxis

Trait Implementations

impl Clone for CategoryAxis

fn clone(&self) -> CategoryAxis

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CategoryAxis

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

Formats the value using the given formatter.

impl PartialEq for CategoryAxis

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CategoryAxis