5.5.8 ADD
ADD コマンドを使って、シート、セルのスタイル、指定領域、イメージ、式、ハイパーリンク、コメント、セルの結合を Excel ドキュメントに追加できます。取られるアクションは、オブジェクトのキーワードの値によって異なります。
ADD SHEET
構文：
コマンド |
キーワード |
値 |
開発者用メモ |
ADD |
OBJECT |
*SHEET |
|
|
SHEET |
値 |
必須。シート名 |
例
ADD OBJECT(*SHEET) SHEET(Sales)
ADD COMMENT
構文：
コマンド |
キーワード |
値 |
開発者用メモ |
ADD |
OBJECT |
*COMMENT |
|
|
SHEET |
値 |
任意。特定のシート名を入力できます。シート名を入力しない場合は、現在のコンテキスト・シートが使用されます。 |
|
R1C1 |
n,n |
必須。セルの行と列です。 |
|
AREA |
n,n |
任意。四角形を表示します。 デフォルトは2,4です。 |
|
COMMENT |
値 |
任意。コメントのテキストです。このコメントのキーワードが使用されない場合、セルのコメントは削除されます。 |
例
ADD OBJECT(*COMMENT) R1C1(10,5) AREA(4,4) COMMENT(important data)
ADD CELL MERGE
構文：
コマンド |
キーワード |
値 |
開発者用メモ |
ADD |
OBJECT |
*CELLMERGE |
|
|
SHEET |
値 |
任意。特定のシート名を入力できます。シート名を入力しない場合は、現在のコンテキスト・シートが使用されます。 |
|
R1C1 |
n,n |
必須。セルの行と列です。 |
|
R2C2 |
n,n |
必須。セルの行と列です。 |
例
ADD OBJECT(*CELLMERGE) R1C1(10,5) R2C2(15,5)
ADD IMAGE
構文：
コマンド |
キーワード |
値 |
開発者用メモ |
ADD |
OBJECT |
*IMAGE |
|
|
SHEET |
値 |
任意。特定のシート名を入力できます。シート名を入力しない場合は、現在のコンテキスト・シートが使用されます。 |
|
FILE |
値 |
必須。PNG または JPEG 画像ファイルのパス |
|
R1C1 |
n,n |
必須。左上に位置する最初のアンカー |
|
R2C2 |
n,n |
任意。右下に位置する2番目のアンカーRESIZE(*CELL)オプションにより使用されます。 デフォルトはR1C1値です。 |
|
WIDTH |
整数 |
任意。イメージを指定の幅に調整します。RESIZE(*IMAGE) で使用します。 WIDTH または HEIGHT が指定されなかった場合のデフォルト値は 100 ピクセルです。 |
|
HEIGHT |
整数 |
任意。イメージを指定の高さに調整します。RESIZE(*IMAGE) で使用します。 |
|
DX1DY1 |
n,n |
任意。最初のセルに x と y の座標を設定します。 |
|
DX2DY2 |
n,n |
任意。2番目のセルに x と y の座標を設定します。 |
|
ROWHEIGHT |
整数 |
任意。行高を twip で設定する、または行高を計算します。 デフォルトは行高を設定しません。 |
|
|
*CALC |
この値は、RESIZE(*IMAGE) に対してのみ利用できます。 |
|
COLUMNWIDTH |
整数 |
任意。列幅を文字の 1/256 単位で設定する、または幅を計算します。 デフォルトは行幅を設定しません。 |
|
|
*CALC |
この値は、RESIZE(*IMAGE) に対してのみ利用できます。 |
|
RESIZE |
数値 |
任意。イメージのサイズ変更方法を指定します。 デフォルト値は 1.0 で、イメージは指定された数でサイズに調整され、セル R1C1 にアンカーされます。 |
|
|
*CELL |
イメージを1つのセルもしくはセルの範囲にアンカーできるようにします。 |
|
|
*IMAGE |
R1C1によって指定された1つのアンカーセル内のイメージを幅または高さに合わせてサイズ調整できるようにします。 |
|
ANCHOR |
*MOVE |
セルとともに移動しますが、サイズ調整はされません。 |
|
|
*NOMOVE |
元となる行・列で移動もサイズ調整も行われません。 |
|
|
*MOVEANDRESIZE |
デフォルト。アンカーセルで移動とサイズ調整を行います。 |
例
ADD OBJECT(*IMAGE) R1C1(5,8) FILE(boat.png) RESIZE(0.5)
ADD OBJECT(*IMAGE) R1C1(2,3) R2C2(4,5) FILE(boat.png) RESIZE(*CELL) ROWHEIGHT(3000) COLUMNWIDTH(4000)
ADD OBJECT(*IMAGE) R1C1(6,3) R2C2(8,4) FILE(boat.jpg) RESIZE(*CELL) ANCHOR(*MOVEANDRESIZE) ROWHEIGHT(800) COLUMNWIDTH(4000) DX1DY1(10,20) DX2DY2(-10,-20)
ADD OBJECT(*IMAGE) R1C1(6,7) R2C2(8,8) FILE(boat.jpg) RESIZE(*CELL) ANCHOR(*NOMOVE) ROWHEIGHT(800) COLUMNWIDTH(4000)
ADD OBJECT(*IMAGE) R1C1(6,3) FILE(boat.jpg) RESIZE(*IMAGE) HEIGHT(100) ANCHOR(*MOVE) ROWHEIGHT(*CALC) COLUMNWIDTH(*CALC) DX1DY1(10,10)
ADD OBJECT(*IMAGE) R1C1(7,3) FILE(boat.jpg) RESIZE(*IMAGE) WIDTH(100) DX1DY1(10,10) ROWHEIGHT(*CALC) ANCHOR(*MOVE)
ADD FORMULA
構文：
コマンド |
キーワード |
値 |
開発者用メモ |
ADD |
OBJECT |
*FORMULA |
|
|
SHEET |
値 |
任意。特定のシート名を入力できます。シート名を入力しない場合は、現在のコンテキスト・シートが使用されます。 |
|
R1C1 |
n,n |
必須。セルの行と列です。 |
|
FORMULA |
値 |
必須。Excel の式です。 |
例
ADD OBJECT(*FORMULA) R1C1(4,2) FORMULA("SUM(H5:H44)")
ADD OBJECT(*FORMULA) R1C1(2,12) FORMULA("HYPERLINK(\"http://www.lansa.com\",\"Test Link\")")
ADD HYPERLINK
構文：
コマンド |
キーワード |
値 |
開発者用メモ |
ADD |
OBJECT |
*HYPERLINK |
|
|
SHEET |
値 |
任意。特定のシート名を入力できます。シート名を入力しない場合は、現在のコンテキスト・シートが使用されます。 |
|
R1C1 |
n,n |
必須。セルの行と列です。 |
|
TYPE |
*URL |
デフォルト。ハイパーリンクのタイプです。 |
|
|
*FILE |
|
|
|
|
|
|
|
*DOCUMENT |
|
|
ADDRESS |
値 |
必須。ハイパーリンクのアドレスです。 |
|
LABEL |
値 |
任意。ハイパーリンクのラベルです。 |
例
ADD OBJECT(*HYPERLINK) R1C1(10,2) TYPE(*URL) ADDRESS(http://www.lansa.com
) LABEL(LANSA Home)
ADD OBJECT(*HYPERLINK) R1C1(13,1) TYPE(*DOCUMENT) ADDRESS(MYSHEET!A2) LABEL(Employees)
ADD NAME
構文：
コマンド |
キーワード |
値 |
開発者用メモ |
ADD |
OBJECT |
*NAME |
|
|
SHEET |
値 |
任意。参照にシート名が含まれていない場合、参照の前に付けるシート名。 |
|
NAME |
値 |
必須。名前。 |
|
REFERENCE |
値 |
必須。式の参照 |
|
COMMENT |
値 |
任意。コメント |
例
ADD OBJECT(*NAME) NAME(TOTAL) REFERENCE(A1:C5)
ADD OBJECT(*NAME) NAME(TOTAL) REFERENCE(Sheet1!A1:C5) COMMENT(Total Amount)
ADD OBJECT(*NAME) NAME(TOTAL) REFERENCE(SUM(Sheet1!I$2:I$6)) COMMENT(Total Amount)
ADD CELL STYLE
構文：
コマンド |
キーワード |
値 |
開発者用メモ |
||
ADD |
OBJECT |
*CELLSTYLE |
|
||
|
SHEET |
値 |
必須。セル・スタイルに関連付けられたシート名。 |
||
|
COLUMN |
n n.n |
必須。セル・スタイルを適用したい列番号、もしくは列番号の範囲を指定します。単一の列番号またはカンマ区切りの範囲を指定できます。 |
||
|
RANGE |
n,n |
任意。セル・スタイルを適用する指定の列内の、行範囲を定義できます。 ブランクのままの場合、列全体に適用されます。 |
||
|
TYPE |
*NUMBER |
任意。列タイプの定義。 デフォルト。 |
||
|
|
*DATE |
|
||
|
|
*BOOLEAN |
|
||
|
|
*STRING |
|
||
|
|
*BLANK |
|
||
|
FORMAT |
値 |
任意。セル値に適用する Excel 形式。 デフォルト形式はセル・タイプにより異なります。 セル・タイプが *DATEの場合 デフォルトの形式は組み込み形式 *FORMAT14 で、これは国際的な日付形式です。 その他のすべてのセル・タイプの場合のデフォルト形式は、組み込み形式 *FORMAT0 で、これが一般的な形式です。 |
||
|
|
*FORMAT0 |
一般的な形式 |
||
|
|
*FORMAT1 |
0 |
||
|
|
*FORMAT2 |
0.00 |
||
|
|
*FORMAT3 |
#,##0 |
||
|
|
*FORMAT4 |
#,##0.00 |
||
|
|
*FORMAT5 |
"$"#,##0_);("$"#,##0) |
||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="d263c81b-bee1-4087-b914-d507bfa6f807"><ac:plain-text-body><![CDATA[ |
|
|
*FORMAT6 |
"$"#,##0_);[Red]("$"#,##0) |
]]></ac:plain-text-body></ac:structured-macro> |
|
|
*FORMAT7 |
"$"#,##0.00_);("$"#,##0.00) |
||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="91b5ab48-d7bc-4a11-916a-2241edf5de49"><ac:plain-text-body><![CDATA[ |
|
|
*FORMAT8 |
"$"#,##0.00_);[Red]("$"#,##0.00) |
]]></ac:plain-text-body></ac:structured-macro> |
|
|
*FORMAT9 |
0% |
||
|
|
*FORMAT10 |
0.00% |
||
|
|
*FORMAT11 |
0.00E+00 |
||
|
|
*FORMAT12 |
|
||
|
|
*FORMAT13 |
|
||
|
|
*FORMAT14 |
m/d/yy |
||
|
|
*FORMAT15 |
d-mmm-yy |
||
|
|
*FORMAT16 |
d-mmm |
||
|
|
*FORMAT17 |
mmm-yy |
||
|
|
*FORMAT18 |
h:mm AM/PM |
||
|
|
*FORMAT19 |
h:mm:ss AM/PM |
||
|
|
*FORMAT20 |
h:mm |
||
|
|
*FORMAT21 |
h:mm:ss |
||
|
|
*FORMAT22 |
m/d/yy h:mm |
||
|
|
*FORMAT37 |
#,##0_);(#,##0) |
||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="9c2d7833-485f-41c6-b376-5a9164381d27"><ac:plain-text-body>< |
]]></ac:plain-text-body></ac:structured-macro> |
|
|
*FORMAT39 |
#,##0.00_);(#,##0.00) |
||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a555939d-8b87-45f6-b06b-df553683d1db"><ac:plain-text-body>< |
]]></ac:plain-text-body></ac:structured-macro> |
|
|
*FORMAT41 |
("$"* #,##0);("$"* (#,##0);("$"* "-");(@_) |
||
|
|
*FORMAT42 |
(* #,##0);(* (#,##0);(* "-");(@_) |
||
|
|
*FORMAT43 |
("$"* #,##0.00);("$"* (#,##0.00);("$"* "-"??);(@_) |
||
|
|
*FORMAT44 |
(* #,##0.00);(* (#,##0.00);(* "-"??);(@_) |
||
|
|
*FORMAT45 |
mm:ss |
||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="761e14ad-edc7-4431-8f2a-0ff1ec2206a9"><ac:plain-text-body><![CDATA[ |
|
|
*FORMAT46 |
[h]:mm:ss |
]]></ac:plain-text-body></ac:structured-macro> |
|
|
*FORMAT47 |
mm:ss.0 |
||
|
|
*FORMAT48 |
##0.0E+0 |
||
|
|
*FORMAT49 |
@ |
||
|
FONT |
値 |
Windows の有効なフォント名のいずれか。 |
||
|
|
*ARIAL |
|
||
|
|
*CALIBRI |
|
||
|
|
*COURIER |
|
||
|
|
*COURIERNEW |
|
||
|
|
*TAHOMA |
|
||
|
|
*TIMES |
|
||
|
FONTSIZE |
値 |
任意。フォント・サイズ。 デフォルトのポイント・サイズは11です。 |
||
|
FONTCOLOR |
色 |
任意。フォントの色を指定します。 この表の最後にある色リストを参照してください。 |
||
|
BOLD |
*YES |
任意。フォントを太字に設定します。 |
||
|
|
*NO |
デフォルト。 |
||
|
ITALIC |
*YES |
任意。フォントを車体にするかどうかを設定します。 |
||
|
|
*NO |
デフォルト。 |
||
|
BORDER |
*ALL |
任意。枠の線を定義します。 デフォルト値はありません。 |
||
|
|
*NONE |
|
||
|
|
*TOP |
|
||
|
|
*BOTTOM |
|
||
|
|
*LEFT |
|
||
|
|
*RIGHT |
|
||
|
BORDERSTYLE |
*NONE |
条件付。枠線のスタイルを定義します。 BORDERキーワードはこのキーワードと組み合わせて指定してください。 |
||
|
|
*MEDIUM |
|
||
|
|
*THICK |
|
||
|
|
*THIN |
デフォルト。 |
||
|
|
*HAIR |
|
||
|
|
*DOUBLE |
|
||
|
BORDERCOLOR |
色 |
条件付。枠線の色を定義します。 BORDERキーワードはこのキーワードと組み合わせて指定してください。 この表の最後にある色リストを参照してください。 |
||
|
BACKGROUND |
色 |
任意。背景の色を定義します。この表の最後にある色リストを参照してください。 デフォルト値はありません。 |
||
|
WRAP |
*YES |
任意。テキスト文字の折返しを有効にします。 |
||
|
|
*NO |
デフォルト。 |
||
|
LOCKED |
*YES |
任意。ロックを有効にします。 |
||
|
|
*NO |
デフォルト。 |
||
|
INDENT |
値 |
任意。セル値のインデントを指定します。 デフォルトの値は0です。 |
||
|
HALIGN |
*CENTER |
任意。横方向の配置を定義します。 デフォルト値はありません。 |
||
|
|
*FILL |
|
||
|
|
*GENERAL |
|
||
|
|
*JUSTIFY |
|
||
|
|
*LEFT |
|
||
|
|
*RIGHT |
|
||
|
VALIGN |
*CENTER |
任意。縦方向の配置を定義します。 デフォルト値はありません。 |
||
|
|
*JUSTIFY |
|
||
|
|
*TOP |
|
||
|
|
*BOTTOM |
|
フォント、枠線、背景の色
*AQUA |
*DARKTEAL |
*LIGHTCORNFLOWERBLUE |
*PLUM |
*AUTOMATIC |
*DARKYELLOW |
*LIGHTGREEN |
*RED |
*BLACK |
*GOLD |
*LIGHTORANGE |
*ROSE |
*BLUE |
*GREEN |
*LIGHTTURQUOISE |
*SEAGREEN |
*BLUEGREY |
*GREY25 |
*LIGHTYELLOW |
*SKYBLUE |
*BRIGHTGREEN |
*GREY40 |
*LIME |
*TAN |
*BROWN |
*GREY50 |
*MAROON |
*TEAL |
*CORAL |
*GREY80 |
*OLIVEGREEN |
*TURQUOISE |
*CORNFLOWERBLUE |
*INDIGO |
*ORANGE |
*VIOLET |
*DARKBLUE |
*LAVENDAR |
*ORCHID |
*WHITE |
*DARKGREEN |
*LEMONCHIFFON |
*PALEBLUE |
*YELLOW |
*DARKRED |
*LIGHTBLUE |
*PINK |
|
例
ADD OBJECT(*CELLSTYLE) COLUMN(1,5) RANGE(3,5) FONT(*TAHOMA)
ADD OBJECT(*CELLSTYLE) TYPE(*NUMBER) COLUMN(8) FORMAT(*FORMAT4)
ADD OBJECT(*CELLSTYLE) TYPE(*STRING) COLUMN(1) RANGE(10,15) FONT(*ARIAL) BOLD(*YES)
ADD OBJECT(*CELLSTYLE) TYPE(*DATE) COLUMN(7) RANGE(20,25) FORMAT(dd mm yyyy)
ADD OBJECT(*CELLSTYLE) TYPE(*NUMBER) COLUMN(2) RANGE(10,15) FORMAT(#.##;#.##
HALIGN(*CENTRE) BACKGROUND(*YELLOW) FONT(*ARIAL) FONTSIZE(14.5) FONTCOLOR(*RED) ITALIC(*YES) BORDER(*ALL) BORDERCOLOR(*BLUE) BORDERSTYLE(*MEDIUM)