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)

*FORMAT6

"$"#,##0_);[Red]("$"#,##0)

*FORMAT7

"$"#,##0.00_);("$"#,##0.00)

*FORMAT8

"$"#,##0.00_);[Red]("$"#,##0.00)

*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)

*FORMAT38

#,##0_);[Red](#,##0)

*FORMAT39

#,##0.00_);(#,##0.00)

*FORMAT40

#,##0.00_);[Red](#,##0.00)

*FORMAT41

("$"* #,##0);("$"* (#,##0);("$"* "-");(@_)

*FORMAT42

(* #,##0);(* (#,##0);(* "-");(@_)

*FORMAT43

("$"* #,##0.00);("$"* (#,##0.00);("$"* "-"??);(@_)

*FORMAT44

(* #,##0.00);(* (#,##0.00);(* "-"??);(@_)

*FORMAT45

mm:ss

*FORMAT46

[h]:mm:ss

*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

*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)