WP Get style sheet

WP Get style sheet ( wpDoc : Object ; styleSheetName : Text {; listLevelIndex : Integer } ) : Object

引数	型		説明
wpDoc	Object	→	4D Write Pro ドキュメント
styleSheetName	Text	→	スタイルシート名
listLevelIndex	Integer	→	階層内でのスタイルシートのレベル
戻り値	Object	←	スタイルシートオブジェクト

履歴

リリース	内容
4D 18	Created
4D 21 R3	listLevelIndex 引数追加

説明

WP Get style sheet コマンドは、styleSheetName 引数で指定したスタイルシート、または階層リストスタイルシート の場合にはスタイルシート名とlistLevelIndex 引数のインデックスで指定したスタイルシートのスタイルシートオブジェクトを返します。

wpDoc 引数には、スタイルシートを持った4D Write Pro ドキュメントを渡します。

styleSheetName 引数を使用すると、返すスタイルシートの名前を指定することができます。 wpDoc 引数のドキュメント内のそのスタイルシート名が存在しない場合、null オブジェクトが返されます。

指定したスタイルシートが改装リストスタイルシートの一部である場合、オプションの listLevelIndex 引数で階層レベルを指定することで階層内の特定のレベルを取得することができます。

• listLevelIndex 引数は階層内のスタイルシートのレベルを表します(1 = ルートレベル、2 = 第一サブレベル、など)。
• スタイルシートが階層で、この 引数が省略された場合には、ルートレベルのスタイルシートが返されます。
• リクエストされたレベルが存在しない場合、null オブジェクトが返されます。
• スタイルシートが改装リストスタイルシートではない場合に、listLevelIndex が1 より大きかった場合、null オブジェクトが返されます。

例題 1

"Main title" スタイルシートを取得したい場合を考えます:

 var $styleSheet : Object
 
 $styleSheet:=WP Get style sheet(wpArea;"Main title")
 If($styleSheet=Null) // スタイルシートが存在するか チェックし、なければ作成する
    $styleSheet:=WP New style sheet(wpArea;wk type paragraph;"Main title")
 End if

例題 2

階層リストスタイルシートの特定のレベルを取得したい場合:

var $rootStyle : Object
var $subLevelStyle : Object

// ルートレベルのスタイルシートを取得
$rootStyle:=WP Get style sheet(wpArea;"MainList")

// 第2レベルを取得(最初のサブレベル)
$subLevelStyle:=WP Get style sheet(wpArea;"MainList";2)

If($subLevelStyle=Null)
    ALERT("Requested level does not exist.")
End if

参照

スタイルシート
WP DELETE STYLE SHEET
WP Get style sheets WP IMPORT STYLE SHEETS
WP New style sheet