Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter Eleven — SGML Functions (continued)

11.3.9 CSS Functions

CSS properties can be accessed directly from an SGML Object as parameters or they can be accessed from mid-level routines that can process and manage CSS data. The CSS functions treat the data within an element as a CSS declaration or an array of CSS property-value pairs.

An important consideration for CSS processing is the use of shorthand notation. The SGML Object always prefers to write in CSS shorthand while properties are always stored in their most basic form. For example:

font: bold 9pt Courier New, Courier, Monospace

will be store as:

font-weight: bold

font-size: 9pt

font-family: Courier New, Courier, Monospace

When writing, the shorthand version will be rendered.

With this group of functions, there are two methods of accessing and changing CSS: via a declaration string or using property arrays. A an example of a declaration string:

margin: 0; font: bold 9pt Courier New, Courier, Monospace; border: Red 1pt solid

As array entries (assume ‘a’ is a single-dimension string array):

a["margin-top"] = "0";

a["margin-right"] = "0";

a["margin-bottom"] = "0";

a["margin-left"] = "0";

a["font-wieght"] = "bold";

a["font-size"] = "9pt";

a["font-family"] = "Courier New, Courier, Monospace";

a["border-top-color"] = "Red";

a["border-top-width"] = "1pt";

a["border-top-style"] = "solid";

a["border-right-color"] = "Red";

a["border-right-width"] = "1pt";

a["border-right-style"] = "solid";

a["border-bottom-color"] = "Red";

a["border-bottom-width"] = "1pt";

a["border-bottom-style"] = "solid";

a["border-left-color"] = "Red";

a["border-left-width"] = "1pt";

a["border-left-style"] = "solid";

The ordering of the array can be arbitrary. Property/key name case is always lower. Values are always represented in string form. Use the SGMLStringToValue, SGMLValueToString and related functions to convert to and from PVALUE form.

Unlike low-level SGML functions, mid level CSS functions are sensitive to data errors and will remove erroneous or unsupported data.

Mid Level Functions:

CSSClearProperties — Clears all CSS properties from the specified SGML Object’s element.

CSSGetDeclaration — Returns all the CSS properties in the form of a CSS declaration string.

CSSGetProperties — Returns all the CSS properties in the form of a string list.

CSSLayerDeclaration — Layers a declaration string on to an SGML Object’s element.

CSSLayerProperties — Layers an array of CSS properties string on to an SGML Object’s element.

CSSSetDeclaration — Sets a declaration string into an SGML Object’s element.

CSSSetProperties — Sets an array of CSS properties string into an SGML Object’s element.

Related Low-Level CSS Functions (covered in other sections):

SGMLDeleteParameter — Deletes a specified parameter.

SGMLGetParameter — Gets a specified parameter (attribute/CSS) as a string.

SGMLGetParameters — Returns all the parameters in the form of a string list.

SGMLPutParameter — Either puts a parameter value into the SGML Element Class, deletes the parameter if empty, or ignores the parameter if the value is mixed.

SGMLSetParameter — Sets a parameter into the SGML Element Class. If the parameter already exists, it is overwritten.

 

GoFiler Legato Script Reference — Generated on 12/16/2024

© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.