Struct Control 

pub struct Control {
    pub kind: ControlKind,
    pub name: Option<String>,
    pub x: f32,
    pub y: f32,
    pub width: f32,
    pub height: f32,
    pub style_name: Option<String>,
    pub style: Style,
    pub visible: Option<String>,
    pub rules: Vec<FormattingRule>,
}

A printable element of a band.

Fields

kind: ControlKind

What the control is and its content.

name: Option<String>

An optional name, shown in the designer and in error messages.

x: f32

Left edge, from the band’s left.

y: f32

Top edge, from the band’s top.

width: f32

Width.

height: f32

Height before growing.

style_name: Option<String>

A named style from Report::styles.

style: Style

Style settings on top of the named style.

visible: Option<String>

The control is left out when this is false.

rules: Vec<FormattingRule>

Conditional formatting, applied in order when the condition holds.

Implementations

impl Control

pub fn label(text: impl Into<String>) -> Self

A label with fixed text.

pub fn chart( kind: ChartKind, argument: impl Into<String>, value: impl Into<String>, ) -> Self

A chart: one series of value per argument.

pub fn barcode(symbology: Symbology, expression: impl Into<String>) -> Self

A barcode showing the value of expression.

pub fn picture(source: impl Into<String>) -> Self

A picture from a data: address or base64 text.

pub fn link(text: impl Into<String>, url: impl Into<String>) -> Self

Text that opens url when clicked.

pub fn bookmark(expression: impl Into<String>, level: u32) -> Self

An outline entry showing the value of expression, at level.

pub fn field(expression: impl Into<String>) -> Self

A label showing the value of expression.

pub fn check_box(expression: &str, text: &str) -> Self

A check box for a boolean expression.

pub fn line() -> Self

A horizontal line.

pub fn rect(radius: f32) -> Self

A rectangle.

pub fn table(table: Table) -> Self

A table.

pub fn at(self, x: f32, y: f32, width: f32, height: f32) -> Self

Positions and sizes the control.

pub fn format(self, format: &str) -> Self

Sets the value format (C2, {0:dd/MM/yyyy}…).

pub fn style_name(self, name: &str) -> Self

Uses a named style.

pub fn style(self, style: Style) -> Self

Sets style settings on the control.

pub fn visible(self, expression: &str) -> Self

Prints the control only when expression is true.

pub fn rule(self, condition: &str, style: Style) -> Self

Adds conditional formatting.

pub fn named(self, name: &str) -> Self

Names the control.

Trait Implementations

impl Clone for Control

fn clone(&self) -> Control

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Control

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

Formats the value using the given formatter.

impl Default for Control

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Control

where Control: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Control

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Control

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Control