Struct ArrayDimensions 

pub struct ArrayDimensions { /* private fields */ }

The dimensions of an array PropertyObject (ArrayDimensions).

A non-array property reports zero dimensions, so this is safe to ask for on anything.

Bounds are read and written as strings such as [0,0] and [2,4]. The engine also exposes them as SAFEARRAYs, but the string form carries the same information through the ordinary dispatch path.

Implementations

impl ArrayDimensions

pub fn num_dimensions(&self) -> Result<i32, Error>

How many dimensions the array has; 0 when it is not an array (NumDimensions).

Errors

Error if the COM call fails or returns an unexpected type.

pub fn lower_bounds_string(&self) -> Result<String, Error>

The lower bound of each dimension, e.g. [0,0] (LowerBoundsString).

Errors

Error if the COM call fails or returns an unexpected type.

pub fn upper_bounds_string(&self) -> Result<String, Error>

The upper bound of each dimension, e.g. [2,4] (UpperBoundsString).

Errors

Error if the COM call fails or returns an unexpected type.

pub fn set_bounds_by_strings( &self, lower: &str, upper: &str, ) -> Result<(), Error>

Sets both bounds from their string forms (SetBoundsByStrings).

Resizing does not move existing elements to keep their indices, so an element’s position can change; rebuild the contents afterwards rather than assuming they survived.

Errors

Error if the COM call fails.

pub fn lengths(&self) -> Result<Vec<i32>, Error>

The per-dimension lengths, derived from the bounds.

[0,0]..[2,4] yields [3, 5].

Errors

Error if the COM call fails or a bound cannot be parsed.

Trait Implementations

impl Debug for ArrayDimensions

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

Formats the value using the given formatter.