textbox

A textbox is a type of shape which is used to display text.

ParameterTypeInputDescription

name

String

[required] Name of shape to update/manipulate. Find shape names here.

content

String

[optional] Shorthand way to displaying text in a textbox or a cell of a table shape.

text_content

Object

[optional] Extended way of displaying text in chunks using the text_content object

settings

Object

[optional] An array of settings object

is_hidden

Boolean

true, false

[optional] Hide shape

remove

Boolean

true, false

[optional] Delete shape

JSON payload

"shapes": [
  {
    "name": "string",
    "content": "string",
    "text_content": [],
    "settings": [],
    "is_hidden": boolean,
    "remove": boolean
   },
  {
    "name": "string",
    "content": "string",
    "text_content": [],
    "settings": [],
    "is_hidden": boolean,
    "remove": boolean
   } 
]

_______________________________________________________________________________________________________

Text_content Object

An array of text objects, where each object represents a part of the text with its own text content and optional properties.

ParameterTypeInputDescription

text_run

String

[required] Text chunk

text_properties

Object

[optional] A text styling object. List of font styling parameters to override existing styles for the given chunk of text.

JSON Payload

"text_content": [
  {
    "text_run": "This is part 1 of my sentence.",
    "text_properties": {},
  {
    "text_run": "This is part 2 of my sentence.",
    "text_properties": {}
  }
]

_______________________________________________________________________________________________________

Text_properties Object

Text format properties.

ParameterTypeInputDescription

font_type

String

MS supported font names

[optional] Font name

font_size

Integer

1 to 4000

[optional] Font size

font_bold

Boolean

true, false

[optional] Bold

font_italic

Boolean

true, false

[optional] Italic

font_color

String

Color name,

RGB(0,0,0),

Hex

[optional] Set text color

font_bg_color

String

Color name,

RGB(0,0,0),

Hex

[optional] Set text background color

text_indent

Integer

0 to 142.24

[optional] Set text indent

text_align

String

left,

center,

right,

justified,

dist

[optional] Set text alignment

font_underline

String

single,

double,

heavy,

dotted,

heavydotted,

dashed,

heavydashed,

heavylongdashed,

dotdash,

heavydotdash,

heavydotdotdash,

wavy,

heavywavy,

doublewavy

[optional] Various text underline

text_line_spacing

Integer

1 to 1584

[optional] Spacing between text lines

new_line

Boolean

true; false

[optional] Create new line within text box

"text_properties": {
    "font_type": "string",
    "font_size": numeric,
    "font_bold": boolean,
    "font_italic": boolean,
    "font_color": "string",
    "font_bg_color": "string",
    "text_align": "string",
    "text_indent": numeric,
    "text_line_spacing": numeric,
    "font_underline": "string",	
    "new_line": boolean
  }

_______________________________________________________________________________________________________

Settings Object

These settings are applied at shape level.

ParameterTypeInputDescription

height

Integer,

Float

0 to 5963.92

[optional] Set shape height

width

Integer,

Float

0 to 5963.92

optional] Set shape width

left

Integer,

Float

-5963.92 to 5963.92

[optional] Set left position

top

Integer,

Float

-5963.92 to 5963.92

[optional] Set top position

unit

String

cm,

pt,

points

[optional] Set unit of measurement for shape width, height, left, top.(default value if ‘unit’ field is not specified)

fill_color

String

Color name,

RGB(0,0,0),

Hex

[optional] Set shape background color

font_type

String

MS supported font names

[optional] Font type

font_size

Integer

1 to 4000

[optional] Font size

font_bold

Boolean

true; false

[optional] Bold

font_italic

Boolean

true; false

[optional] Italic

font_color

String

Color name,

RGB(0,0,0),

Hex

[optional] Set text color

font_bg_color

String

Color name,

RGB(0,0,0),

Hex

[optional] Set text background color

text_indent

Integer

0 to 142.24

[optional] Set text indent

text_align

String

left,

center,

right,

justified,

dist

[optional] Set text alignment

font_underline

String

single;

double;

heavy;

dotted

heavydotted;

dashed;

heavydashed;

heavylongdashed;

dotdash;

heavydotdash;

heavydotdotdash;

wavy;

heavywavy;

doublewavy;

[optional] Various text underline

text_line_spacing

Integer

1 to 1584

[optional] Spacing between text lines

new_line

Boolean

true; false

[optional] Create new line within text box

JSON payload

"settings": {
  "height": numeric,
  "width": numeric,
  "top": numeric,
  "left": numeric,
  "unit": "string"
  "fill_color": "0,0,0"
  "font_type": "string",
  "font_size": numeric,
  "font_bold": boolean,
  "font_italic": boolean,
  "font_color": "string",
  "font_bg_color": "string",
  "text_align": "string",
  "text_indent": numeric,
  "text_line_spacing": numeric,
  "font_underline": "string",	
  "new_line": boolean
}	   

Last updated