View Source

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
		*EMAIL
		*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><![CDATA[			*FORMAT38	#,##0_);[Red](#,##0)	]]></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><![CDATA[			*FORMAT40	#,##0.00_);[Red](#,##0.00)	]]></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)