mlreportgen.dom.CharEntity Class

Namespace: mlreportgen.dom
Superclasses: mlreportgen.dom.Text

Create character entity reference

Description

Create a reference to a character entity reference.

The mlreportgen.dom.CharEntity class is a handle class.

Creation

Description

charEntityObj = CharEntity creates a reference to a non-breaking space ( ) entity. Appending this reference to a document inserts a non-breaking space.

charEntityObj = CharEntity(name) creates a reference to the character entity specified by name.

charEntityObj = CharEntity(name,n) creates n references to the character entity specified by name, that is, a character vector of n special characters.

Input Arguments

name — Character entity name

character vector

Entity name must be listed at https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references.

n — Number of character entities to use

integer

Number of character entities to use, specified as an integer.

Data Types: uint16

Properties

Name — Name of character entity

character vector

The name is a character entity listed in https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references.

Attributes:

NonCopyable

true

Data Types: char

Content — Text contained by this document element

'' (default) | character vector | string scalar

Text contained by this document element, specified as a character vector or string scalar.

Attributes:

NonCopyable

true

Data Types: char | string

BackgroundColor — Background color

[] (default) | character vector | string scalar

Background color that consists of a CSS color name or a hexadecimal RGB value, specified as a character vector or string scalar.

• For a list of CSS color names, see https://www.w3.org/wiki/CSS/Properties/color/keywords.

• To specify a hexadecimal RGB format, use # as the first character and two-digit hexadecimal numbers for the red, green, and blue values. For example, "#0000ff" specifies blue.

Note

Setting the BackgroundColor property adds a mlreportgen.dom.BackgroundColor format object to the Style property. Setting the BackgroundColor property to an empty value removes the object.

Example: "blue"

Example: "#0000ff"

Attributes:

NonCopyable

true

Data Types: char | string

Bold — Option to use bold for document element

[] (default) | true or 1 | false or 0

Option to use bold for this document element, specified as a numeric or logical 1 (true) or 0 (false). To make document element bold, set Bold to true or 1.

Note

Setting the Bold property adds a corresponding mlreportgen.dom.Bold format object to the Style property. Setting the Bold property to an empty value removes the object.

Attributes:

NonCopyable

true

Data Types: logical

Color — Document element object color

[] (default) | character vector | string scalar

