4D View Pro スタイルオブジェクトとスタイルシート

4D v19

概要

4D View Pro スタイルオブジェクトとスタイルシートを使用すると、4D View Pro ドキュメントのグラフィカルな側面と見た目を管理することができるようになります。

スタイルオブジェクト

スタイルオブジェクトには、スタイルプロパティ設定が格納されます。これらはスタイルシートで使用するか、あるいはそのまま使用することができます。スタイルオブジェクトはスタイルシートと組み合わせて使用することもでき、ドキュメントの他の部分に影響を及ぼすことなく個別のセルレンジ特有の異なる設定を指定することもできます。

VP SET CELL STYLE および VP SET DEFAULT STYLE コマンドではスタイルオブジェクトを直接使用することもできます。

スタイルシート

スタイルシートは、スタイルオブジェクト(後述参照)のプロパティの組み合わせをまとめたもので、それによって4D View Pro ドキュメントのすべてのセルの見た目を指定することができます。ドキュメントと保存されたスタイルシートを使用すれば、単一のシート、複数のシート、あるいはワークブック全体に対してでもプロパティを設定することができます。

作成時に4D View Pro スタイルシートは名前が与えられ、この名前はスタイルシート内の"name" プロパティに保存されます。これを使用することでスタイルシートの使用が容易になり、また注意深く命名することでその定義と目的を分かりやすくすることもできます(例: Letterhead_internal、Letterhead_external、など)。

スタイルシートはVP ADD STYLESHEET コマンドで作成され、VP SET DEFAULT STYLE あるいは VP SET CELL STYLE コマンドで適用することができます。またスタイルシートはVP REMOVE STYLESHEET コマンドで削除することもできます。

VP Get stylesheet コマンドを使用することでスタイルシートのスタイルオブジェクトを返すこともできます。またVP Get stylesheets コマンドを使用して複数のスタイルシートのスタイルオブジェクトのコレクションを取得することもできます。

スタイルプロパティ

以下の取りうる値の詳細については、4D View Pro Constants のページを参照してください。

背景色&文字色

プロパティ	型	詳細	取りうる値
backColor	テキスト	背景のカラーを定義します。	CSS カラー"#rrggbb" シンタックス(推奨されるシンタックス)、CSS カラー "rgb(r,g,b)" シンタックス(別シンタックス)、CSS カラー名(別シンタックス)
backgroundImage	ピクチャー、テキスト	背景画像を指定します。	直接指定するか、または画像パス(フルパス、またはファイル名のみ)で指定することができます。ファイル名のみを使用する場合、ファイルはデータベースのストラクチャーファイルのすぐ横に置かれている必要があります。指定の方法(ピクチャーまたはテキスト)に関わらず、ピクチャーはドキュメントとともに保存されます。画像のサイズが大きい場合、ドキュメントのサイズに影響する場合があります。Windows での注意: ファイル拡張子も含める必要があります。
backgroundImageLayout	倍長整数	背景画像のレイアウトを定義します。	vk image layout center, vk image layout none, vk image layout stretch, vk image layout zoom
foreColor	テキスト	文字のカラーを定義します。	CSS カラー"#rrggbb" シンタックス(推奨されるシンタックス)、CSSカラー"rgb(r,g,b)" シンタックス(別シンタックス)、CSSカラー名(別シンタックス)

境界線

プロパティ	サブプロパティ	型	詳細	取りうる値
borderBottom, borderLeft, borderRight, borderTop, diagonalDown,diagonalUp		オブジェクト	それぞれに対応する境界線を定義します
	color	テキスト	境界線のカラーを定義します。デフォルト = black	CSSカラー"#rrggbb"シンタックス(推奨されるシンタックス)、CSSカラー"rgb(r,g,b)"シンタックス(別シンタックス)、CSSカラー名(別シンタックス)
	style	倍長整数	境界線のスタイルを定義します。デフォルト = empty。null または未定義をとることはできません。	vk line style dash dot, vk line style dash dot dot, vk line style dashed, vk line style dotted, vk line style double, vk line style empty, vk line style hair, vk line style medium, vk line style medium dash dot, vk line style medium dash dot dot, vk line style medium dashed, vk line style slanted dash dot, vk line style thick, vk line style thick

