4D View Pro エリアの設定
4D View Pro エリアのプロパティは、プロパティリストを利用して設定することが可能です。 スプレッドシートプロパティはランゲージにより設定します。
フォームエリアプロパティ
Using the area's property list, you can set 4D View Pro object properties such as Object Name, Variable or Expression, Appearance, Action, and Events.
ユーザーインターフェースの選択
You can select the interface to use with your 4D View Pro form areas in the Property List, under Appearance:
You can also use the
userInterface
andwithFormulaBar
(only with the "toolbar" interface) JSON properties.
インターフェースにより、基本的な編集とデータ操作がおこなえます。 ユーザーによる編集は、ユーザーによってドキュメントが保存されたときに 4D View Pro オブジェクトに保存されます。
リボン
ツールバー
Enabling the Toolbar interface displays the Show Formula Bar option. これを選択すると、ツールバーのすぐ下にフォーミュラバーが表示されます。
フォーミュラバーが表示された状態:
機能
リボン型、ツールバー型のいずれのインターフェースでも、関連機能はタブにグループ分けされます:
タブ | アクション | リボン型インターフェース | ツールバー型インターフェース |
---|---|---|---|
File | ファイル操作 | X | |
ホーム | テキストの書式など | X | X |
挿入 | アイテムの追加 | X | X |
フォーミュラ | フォーミュラの計算とライブラリ | X | X |
データ | データ操作 | X | X |
表示 | 表示の設定 | X | X |
設定 | スプレッドシートの設定 | X |
フォームイベント
4D View Pro エリアのプロパティリスト内では、以下のフォームイベントが利用可能です。
一部のイベントは (すべてのアクティブオブジェクトで利用可能な) 標準のフォームイベントであり、一部は 4D View Pro 専用のフォームイベントです。 Some standard form events provide extended information in the object returned by the FORM Event
command when they are generated for 4D View Pro areas. 以下の表は標準イベントと、4D View Pro 専用または追加情報を提供するイベントの一覧です:
シートオプション
4D View Pro シートオプションオブジェクトを使って、4D View Pro エリアの様々なオプションをコントロールすることができます。 このオブジェクトは以下のコマンドで操作します:
シートのアピアランス
プロパティ | タイプ | 説明 | |
---|---|---|---|
allowCellOverflow | boolean | セルに収まらないデータを隣の空のセルにはみ出し表示するかどうかを指定します | |
sheetTabColor | string | シートタブの色を指定するカラー文字列 (例: "red"、"#FFFF00"、"rgb(255,0,0)"、"Accent 5") | |
frozenlineColor | string | 固定化された線の色を指定するカラー文字列 (例: "red"、"#FFFF00"、"rgb(255,0,0)"、"Accent 5") | |
clipBoardOptions | longint | クリップボードオプション。 Available values: vk clipboard paste options all , vk clipboard paste options formatting , vk clipboard paste options formulas , vk clipboard paste options formulas and formatting , vk clipboard paste options values , vk clipboard paste options values and formatting | |
gridline | object | 枠線のオプション | |
color | string | 枠線の色を表すカラー文字列 (例: "red"、"#FFFF00"、"rgb(255,0,0)"、"Accent 5") | |
showVerticalGridline | boolean | 垂直の枠線を表示するかどうかを指定します。 | |
showHorizontalGridline | boolean | 水平の枠線を表示するかどうかを指定します。 | |
rowHeaderVisible | boolean | 行ヘッダーを表示するかどうかを指定します。 | |
colHeaderVisible | boolean | 列ヘッダーを表示するかどうかを指定します。 | |
rowHeaderAutoText | longint | 行ヘッダーが文字を表示するか、数字を表示するか、あるいは空かを指定します。 Available values: vk header auto text blank , vk header auto text letters , vk header auto text numbers | |
colHeaderAutoText | longint | 列ヘッダーが文字を表示するか、数字を表示するか、あるいは空かを指定します。 Available values: vk header auto text blank , vk header auto text letters , vk header auto text numbers | |
selectionBackColor | string | シートにおける選択範囲の背景色。 (RGBAフォーマット推奨) | |
selectionBorderColor | string | シートにおける選択範囲の枠線の色。 | |
sheetAreaOffset | object | シートエリアのオフセットオプション | |
left | longint | シートの、ホストからの左オフセット | |
top | longint | シートの、ホストからの上オフセット |
いずれのプロパティも任意です。
シートの保護
To lock the whole sheet, you only need to set the isProtected property to true. You can then unlock cells individually by setting the locked cell style property.
プロパティ | タイプ | 説明 | |
---|---|---|---|
isProtected | boolean | シート上で保護状態とされているセルが編集可能かどうかを指定します。 | |
protectionOptions | object | ユーザーにより編集可能な要素を指定します。 null の場合、protectionOptions パラメーターはリセットされます。 | |
allowSelectLockedCells | boolean | ロックされたセルをユーザーが選択できるかどうかを指定します (任意)。 デフォルトは true。 | |
allowSelectUnlockedCells | boolean | ロック解除されたセルをユーザーが選択できるかどうかを指定します (任意)。 デフォルトは true。 | |
allowSort | boolean | ユーザーによるレンジの並べ替えが可能かどうかを指定します (任意)。 デフォルトは false。 | |
allowFilter | boolean | ユーザーによるレンジのフィルタリングが可能かどうかを指定します (任意)。 デフォルトは false。 | |
allowEditObjects | boolean | フローティングオブジェクトをユーザーが編集できるかどうかを指定します (任意)。 デフォルトは false。 | |
allowResizeRows | boolean | ユーザーが行をリサイズできるかどうかを指定します (任意)。 デフォルトは false。 | |
allowResizeColumns | boolean | ユーザーが列をリサイズできるかどうかを指定します (任意)。 デフォルトは false。 | |
allowDragInsertRows | boolean | ユーザーがドラッグ操作で行を挿入できるかどうかを指定します (任意)。 デフォルトは false。 | |
allowDragInsertColumns | boolean | ユーザーがドラッグ操作で列を挿入できるかどうかを指定します (任意)。 デフォルトは false。 | |
allowInsertRows | boolean | ユーザーが行を挿入できるかどうかを指定します (任意)。 デフォルトは false。 | |
allowInsertColumns | boolean | ユーザーが列を挿入できるかどうかを指定します (任意)。 デフォルトは false。 | |
allowDeleteRows | boolean | ユーザーが行を削除できるかどうかを指定します (任意)。 デフォルトは false。 | |
allowDeleteColumns | boolean | ユーザーが列を削除できるかどうかを指定します (任意)。 デフォルトは false。 |
いずれのプロパティも任意です。
セルフォーマット
フォーマットパターン (表示形式) を定義することで、4D View Pro ドキュメントのコンテンツを想定通りに表示することができます。 Formats can be set using the selected 4D View Pro interface, or using the VP SET VALUE or VP SET NUM VALUE commands.
4D View Pro には数値、日付、時間、そしてテキスト用のビルトインのフォーマットがありますが、カスタムパターンを作成することで、特殊文字やコードを使ったフォーマットでセルのコンテンツを表示することができます。
For example, when using the VP SET VALUE or VP SET NUM VALUE commands to enter amounts in an invoice, you may want the currency symbols ($, €, ¥, etc.) to be aligned regardless of the space required by the number (i.e., whether the amount is $5.00 or $5,000.00). You could use formatting characters and spectify the pattern ($* #,##0.00) which would display amounts as shown:
カスタムのフォーマットパターンを作成する場合、データの表示 のみが変更されるという点に注意してください。 データの値そのものは変わりません。
数値とテキストのフォーマット
数値フォーマットはすべての数値型 (例: 正の数、負の数、ゼロ) に対して適用されます。
文字 | 説明 | 例題 |
---|---|---|
0 | ゼロを表示する桁のプレースホルダー | #.00 は 1.1 を 1.10 と表示します。 |
。 | 小数点を表示します | 0.00 は 1999 を 1999.00 と表示します。 |
, | 数値内に千区切りのカンマを表示します。 数値記号 "#" あるいはゼロに挟まれたカンマがフォーマットに含まれる場合、3桁ごとにカンマで区切られます。 桁のプレースホルダーの後にくるカンマは、数値を 1000 で割ります。 | #,0 は 12200000 を 12,200,000 と表示します。 |
_ | アンダーバーに続く文字の幅をスキップします。 | _( のようにカッコなどと組み合わせることで、左や右にスペースを追加します。 |
@ | テキストのフォーマット文字。 セル内のすべてのテキストにフォーマットを適用します。 | "[Red]@" はテキスト値に対して赤のフォントカラーを適用します。 |
- | 列幅いっぱいまで、後に続く文字を繰り返します。 | 0*- は、数値の後にセルの幅いっぱいまでダッシュを繰り返します。対して、*0 をフォーマットの前につけると、先頭に 0 が複数表示されます。 |
" " | 引用符にはさまれたテキストを、解釈せずにそのまま表示します。 | "8%" は 8% と表示されます。 |
% | 数値を百分率で表示します。 | 8% は、.08 として表示されます。 |
# | 追加のゼロを表示しない、桁のプレースホルダー。 もしプレースホルダーの数以上に小数点以下の桁数があった場合、それらの数字は丸められます。 | #.# は 1.54 を 1.5 として表示します。 |
? | 追加のゼロの分のスペースを残すが、そのゼロは表示しない桁のプレースホルダー。 通常、数値を小数点の位置で揃えるために使用されます。 | $?? は最低 2桁のスペースを確保し、1桁の数値が混じっていても 2桁の場所に $記号が並ぶように指定します。 |
\ | 後に続く文字を表示します。 | #.00\? は 123 を 123.00? として表示します。 |
/ | 数値に対して使用した場合、分数として表記します。 テキスト、日付、時刻に対して使用した場合、それらをそのまま表示します。 | #/# は .75 を 3/4 として表示します。 |
[ ] | 条件つき書式を作成します。 | [>100][GREEN]#,##0;[<=-100 ][YELLOW]#,##0;[BLUE]#,##0 |
E | 指数表記のフォーマット。 | #E+# - は 1,500,500 を 2E+6 として表示します。 |
[color] | テキストまたは数値を指定カラーで表示します。 | [Green]###.##[Red]-###.### |
例題
// セルの値を $125,571.35 と表示する設定
VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_($* #,##0.00_)")
日付と時間のフォーマット
4D View Pro では IS0 8601 の日付と時間パターンを示す以下の定数を提供しています:
定数 | 値 | 説明 |
---|---|---|
vk pattern full date time | "fullDateTimePattern" | カレント言語設定における ISO 8601 フォーマットの完全な日付と時間。アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy HH:mm:ss" |
vk pattern long date | "longDatePattern" | カレント言語設定における ISO 8601 フォーマットの完全な日付。アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy" |
vk pattern long time | "longTimePattern" | カレント言語設定における ISO 8601 フォーマットの時間。アメリカ合衆国でのデフォルトパターン: "HH:mm:ss" |
vk pattern month day | "monthDayPattern" | カレント言語設定における ISO 8601 フォーマットの月日の日付。アメリカ合衆国でのデフォルトパターン: "MMMM dd" |
vk pattern short date | "shortDatePattern" | カレント言語設定における省略形の ISO 8601 フォーマットの日付。アメリカ合衆国でのデフォルトパターン: "MM/dd/yyyy" |
vk pattern short time | "shortTimePattern" | カレント言語設定における省略形の ISO 8601 フォーマットの時間。アメリカ合衆国でのデフォルトパターン: "HH:mm" |
vk pattern sortable date time | "sortableDateTimePattern" | カレント言語設定における、並べ替え可能な ISO 8601 フォーマットの日付と時間。アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss" |
vk pattern universal sortable date time | "universalSortableDateTimePattern" | カレント言語設定における、UTCを使用した並べ替え可能な ISO 8601 フォーマットの日付と時間。アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'" |
vk pattern year month | "yearMonthPattern" | カレント言語設定における ISO 8601 フォーマットの年月。アメリカ合衆国でのデフォルトパターン: "yyyy MMMM" |
例題
// セルの値を特定の日付と時間として表示する設定
VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time";?14:30:10?;"format";vk pattern full date time))
カスタムの日付と時間のフォーマット
カレント言語設定における日付と時間のカスタムパターンを作成したい場合、以下のコードを組み合わせて使用することができます:
コード (文字の大小の区別なし) | 説明 | 例題 | |
---|---|---|---|
日付 | (January 1, 2019) | ||
m | 先頭のゼロなしの月表示 | 1 | |
mm | 先頭のゼロありの月表示 | 01 | |
mmm | 短い月名 | Jan | |
mmmm | 長い月名 | January | |
d | 先頭のゼロなしの日付表示 | 1 | |
dd | 先頭のゼロありの日付表示 | 01 | |
ddd | 短い曜日名 | Tue | |
dddd | 長い曜日名 | Tuesday | |
yy | 短い年表示 | 19 | |
yyyy | 長い年表示 | 2019 | |
時間 | (2:03:05 PM) | ||
h | 先頭のゼロなしの時間。 0-23の値 | 2 | |
hh | 先頭のゼロありの時間。 00-23の値 | 02 | |
m | 先頭のゼロなしの分数。 0-59の値 | 3 | |
mm | 先頭のゼロありの分数。 00-59の値 | 03 | |
s | 先頭のゼロなしの秒数。 0-59の値 | 5 | |
ss | 先頭のゼロありの秒数。 00-59の値 | 05 | |
[h] | 経過時間の時間数 | 14 (24 を超える表示も可能) | |
[mm] | 経過時間の分数 | 843 | |
[ss] | 経過時間の秒数 | 50585 | |
AM/PM | 午前/午後。 省略された場合、24時間表記が適用されます。 | PM |
'm' のコードはその位置とパターンに応じて解釈されます。 'h' または 'hh' の直後、あるいは 's' または 'ss' の直前に位置する場合には分を表すと解釈されますが、それ以外の場合には月を表すと解釈されます。
追加の記号
上記で説明されている特殊文字とコードに加えて、フォーマットパターンに使用可能な追加の文字と記号があります。 これらの追加文字と記号は \ または "" を必要とせず、フォーマットパターンの解釈に影響することはありません。 これらはパターン内において "そのまま" 表示されます。
文字 | 説明 | 例題 |
---|---|---|
- と - | プラス記号およびマイナス記号 | ### + ### = ###,### |
( ) | 左と右のカッコ記号 | (-###.##) |
: | コロン | hh:mm:ss |
^ | キャレット | #\^# |
' | アポストロフィー | '###### |
{ } | 中カッコ | {###,###,###} |
< > | 小なり大なり | ## >## |
= | 等号 | #+#=## |
/ | フォワードスラッシュ。 数値に対して使用した場合、分数として表記します。 | mm/dd/yyyy |
! | 感嘆符 | $###.00! |
& | アンパサンド | "Hello" & "Welcome" |
~ | チルダ | ~## |
スペース文字 | ||
€ | ユーロ | €###.00 |
£ | 英ポンド | £###.00 |
¥ | 日本円 | ¥###.00 |
$ | ドル記号 | $###.00 |
¢ | セント記号 | .00¢ |
印刷属性
4D View Pro 印刷属性を使って、4D View Pro エリアの印刷に関するすべての項目を管理することができます。 これらの属性は以下のコマンドによって操作します:
カラム / 行
カラム属性と行属性を使って、カラムと行の始まり、終わり、そして繰り返しについて指定します。
プロパティ | タイプ | 説明 |
---|---|---|
columnEnd | longint | セルレンジ内で印刷する最後のカラム。 デフォルト値 = -1 (全カラム) |
columnStart | longint | セルレンジ内で印刷する最初のカラム。 デフォルト値 = -1 (全カラム) |
repeatColumnEnd | longint | 各ページの左に印刷するカラムのレンジの、最後のカラム。 デフォルト値 = -1 (全カラム) |
repeatColumnStart | longint | 各ページの左に印刷するカラムのレンジの、最初のカラム。 デフォルト値 = -1 (全カラム) |
repeatRowEnd | longint | 各ページの上に印刷する行のレンジの、最後の行。 デフォルト値 = -1 (すべての行) |
repeatRowStart | longint | 各ページの上に印刷する行のレンジの、最初の行。 デフォルト値 = -1 (すべての行) |
rowEnd | longint | セルレンジ内で印刷する最後の行。 デフォルト値 = -1 (すべての行) |
rowStart | longint | セルレンジ内で印刷する最初の行。 デフォルト値 = -1 (すべての行) |
ヘッダー / フッター
ヘッダー属性とフッター属性は、ヘッダー/フッターセクションの左・右・センターのテキストまたは画像を指定するのに使用されます。
プロパティ | タイプ | 説明 |
---|---|---|
footerCenter | text | 印刷ページのセンターフッターのテキストとフォーマット |
footerCenterImage | picture | text* | フッターのセンターセクションの画像 |
footerLeft | text | 印刷ページの左フッターのテキストとフォーマット |
footerLeftImage | picture | text* | フッターの左セクションの画像 |
footerRight | text | 印刷ページの右フッターのテキストとフォーマット |
footerRightImage | picture | text* | フッターの右セクションの画像 |
headerCenter | text | 印刷ページのセンターヘッダーのテキストとフォーマット |
headerCenterImage | picture | text* | ヘッダーのセンターセクションの画像 |
headerLeft | text | 印刷ページの左ヘッダーのテキストとフォーマット |
headerLeftImage | picture | text* | ヘッダーの左セクションの画像 |
headerRight | text | 印刷ページの右ヘッダーのテキストとフォーマット |
headerRightImage | picture | text* | ヘッダーの右セクションの画像 |
* テキスト型を使用する場合には、画像のファイルパス (絶対パスまたは相対パス) を渡します。 相対パスを渡す場合、ファイルはデータベースのストラクチャーファイルのと階層に置かれてなければなりません。 Windows では、ファイル拡張子も含めて渡します。 No matter the type used to set an image, the image itself (not a reference) is stored in the 4D View Pro area and is returned by VP Get print info.
特殊文字
以下の特殊文字を使用すると、4D View Pro エリアが印刷される際にヘッダーとフッター内に自動で情報を追加およびフォーマットすることができます。
文字 | 説明 | 例題 | 戻り値 | |
---|---|---|---|---|
& | エスケープ文字 | (以下の例を参照) | ||
P | カレントページ | printInfo.headerLeft:="This is page &P." | This is page 5. | |
N | ページ数 | printInfo.headerLeft:="There are &N pages." | 10 ページあります | |
D | カレント日付 (yyyy/mm/dd フォーマット) | printInfo.headerLeft:="It is &D." | 日付は 2015/6/19 です | |
T | 現在の時刻 | printInfo.headerLeft:="It is &T." | 時刻は 16:30:36 です | |
G | ピクチャー | printInfo.headerLeftImage:=smiley printInfo.headerLeft:="&G" | ||
S | 打ち消し線 | printInfo.headerLeft:="&SThis is text." | ||
U | 下線 | printInfo.headerLeft:="&UThis is text." | これはテキストです (下線) | |
B | 太字 | printInfo.headerLeft:="&BThis is text." | This is text. | |
I | イタリック | printInfo.headerLeft:="&IThis is text." | This is text. | |
" | フォント指定 | printInfo.headerLeft:="&\"Lucida Console\"&14This is text." | ||
K | 文字カラー指定 | printInfo.headerLeft:="&KFF0000This is text." | これはテキストです (赤字)。 | |
F | ワークブック名 | printInfo.headerLeft:="&F" | 2019 Monthly Revenue Forecasts | |
A | スプレッドシート名 | printInfo.headerLeft:="&A" | June 2019 revenue forecast |
マージン
マージン属性は、印刷時の 4D View Pro エリアのマージンを指定するために使用されます。 100分の1インチ単位で表現されます。
プロパティ | タイプ | 説明 | |
---|---|---|---|
margin | object | 印刷マージン | |
top | longint | 上部マージン、100分の1インチ単位。 デフォルト値 = 75 | |
bottom | longint | 下部マージン、100分の1インチ単位。 デフォルト値 = 75 | |
left | longint | 左マージン、100分の1インチ単位。 デフォルト値 = 70 | |
right | longint | 右マージン、100分の1インチ単位。 デフォルト値 = 70 | |
header | longint | ヘッダーのオフセット、100分の1インチ単位。 デフォルト値 = 30 | |
footer | longint | フッターのオフセット、100分の1インチ単位。 デフォルト値 = 30 |
方向
向き属性は、印刷ページレイアウトの方向を指定するのに使用されます。
この属性はレンダリング情報のみを定義します。
プロパティ | タイプ | 説明 |
---|---|---|
orientation | longint | ページの向き。 Available values: vk print page orientation landscape , vk print page orientation portrait (default) |
ページ
ページ属性は、一般的なドキュメント印刷設定を指定するのに使用されます。
プロパティ | タイプ | 説明 |
---|---|---|
blackAndWhite | boolean | 白黒で印刷します。 Default value = false Note: PDFs are not affected by this attribute. Colors in PDFs remain. |
centering | longint | 印刷ページ上でコンテンツをどのように中央揃えするかを指定します。 Available values: vk print centering both , vk print centering horizontal , vk print centering none (default), vk print centering vertical |
firstPageNumber | longint | 最初のページに印刷するページ番号。デフォルト値 = 1 |
pageOrder | longint | ページの印刷順。 Available values: vk print page order auto (default), vk print page order down then over , vk print page order over then down . |
pageRange | text | 印刷されるページの範囲 |
qualityFactor | longint | 印刷の品質指定 (1 - 8)。 The higher the quality factor, the better the printing quality, however printing performance may be affected. Default value = 2 |
useMax | boolean | Only columns and rows with data are printed. Default value = true |
zoomFactor | 実数 | The amount to enlarge or reduce the printed page. Default value = 1 |
用紙サイズ
用紙サイズ属性は印刷に使用する用紙の寸法や規格サイズを指定します。 用紙サイズを定義するには 2つの方法があります:
- カスタムサイズ - height と width 属性を使用
- 規格サイズ - kind 属性を使用
プロパティ | タイプ | 説明 | |
---|---|---|---|
paperSize | object | 印刷に使用する用紙の寸法 (height、width) または規格 (kind) | |
height | longint | 用紙の高さ、100分の1インチ単位 | |
width | longint | 用紙の幅、100分の1インチ単位 | |
kind | text | Name of standard paper size (e.g., A2, A4, legal, etc.) returned by Get Print Option . デフォルト値 = "letter" |
If the paper size is specified using the
height
andwidth
properties,VP Get print info
returns a paper size withcustom
as value forkind
.If you set the paper size using the
kind
property, you can use either:- one of the formats in the SpreadJS format list
- one of the formats returned by the
PRINT OPTION VALUES
command. In that case,VP Get print info
returns the corresponding format with the height and width.
スケール
スケール属性は印刷の最適化と調整のために使用されます。
プロパティ | タイプ | 説明 |
---|---|---|
bestFitColumns | boolean | 印刷時、カラムの幅はテキストの最大幅に合うように調整されます。 デフォルト値 = false |
bestFitRows | boolean | 印刷時、行の高さはテキストの最大高さに合うように調整されます。 デフォルト値 = false |
fitPagesTall | longint | 最適化印刷時、チェックする垂直方向 (縦向き) のページ数。 デフォルト値 = -1 |
fitPagesWide | longint | 最適化印刷時、チェックする水平方向 (横向き) のページ数。 デフォルト値 = -1 |
表示 / 非表示
表示 / 非表示属性は 4D View Pro エリア要素の表示 (印刷) 状態を指定するのに使用されます。
プロパティ | タイプ | 説明 |
---|---|---|
showBorder | boolean | 外枠の境界線を印刷します。デフォルト値 = true |
showColumnHeader | longint | カラムヘッダーの印刷設定。 Available values: vk print visibility hide , vk print visibility inherit (default), vk print visibility show , vk print visibility show once |
showGridLine | boolean | 枠線を印刷します。 デフォルト値 = false |
showRowHeader | longint | 行ヘッダーの印刷設定。 Available values: vk print visibility hide , vk print visibility inherit (default), vk print visibility show , vk print visibility show once |
ウォーターマーク
ウォーターマーク属性は 4D View Pro エリアに透かしとして、テキストまたは画像を重ねて表示するために使用されます。
プロパティ | タイプ | 説明 | |
---|---|---|---|
watermark | collection | ウォーターマーク設定のコレクション。 デフォルト値: undefined | |
[ ].height | longint | ウォーターマークのテキスト/画像の高さ。 | |
[ ].imageSrc | picture | text* | ウォーターマークのテキスト/画像。 | |
[ ].page | text | ウォーターマークが印刷されるページ。 全ページに印刷: "all"。 特定のページ: カンマで区切られたページ番号またはページの範囲。 例: "1,3,5-12" | |
[ ].width | longint | ウォーターマークのテキスト/画像の幅。 | |
[ ].x | longint | ウォーターマークのテキスト/画像の左上端の水平方向の座標 | |
[ ].y | longint | ウォーターマークのテキスト/画像の左上端の垂直方向の座標 |
* テキスト型を使用する場合には、画像のファイルパス (絶対パスまたは相対パス) を渡します。 相対パスを渡す場合、ファイルはデータベースのストラクチャーファイルのと階層に置かれてなければなりません。 Windows では、ファイル拡張子も含めて渡します。 No matter the type used to set an image, the image itself (not a reference) is stored in the 4D View Pro area and is returned by VP Get print info.
スタイルオブジェクト
4D View Pro スタイルオブジェクトとスタイルシートを使用すると、4D View Pro ドキュメントのグラフィカル要素や見た目を管理することができるようになります。
Style objects & Style sheets
スタイルオブジェクトには、スタイル設定が格納されます。 これらはスタイルシートで使用するか、あるいはそのまま使用することができます。 スタイルオブジェクトはスタイルシートと組み合わせて使用することもでき、ドキュメントの他の部分に影響を及ぼすことなく個別のセルレンジに異なる設定を指定することもできます。 You can use style objects directly with the VP SET CELL STYLE and VP SET DEFAULT STYLE commands. You can also use style objects when defining custom table themes using the VP SET TABLE THEME or VP CREATE TABLE commands.
A style sheet groups together a combination of properties in a style object to specify the look of all of the cells in your 4D View Pro documents. ドキュメントとともに保存されたスタイルシートを使用して、単一のシート、複数のシート、あるいはワークブック全体に対してプロパティを設定することができます。 4D View Pro スタイルシートは作成時に名前が与えられ、この名前はスタイルシートの "name" プロパティに保存されます。 これによりスタイルシートの使用が容易になり、また注意深く命名することで、その定義と目的を分かりやすくすることもできます (例: Letterhead_internal、Letterhead_external、など)。
Style sheets are created with the VP ADD STYLESHEET command and applied with the the VP SET DEFAULT STYLE or VP SET CELL STYLE commands. You can remove a style sheet with the VP REMOVE STYLESHEET command.
The VP Get stylesheet command can be used to return the style object of a single style sheet or you can use the VP Get stylesheets command to retrieve a collection of style objects for multiple style sheets.
スタイルオブジェクトプロパティ
例:
$style:=New object
$style.hAlign:=vk horizontal align left
$style.font:="12pt papyrus"
$style.backColor:="#E6E6FA" //light purple color
VP SET DEFAULT STYLE("myDoc";$style)
Background & Foreground
プロパティ | タイプ | 説明 | とりうる値 |
---|---|---|---|
backColor | text | 背景色を定義します。 | CSSカラー "#rrggbb" シンタックス (推奨シンタックス)、CSSカラー "rgb(r,g,b)" シンタックス (代替シンタックス)、CSSカラーネーム (代替シンタックス) |
backgroundImage | picture, text | 背景画像を指定します。 | 直接指定するか、または画像パス (フルパス、またはファイル名のみ) で指定することができます。 ファイル名のみを使用する場合、ファイルはデータベースのストラクチャーファイルと同じ階層に置かれている必要があります。 指定の方法 (ピクチャーまたはテキスト) に関わらず、ピクチャーはドキュメントとともに保存されます。 画像のサイズが大きい場合、ドキュメントのサイズに影響する場合があります。 Windows での注意: ファイル拡張子も含める必要があります。 |
backgroundImageLayout | longint | 背景画像のレイアウトを定義します。 | vk image layout center , vk image layout none , vk image layout stretch , vk image layout zoom |
foreColor | text | 文字のカラーを定義します。 | CSSカラー "#rrggbb" シンタックス (推奨シンタックス)、CSSカラー "rgb(r,g,b)" シンタックス (代替シンタックス)、CSSカラーネーム (代替シンタックス) |
境界線
プロパティ | タイプ | 説明 | とりうる値 | |
---|---|---|---|---|
borderBottom, borderLeft, borderRight, borderTop, diagonalDown, diagonalUp | object | それぞれに対応する境界線を定義します。 | ||
color | text | 境界線のカラーを定義します。 デフォルト = black | CSSカラー "#rrggbb" シンタックス (推奨シンタックス)、CSSカラー "rgb(r,g,b)" シンタックス (代替シンタックス)、CSSカラーネーム (代替シンタックス) | |
style | longint | 境界線のスタイルを定義します。 デフォルト = 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 |
フォントとテキスト
プロパティ | タイプ | 説明 | とりうる値 | |
---|---|---|---|---|
font | text | フォントの特徴を CSS の fontショートハンドで指定します ("font-style font-variant font-weight font-size/line-height font-family")。 例: "14pt Century Gothic"。 フォントサイズ (font-size) とフォントファミリー (font-family) の値は必須です。 その他の値が省略された場合には、そのデフォルト値が使用されます。 注: フォント名にスペースが含まれる場合、その名前は引用符 ("") で括られる必要があります。 | CSS fontショートハンド。 4D provides utility commands to handle font characteristics as objects: VP Font to object and VP Object to font | |
formatter | text | 値や日時に対するパターン | 数値/テキスト/日付/時間フォーマット、特殊文字など。 See Cell Format. | |
isVerticalText | boolean | テキストの向きを指定します。 | true = 縦方向のテキスト, false = 横方向のテキスト | |
labelOptions | object | セルラベルのオプションを定義します (ウォーターマークオプション) | ||
alignment | longint | セルラベルの位置を指定します。 任意プロパティです。 | 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 | longint | セルラベルの表示状態を指定します。 任意プロパティです。 | vk label visibility auto , vk label visibility hidden , vk label visibility visible | |
foreColor | text | 文字のカラーを定義します。 任意プロパティです。 | CSSカラー "#rrggbb" シンタックス (推奨シンタックス)、CSSカラー "rgb(r,g,b)" シンタックス (代替シンタックス)、CSSカラーネーム (代替シンタックス) | |
font | text | フォントの特徴を CSS の fontショートハンドで指定します ("font-style font-variant font-weight font-size/line-height font-family")。 フォントサイズ (font-size) とフォントファミリー (font-family) の値は必須です。 | ||
textDecoration | longint | テキストに追加する装飾を指定します。 | vk text decoration double underline , vk text decoration line through , vk text decoration none , vk text decoration overline , vk text decoration underline | |
textIndent | longint | テキストのインデントを定義します。 1 = 8ピクセル | ||
textOrientation | longint | セル内のテキストの回転角度を定義します。 -90 から 90 の数値 | ||
watermark | text | ウォーターマーク (セルラベル) のコンテンツを定義します。 | ||
wordWrap | boolean | テキストを折り返すかどうかを指定します。 | true = テキストを折り返す、false = テキストを折り返さない |
レイアウト
プロパティ | タイプ | 説明 | とりうる値 |
---|---|---|---|
cellPadding | text | セルのパッディングを定義します | |
hAlign | longint | セルコンテンツの水平方向の揃え方を定義します | vk horizontal align center , vk horizontal align general , vk horizontal align left , vk horizontal align right |
locked | boolean | セルの保護状態を指定します。 Note, this is only available if sheet protection is enabled. | true = ロックされている、false = ロック解除 |
shrinkToFit | boolean | セルのコンテンツが縮小されるかどうかを指定します。 | true = コンテンツ縮小、false = 縮小なし |
tabStop | boolean | Tabキーを使用してセルにフォーカスできるかどうかを指定します。 | true = Tabキーでフォーカス可、false = Tabキーでフォーカス不可 |
vAlign | longint | セルコンテンツの垂直方向の揃え方を定義します | vk vertical align bottom , vk vertical align center , vk vertical align top |
スタイル情報
プロパティ | タイプ | 説明 |
---|---|---|
name | text | スタイルの名前を定義します。 |
parentName | text | カレントスタイルの元となっているスタイルを指定します。 まず親スタイルの値が適用され、次にカレントスタイルの値が適用されます。 カレントスタイルの変更は親スタイルには反映されません。 これはスタイルシートを使用している時のみ利用可能です。 |
4D View Pro オブジェクト
The 4D View Pro object stores the whole spreadsheet contents. このオブジェクトは 4D View Pro によって自動的に管理されます。 You can set or get this object using the VP IMPORT FROM OBJECT or VP Export to object commands.
このオブジェクトには次のプロパティが含まれます:
プロパティ | 値の型 | 説明 |
---|---|---|
version | Longint | 内部コンポーネントのバージョン |
dateCreation | Timestamp | 作成日 |
dateModified | Timestamp | 最終更新日 |
meta | Object | 4Dデベロッパー専用の任意コンテンツ |
spreadJS | Object | 4D View Pro コンポーネント専用 |
4D View Pro フォームオブジェクト変数
The 4D View Pro form object variable is the object variable associated to the 4D View Pro form area. この変数は、4D View Pro オブジェクトが使用する情報を管理します。
4D View Pro フォームオブジェクト変数は、情報目的 (例: デバッグなど) のためだけに存在します。 どのような状況においてもこれを編集してはいけません。
このオブジェクトには次のプロパティが含まれます:
プロパティ | 値の型 | 説明 |
---|---|---|
ViewPro.area | Text | 4D View Pro エリア名 |
ViewPro.callbacks | Object | インポートやエクスポートなど、コールバックを必要とするコマンドが使用するための一時的な情報を保存します。 |
ViewPro.commandBuffers | Collection | Stores sequentially the commands called by the method and executes them as a batch (rather than individually) when exiting the method, when a command returns a value, or when the VP FLUSH COMMANDS is called. この機構によって、送信されるリクエスト数が抑えられ、パフォーマンスが向上します。 |
ViewPro.events | Object | Event list. |
ViewPro.formulaBar | Boolean | フォーミュラバーが表示されているかどうかを示します。 "toolbar" インターフェースにおいてのみ利用可能です。 |
ViewPro.inited | Boolean | Indicates whether or not the 4D View Pro area has been initialized (see On VP Ready event). |
ViewPro.interface | Text | ユーザーインターフェースのタイプを指定します: "ribbon"、"toolbar"、"none"。 |