Document element object color that consists of a CSS color name (see https://www.w3.org/wiki/CSS/Properties/color/keywords) or a hexadecimal RGB (truecolor) value in the form #RRGGBB, specified as a character vector or string scalar.

Note

Setting the Color property adds a corresponding mlreportgen.dom.Color format object to the Style property. Setting the Color property to an empty value removes the object.

Example: "blue"

Example: "#0000ff"

Attributes:

NonCopyable

true

Data Types: char | string

Italic — Option to use italic for document element

[] (default) | true or 1 | false or 0

Option to use italic for document element, specified as a numeric or logical 1 (true) or 0 (false). To make document element italic, set Italic to true or 1.

Note

Setting the Italic property adds a corresponding mlreportgen.dom.Italic format object to the Style property. Setting the Italic property to an empty value removes the object.

Attributes:

NonCopyable

true

Data Types: logical

Strike — Text strikethrough

[] (default) | "none" | "single" | "double"

Text strikethrough, specified as one of these values:

• "none" — No strikethrough

• "single" — Single line

• "double" — Double line (for Word reports only)

Note

Setting the Strike property adds a corresponding mlreportgen.dom.Strike format object to the Style property for this document element. Setting the Strike property to an empty value removes the object.

Attributes:

NonCopyable

true

Data Types: char | string

Underline — Type of underline

[] (default) | "single" | "none" | ...

Type of underline, specified as one of the values in this table.

Underline value	Description	Supported Output Types
"single"	Single line	All
"words"	Underline all characters except spaces	Word
"double"	Double line	Word
"thick"	Thick line	Word
"dotted"	Dotted line	Word
"dottedHeavy"	Thick dotted line	Word
"dash"	Dashed line	Word
"dashedHeavy"	Line with heavy dashes	Word
"dashLong"	Line with long dashes	Word
"dashLongHeavy"	Line with heavy long dashes	Word
"dotDash"	Dot-dash line	Word
"dashDotHeavy"	Heavy dash-dot line	Word
"dotDotDash"	Dot-dot-dash line	Word
"dashDotDotHeavy"	Line with heavy dashes and two dots between the dashes	Word
"wave"	Wavy line	Word
"wavyHeavy"	Heavy wavy	Word
"wavyDouble"	Double wavy line	Word
"none"	No underline	All

To specify both the color and the type of the underline, do not set the Underline property. Instead, set the Style property to include an mlreportgen.dom.Underline format object that specifies the underline type and color.

Note

Setting the Underline property adds a corresponding mlreportgen.dom.Underline format object to the Style property. Setting the Underline property to an empty value removes the object.

Attributes:

NonCopyable

true

Data Types: char | string

FontFamilyName — Name of font family for text

[] | character vector | string scalar

Name of a font family to use for text, specified as a character vector or string scalar. To specify substitutions for the font, do not specify the font family by setting this property. Instead, create and add an mlreportgen.dom.FontFamily object to the Style property.

Note

Setting the FontFamilyName property adds a corresponding mlreportgen.dom.FontFamily format object to the Style property. Setting the FontFamilyName property is the same as setting the FontName property of an mlreportgen.dom.FontFamily object. Setting the FontFamilyName property to an empty value removes the object.

Example: "Courier New"

Attributes:

NonCopyable

true

Data Types: char | string

FontSize — Font size

character vector

If you need to specify substitutions for this font, do not set this property. Instead create and add an mlreportgen.dom.FontFamily object to the Style property of this document element.

Setting the FontSize property adds a corresponding mlreportGen.dom.FontSize format object to the Style property for this document element. Removing the FontSize property setting removes the object.

Font size, specified as a character vector or string scalar in the form valueUnits. Units is an abbreviation for the units. Use one of these abbreviations for the units for the font size.

• "px" — pixels

• "cm" — centimeters

• "in" — inches

• "mm" — millimeters

• "pc" — picas

• "pt" — points

Repeat — Number of times to repeat character entity

numeric value

Number of times to repeat character entity, specified as a numeric value.

Data Types: double

WhiteSpace — How to treat white space in text

[] (default) | "normal" | "nowrap" | ...

How to treat white space and line breaks in text, specified as one of the values in this table.

Value	Description	Supported Output Types
"normal"	For HTML and PDF, this value removes spaces at the beginning and the end of text. Multiple spaces in the text collapse to a single space. For Microsoft® Word, this value removes spaces at the beginning and end of text.	All
"nowrap"	Sequences of white space collapse into a single white space. Text never wraps to the next line.	HTML
"pre"	Preserves white space. Text wraps only on line breaks. Acts like the <pre> tag in HTML.	HTML and PDF
"preserve"	Same as "pre".	All
"pre-line"	Sequences of white space collapse into a single white space. Text wraps when necessary and on line breaks.	HTML and PDF
"pre-wrap"	Preserves white space. Text wraps when necessary and on line breaks.	HTML and PDF

Note

Setting the WhiteSpace property adds a corresponding mlreportgen.dom.WhiteSpace format object to the Style property. Setting the WhiteSpace property to an empty value removes the object.

Data Types: char | string

StyleName — Name of stylesheet-defined style

[] (default) | character vector | string scalar

Style name, specified as a character vector or string scalar. The style name is the name of a style specified in the style sheet of the document or document part to which this element is appended. The specified style defines the appearance of this element in the output document unless overridden by the formats specified by the Style property of this element. To learn more about using style sheets, see Use Style Sheet Styles.

Note

Microsoft Word output ignores the style name.

Attributes:

NonCopyable

true

Data Types: char | string

Style — Format specification

{} (default) | array of DOM format objects

Format specification for this document element object, specified as an array of DOM format objects. The formats specified by this property override corresponding formats specified by the StyleName property of this element. Formats that do not apply to this document element object are ignored.

Attributes:

NonCopyable

true

CustomAttributes — Custom attributes of document element

[] (default) | array of mlreportgen.dom.CustomAttribute objects

Custom attributes of this document element, specified as an array of mlreportgen.dom.CustomAttribute objects. The custom attributes must be supported by the output format of the document element to which this object is appended.

Attributes:

NonCopyable

true

Tag — Tag for mlreportgen.dom.CharEntity object

character vector | string scalar

Tag for the mlreportgen.dom.CharEntity object, specified as a character vector or string scalar. The DOM API generates a session-unique tag as part of the creation of this object. The generated tag has the form CLASS:ID, where CLASS is the object class and ID is the value of the Id property of the object. Specify your own tag value to help you identify where to look when an issue occurs during document generation.

Attributes:

NonCopyable

true

Data Types: char | string

Id — Object identifier for mlreportgen.dom.CharEntity object

character vector | string scalar

Object identifier for the mlreportgen.dom.CharEntity object, specified as a character vector or string scalar. The DOM API generates a session-unique identifier when it creates the document element object. You can specify your own value for Id.

Attributes:

NonCopyable

true

Data Types: char | string

Methods

Public Methods

Method	Purpose
append Use CharEntity.append in a similar way to how you use ExternalLink.append.	Append a custom element to this character entity.
clone Use CharEntity.clone in a similar way to how you use Paragraph.clone.	Clone this character entity.

Examples

Append a British Pound Sign

import mlreportgen.dom.*;
doctype = 'html';
d = Document('test',doctype);

p = Paragraph(CharEntity('pound'));
append(d,p);
append(p,'3');

close(d);
rptview('test',doctype);

Append Two Nonbreaking Spaces

import mlreportgen.dom.*;
doctype = 'html';
d = Document('test',doctype);

p = Paragraph('Some text');
append(d,p);
ce = CharEntity('nbsp',5);
append(p,ce);
append(p,'more text after five blank spaces');

close(d);
rptview('test',doctype);

Version History

Introduced in R2014b