フォントとテキスト

プロパティ	サブプロパティ	型	詳細	取りうる値
font		テキスト	フォントの特徴をCSS font shorthand で指定します("font-style font-variant font-weight font-size/line-height font-family")。例: "14pt Century Gothic"など。フォントサイズ(font-size)とフォントファミリー(font-family)の値は必須です。その他の値のいづれかがなかった場合には、そのデフォルト値が使用されます。注: フォント名にスペースが含まれる場合、その名前は引用符("")で括られる必要があります。	CSS font shorthand 4D ではフォントの特徴をオブジェクトとして管理するためのユーティリティコマンドを提供しています: VP Font to object および VP Object to font
formatter		テキスト	値/時間プロパティに対するパターン	数値/テキスト/日付/時間フォーマット、特殊文字など。詳細は4D View Pro セルフォーマットの章を参照してください。
isVerticalText		ブール	テキストの向きをしてします。	True = 垂直のテキスト、False = 水平なテキスト
labelOptions		オブジェクト	セルラベルのオプションを定義します(ウォーターマークオプション)
	alignment	倍長整数	セルラベルの位置を指定します。任意のプロパティです。	vk label alignment top left, vk label alignment bottom left, vk label alignment top center, vk label alignment bottom center, vk label alignment top right, vk label alignment bottom right
	visibility	倍長整数	セルラベルの表示状態を指定します。任意のプロパティです。	vk label visibility auto, vk label visibility hidden, vk label visibility visible
	foreColor	テキスト	文字のカラーを定義します。任意のプロパティです。	CSSカラー"#rrggbb"シンタックス(推奨されるシンタックス)、CSSカラー"rgb(r,g,b)"シンタックス(別シンタックス)、CSSカラー名(別シンタックス)
	font	テキスト	フォント特性をCSS font shorthand で指定します("font-style font-variant font-weight font-size/line-height font-family")。フォントサイズ(font-size)およびフォントファミリー(font-family)の値は必須となっています。
textDecoration		倍長整数	テキストに追加する装飾を指定します。	vk text decoration double underline, vk text decoration line through, vk text decoration none, vk text decoration overline, vk text decoration underline
textIndent		倍長整数	テキストのインデントを定義します。1 = 8 pixels
textOrientation		倍長整数	セル内のテキストの回転角度を定義します。	-90 から90 の間の数値
watermark		テキスト	ウォーターマーク(セルラベル)のコンテンツを定義します。
wordWrap		ブール	テキストを折り返すかどうかを指定します。	True = テキストを折り返す、False = テキストを折り返さない

レイアウト

プロパティ	型	詳細	取りうる値
cellPadding	テキスト	セルのパッディングを定義します
hAlign	倍長整数	セルのコンテンツの水平方向並びを定義します	vk horizontal align center, vk horizontal align general, vk horizontal align left, vk horizontal align right
locked	ブール	セルの保護状態を指定します。ただし、シート保護が有効化されている場合にのみ利用可能である点に注意してください。(シートの保護の章を参照してください)。	True = ロックされている、False = ロック解除
shrinkToFit	ブール	セルのコンテンツが縮小されるかどうかを指定します。	True = コンテンツ縮小、False = 縮小なし
tabStop	ブール	Tab キーを使用してセルにフォーカスを入れることができるかどうかを指定します。	True = Tab キーでフォーカスをセットする、False = Tab キーではフォーカスをセットしない
vAlign	倍長整数	セルのコンテンツの垂直方向並びを指定します	vk vertical align bottom, vk vertical align center, vk vertical align top

スタイル情報

プロパティ	型	詳細
name	テキスト	スタイルの名前を定義します。
parentName	テキスト	カレントスタイルの元となっているスタイルを指定します。まず親スタイルの値が適用され、次にカレントスタイルの値が適用されます。カレントスタイルにおいて行われた変更は親スタイルには反映されません。これはスタイルシートを使用している時のみ利用可能です。

参照

VP ADD STYLESHEET
VP Font to object
VP Get stylesheet
VP Object to font