WP New style sheet

Home

4D v20

WP New style sheet


WP New style sheet ( wpDoc ; styleSheetType ; styleSheetName ) -> Function result

Parameter	Type	Description
wpDoc	Object	4D Write Pro document
styleSheetType	String	Type of style sheet
styleSheetName	String	Name of style sheet
Function result	Object	Style sheet object

Description

The WP New style sheet command creates a new (empty) style sheet object for the designated wpDoc.

In the wpDoc parameter, pass a 4D Write Pro document.

The styleSheetType parameter lets you designate the type of the style sheet, i.e. the part of the wpDoc that will be affected by the style sheet. Two types are available:

wk type character: Applies style attributes to characters.
wk type paragraph: Applies style attributes to paragraphs.

Pass a name for the style sheet in the styleSheetName parameter. The style sheet's name is stored with the document and facilitates reusing or modifying the style. It can also be used with the WP Get style sheet and WP DELETE STYLE SHEET commands. The style sheet name must comply with the following rules:

it must start with a letter
it can then contain alphanumeric characters, space characters, "-" characters or unicode characters >= 128
it must be unique in the document regardless of the type
it must not start with "section", which is reserved
the "_" is replaced by a space and trailing spaces are removed.

You can specify the attributes of the style sheet using the WP SET ATTRIBUTES command or the object notation (see 4D Write Pro Attributes). For the list of available attributes, see the Style sheet attributes section.

Notes:

A style sheet only modifies the display of a character or paragraph, not how it is stored in the document. If a style sheet is removed, the text will revert to the default style.
Any style attributes not defined in the new style sheet will automatically use the Normal style. For more information, see Style sheet commands.

Example

The following code creates and defines a paragraph style sheet:

 C_OBJECT($styleSheet)

 $styleSheet:=WP New style sheet(wpArea;wk type paragraph;"Main title")

 

  //define style sheet settings

 WP SET ATTRIBUTES($styleSheet;wk font family;"Papyrus")

 WP SET ATTRIBUTES($styleSheet;wk font size;"48pt")

 WP SET ATTRIBUTES($styleSheet;wk text color;"red")

 WP SET ATTRIBUTES($styleSheet;wk text align;wk left)

 

  //Apply the style sheet to the first paragraph

 C_COLLECTION($Paragraphs)

 $Paragraphs:=WP Get elements(wpArea;wk type paragraph)

 If($Paragraphs.length>0)

    WP SET ATTRIBUTES($Paragraphs[0];wk style sheet;$styleSheet)

 End if