libxlsxwriter
Loading...
Searching...
No Matches
Data Fields
lxw_image_options Struct Reference

Options for inserted images. More...

Detailed Description

Options for modifying images inserted via worksheet_insert_image_opt() and worksheet_embed_image_opt().

Examples
image_buffer.c, and images.c.

Data Fields

int32_t x_offset
 
int32_t y_offset
 
double x_scale
 
double y_scale
 
uint8_t object_position
 
const char * description
 
uint8_t decorative
 
const char * url
 
const char * tip
 
lxw_formatcell_format
 

Field Documentation

◆ x_offset

int32_t lxw_image_options::x_offset

Offset from the left of the cell in pixels.

Examples
image_buffer.c, and images.c.

◆ y_offset

int32_t lxw_image_options::y_offset

Offset from the top of the cell in pixels.

◆ x_scale

double lxw_image_options::x_scale

X scale of the image as a decimal.

Examples
images.c.

◆ y_scale

double lxw_image_options::y_scale

Y scale of the image as a decimal.

◆ object_position

uint8_t lxw_image_options::object_position

Object position - use one of the values of lxw_object_position. See Working with Object Positioning.

◆ description

const char* lxw_image_options::description

Optional description or "Alt text" for the image. This field can be used to provide a text description of the image to help accessibility. Defaults to the image filename as in Excel. Set to "" to ignore the description field.

◆ decorative

uint8_t lxw_image_options::decorative

Optional parameter to help accessibility. It is used to mark the image as decorative, and thus uninformative, for automated screen readers. As in Excel, if this parameter is in use the description field isn't written.

◆ url

const char* lxw_image_options::url

Add an optional hyperlink to the image. Follows the same URL rules and types as worksheet_write_url().

Examples
images.c.

◆ tip

const char* lxw_image_options::tip

Add an optional mouseover tip for a hyperlink to the image.

◆ cell_format

lxw_format* lxw_image_options::cell_format

Add an optional format to the cell. Only used with worksheet_embed_image_opt()