GC.Spread.Sheets.Shapes.GroupShape

クラス: GroupShape

Sheets.Shapes.GroupShape

階層

ShapeBase

↳ GroupShape

コンストラクタ

constructor

メソッド

コンストラクタ

constructor

• new GroupShape(worksheet, name?)

groupShapeを表します。

パラメータ

名前	型	説明
`worksheet`	`Worksheet`	groupShapeのホストシート。
`name?`	`string`	-

オーバーライド

ShapeBase.constructor

メソッド

add

▸ add(shape): void

シェイプをグループシェイプに追加します。

実例

var shape1 = activeSheet.shapes.add("shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 50, 100, 150);
var shape2 = activeSheet.shapes.add("shape2", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 260, 50, 100, 150);
var groupShape = activeSheet.shapes.group([shape1, shape2]);
var shape3 = activeSheet.shapes.add("shape3", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 260, 100, 150);
// shape3 を groupShape に追加します。
groupShape.add(shape3);

パラメータ

名前	型	説明
`shape`	`Shape`	グループシェイプに追加したシェイプ。

戻り値

void

all

▸ all(): Shape[]

グループシェイプのすべてのシェイプを取得します。

実例

// 次のサンプルコードは、グループシェイプに含まれるすべてのシェイプを取得する方法を示します。
var shape1 = sheet.shapes.add("myShape1", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 62 * 9, 0, 200, 200);
var shape2 = sheet.shapes.add("myShape2", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 20, 20, 200, 200);
var groupShape = sheet.shapes.group([shape1, shape2]);
var shapes = groupShape.all();

戻り値

Shape[]

すべてのシェイプ

allowMove

▸ allowMove(value?): any

シェイプの移動を無効にするかどうかを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var state = heart.allowMove();
heart.allowMove(!state);

パラメータ

名前	型	説明
`value?`	`boolean`	シェイプの移動を無効にするかどうかの設定。

戻り値

any

値が設定されていない場合、シェイプの移動を無効にするかどうかの設定を返します。

継承元

ShapeBase.allowMove

allowResize

▸ allowResize(value?): any

シェイプのサイズ変更モードを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var state = heart.allowResize();
heart.allowResize(GC.Spread.Sheets.Shapes.ResizeMode.aspect);

パラメータ

名前	型	説明
`value?`	`boolean` \| `ResizeMode`	シェイプのサイズ変更を無効にするかどうかの設定。

戻り値

any

値が設定されていない場合、シェイプのサイズ変更を無効にするかどうかの設定を返します。

継承元

ShapeBase.allowResize

allowRotate

▸ allowRotate(value?): any

シェイプの回転を無効にするかどうかを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var state = heart.allowRotate();
heart.allowRotate(!state);

パラメータ

名前	型	説明
`value?`	`boolean`	シェイプの回転を無効にするかどうかの設定。

戻り値

any

値が設定されていない場合、シェイプの回転を無効にするかどうかの設定を返します。

継承元

ShapeBase.allowRotate

alt

▸ alt(value?): any

スクリーンリーダーのシェイプの代替テキストを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
heart.alt("A heart shape");

パラメータ

名前	型
`value?`	`string`

戻り値

any

シェイプの代替テキスト。

継承元

ShapeBase.alt

canPrint

▸ canPrint(value?): any

このシェイプが印刷可能かどうかを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var state = heart.canPrint(); // シェイプが印刷可能かどうかを取得します。デフォルト値は true です。
workbook.print(); // ハートシェイプが印刷されます。
heart.canPrint(false);
workbook.print(); // ハートシェイプが印刷されません。

パラメータ

名前	型
`value?`	`boolean`

戻り値

any

値が設定されていない場合、このシェイプが印刷可能かどうかを返します。

継承元

ShapeBase.canPrint

dynamicMove

▸ dynamicMove(value?): any

行または列を表示/非表示にするとき、サイズ変更するとき、または移動するときにシェイプが移動するかどうかを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var state = heart.dynamicMove();
heart.dynamicMove(!state);

パラメータ

名前	型	説明
`value?`	`boolean`	行または列を表示/非表示にするとき、サイズ変更するとき、または移動するときにシェイプが移動するかどうかを示す値。

戻り値

any

値が設定されていない場合、このシェイプが動的に移動するかどうかを返します。

継承元

ShapeBase.dynamicMove

dynamicSize

▸ dynamicSize(value?): any

行または列を表示/非表示にするとき、サイズ変更するとき、または移動するときにシェイプのサイズが変更されるかどうかを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var state = heart.dynamicSize();
heart.dynamicSize(!state);

パラメータ

名前	型	説明
`value?`	`boolean`	行または列を表示/非表示にするとき、サイズ変更するとき、または移動するときにシェイプのサイズが変更されるかどうかを示す値。

戻り値

any

値が設定されていない場合、このシェイプのサイズが動的に変更されるかどうかを返します。

継承元

ShapeBase.dynamicSize

endColumn

▸ endColumn(value?): any

シェイプの位置の終了列インデックスを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.endColumn();
heart.endColumn(n + 1);

パラメータ

名前	型	説明
`value?`	`number`	シェイプの位置の終了列インデックス。

戻り値

any

値が設定されていない場合、シェイプの位置の終了列インデックスを返します。

継承元

ShapeBase.endColumn

endColumnOffset

▸ endColumnOffset(value?): any

シェイプの終了列に対するオフセットを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.endColumnOffset();
heart.endColumnOffset(0);

パラメータ

名前	型	説明
`value?`	`number`	シェイプの終了列に対するオフセット。

戻り値

any

値が設定されていない場合、シェイプの終了列に対するオフセットを返します。

継承元

ShapeBase.endColumnOffset

endRow

▸ endRow(value?): any

シェイプの位置の終了行インデックスを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.endRow();
heart.endRow(n + 2);

パラメータ

名前	型	説明
`value?`	`number`	シェイプの位置の終了行インデックス。

戻り値

any

値が設定されていない場合、シェイプの位置の終了行インデックスを返します。

継承元

ShapeBase.endRow

endRowOffset

▸ endRowOffset(value?): any

シェイプの終了行に対するオフセットを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.endRowOffset();
heart.endRowOffset(0);

パラメータ

名前	型	説明
`value?`	`number`	シェイプの終了行に対するオフセット。

戻り値

any

値が設定されていない場合、シェイプの終了行に対するオフセットを返します。

継承元

ShapeBase.endRowOffset

find

▸ find(name): Shape

グループシェイプ内の名前でシェイプを取得します。

実例

var shape1 = activeSheet.shapes.add("heart1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 50, 100, 150);
var shape2 = activeSheet.shapes.add("heart2", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 260, 50, 100, 150);
var groupShape = activeSheet.shapes.group([shape1, shape2]);
var heart1 = groupShape.find("heart1"); // heart1 は shape1 と等しいです。

パラメータ

名前	型	説明
`name`	`string`	groupShapeに含まれるシェイプの名前。

戻り値

Shape

指定した名前がグループシェイプ内のいずれかのシェイプと一致する場合はそのShapeインスタンス。それ以外の場合は<c>null</c>。

getFormula

▸ getFormula(path): string

パスによってシェイプから数式の文字列を取得します。

実例

sheet.name("Sheet1");
sheet.setValue(0, 1, 30);
var shape1 = sheet.shapes.add("myShape1", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 62 * 9, 0, 200, 200);
var shape2 = sheet.shapes.add("myShape2", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 20, 20, 200, 200);
var shape = sheet.shapes.group([shape1, shape2]);
shape.setFormula("rotate", "=Sheet1!B1");
shape.getFormula("rotate");//returns "=Sheet1!B1"

パラメータ

名前	型	説明
`path`	`string`	数式の文字列を受け入れることができるパス。「x」、「y」、「width」、「height」、「rotate」のいずれかに設定できます。

戻り値

string

パスによってシェイプから数式の文字列を返します。

オーバーライド

ShapeBase.getFormula

height

▸ height(value?): any

シェイプの高さを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.height();
heart.height(n + 50);

パラメータ

名前	型	説明
`value?`	`string` \| `number`	数値によって指定されたシェイプの高さ、または数値を取得できる数式（=で始まる）。

戻り値

any

値が設定されていない場合、シェイプの高さを返します。

継承元

ShapeBase.height

hyperlink

▸ hyperlink(value?): void | IHyperlink

シェイプのハイパーリンクを取得または設定します。

実例

var shape = sheet.shapes.add("myShape", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 62 * 9, 0, 200, 200);
shape.hyperlink({url: "http://www.spreadjs.com", target: 0, tooltip: 'goes to SpreadJS'});

パラメータ

名前	型
`value?`	`IHyperlink`

戻り値

void | IHyperlink

値が設定されていない場合は、シェイプの現在のハイパーリンク設定を返します。

継承元

ShapeBase.hyperlink

isLocked

▸ isLocked(value?): any

このシェイプがロックされているかどうかを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var state = heart.isLocked();
heart.isLocked(!state);

パラメータ

名前	型	説明
`value?`	`boolean`	このシェイプがロックされているかどうかを示す値。

戻り値

any

値が設定されていない場合、このシェイプがロックされているかどうかを返します。

継承元

ShapeBase.isLocked

isSelected

▸ isSelected(value?): any

このシェイプが選択されているかどうかを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var state = heart.isSelected();
heart.isSelected(!state);

パラメータ

名前	型	説明
`value?`	`boolean`	このシェイプが選択されているかどうかを示す値。

戻り値

any

値が設定されていない場合、このシェイプが選択されているかどうかを返します。

継承元

ShapeBase.isSelected

isVisible

▸ isVisible(value?): any

このシェイプが表示されるかどうかを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var state = heart.isVisible();
heart.isVisible(!state);

パラメータ

名前	型	説明
`value?`	`boolean`	このシェイプが表示されるかどうかを示す値。

戻り値

any

値が設定されていない場合、このシェイプが表示されるかどうかを返します。

継承元

ShapeBase.isVisible

name

▸ name(value?): any

シェイプの名前を取得または設定します。

実例

var shape1 = sheet.shapes.add("myShape1", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 62 * 9, 0, 200, 200);
var shape2 = sheet.shapes.add("myShape2", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 20, 20, 200, 200);
var shape = sheet.shapes.group([shape1, shape2]);
shape.name("myGroupShape");
var shapeName = shape.name();

パラメータ

名前	型	説明
`value?`	`string`	シェイプの名前。

戻り値

any

値が設定されていない場合、シェイプの名前を返します。

継承元

ShapeBase.name

remove

▸ remove(shape): void

シェイプをグループシェイプから削除します。

実例

var shape1 = activeSheet.shapes.add("shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 50, 100, 150);
var shape2 = activeSheet.shapes.add("shape2", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 260, 50, 100, 150);
var shape3 = activeSheet.shapes.add("shape3", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 260, 100, 150);
var groupShape = activeSheet.shapes.group([shape1, shape2, shape3]);
// shape3 を groupShape から削除します。
groupShape.remove(shape3);

パラメータ

名前	型	説明
`shape`	`Shape`	グループシェイプから削除したシェイプ。

戻り値

void

rotate

▸ rotate(value?): number | void

groupShapeの回転角度を取得または設定します。

実例

var shape1 = sheet.shapes.add("myShape1", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 62 * 9, 0, 200, 200);
var shape2 = sheet.shapes.add("myShape2", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 20, 20, 200, 200);
var shape = sheet.shapes.group([shape1, shape2]);
shape.rotate(60);
var angle = shape.rotate();

パラメータ

名前	型	説明
`value?`	`string` \| `number`	groupShapeの回転角度。単位は度です。

戻り値

number | void

パラメーター'value'がnullまたはundefinedの場合は、groupShapeの回転角度が返されます。

setFormula

▸ setFormula(path, formula): void

パスによってシェイプに数式の文字列を設定します。

実例

sheet.name("Sheet1");
sheet.setValue(0, 1, 30);
var shape1 = sheet.shapes.add("myShape1", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 62 * 9, 0, 200, 200);
var shape2 = sheet.shapes.add("myShape2", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 20, 20, 200, 200);
var shape = sheet.shapes.group([shape1, shape2]);
shape.setFormula("rotate", "=Sheet1!B1");

パラメータ

名前	型	説明
`path`	`string`	数式の文字列を受け入れることができるパス。「x」、「y」、「width」、「height」、「rotate」のいずれかに設定できます。
`formula`	`string`	数式文字列。

戻り値

void

オーバーライド

ShapeBase.setFormula

showHandle

▸ showHandle(value?): any

シェイプのハンドルを表示するかどうかを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var state = heart.showHandle();
heart.showHandle(!state);

パラメータ

名前	型	説明
`value?`	`boolean`	シェイプのハンドルを表示するかどうかの設定。

戻り値

any

値が設定されていない場合、シェイプのハンドルを表示するかどうかの設定を返します。

継承元

ShapeBase.showHandle

startColumn

▸ startColumn(value?): any

シェイプの位置の開始列インデックスを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.startColumn();
heart.startColumn(n + 2);

パラメータ

名前	型	説明
`value?`	`number`	シェイプの位置の開始列インデックス。

戻り値

any

値が設定されていない場合、シェイプの位置の開始列インデックスを返します。

継承元

ShapeBase.startColumn

startColumnOffset

▸ startColumnOffset(value?): any

シェイプの開始列に対するオフセットを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.startColumnOffset();
heart.startColumnOffset(0);

パラメータ

名前	型	説明
`value?`	`number`	シェイプの開始列に対するオフセット。

戻り値

any

値が設定されていない場合、シェイプの開始列に対するオフセットを返します。

継承元

ShapeBase.startColumnOffset

startRow

▸ startRow(value?): any

シェイプの位置の開始行インデックスを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.startRow();
heart.startRow(n + 2);

パラメータ

名前	型	説明
`value?`	`number`	シェイプの位置の開始行インデックス。

戻り値

any

値が設定されていない場合、シェイプの位置の開始行インデックスを返します。

継承元

ShapeBase.startRow

startRowOffset

▸ startRowOffset(value?): any

シェイプの開始行に対するオフセットを取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.startRowOffset();
heart.startRowOffset(0);

パラメータ

名前	型	説明
`value?`	`number`	シェイプの開始行に対するオフセット。

戻り値

any

値が設定されていない場合、シェイプの開始行に対するオフセットを返します。

継承元

ShapeBase.startRowOffset

toImageSrc

▸ toImageSrc(): string

Base64 文字列タイプのシェイプ画像の src を取得します。

実例

let shapeImageSrc = sheet.shapes.all()[0].toImageSrc();

戻り値

string

シェイプ画像の Base64 src 文字列を返します。

継承元

ShapeBase.toImageSrc

width

▸ width(value?): any

シェイプの幅を取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.width();
heart.width(n + 50);

パラメータ

名前	型	説明
`value?`	`string` \| `number`	数値によって指定されたシェイプの幅、または数値を取得できる数式（=で始まる）。

戻り値

any

値が設定されていない場合、シェイプの幅を返します。

継承元

ShapeBase.width

x

▸ x(value?): any

シェイプの水平位置を取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.x();
heart.x(n + 50);

パラメータ

名前	型	説明
`value?`	`string` \| `number`	数値によって指定されたシェイプの水平位置、または数値を取得できる数式（=で始まる）。

戻り値

any

値が設定されていない場合、シェイプの水平位置を返します。

継承元

ShapeBase.x

y

▸ y(value?): any

シェイプの垂直位置を取得または設定します。

実例

var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.y();
heart.y(n + 50);

パラメータ

名前	型	説明
`value?`	`string` \| `number`	数値によって指定されたシェイプの垂直位置、または数値を取得できる数式（=で始まる）。

戻り値

any

値が設定されていない場合、シェイプの垂直位置を返します。

継承元

ShapeBase.y

zIndex

▸ zIndex(shapeName, zIndex?): any

groupShape内のシェイプのZインデックスを設定または参照します。

実例

//これは、グループシェイプでZインデックスを使用する方法を示すサンプルです。
var shape1 = activeSheet.shapes.add("shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 50, 100, 150);
var shape2 = activeSheet.shapes.add("shape2", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 150, 50, 100, 150);
var style = shape1.style();
style.fill.color = "red";
shape1.style(style);
var myGroup = activeSheet.shapes.group([shape1, shape2]);
myGroup.zIndex("shape2"); // 1
myGroup.zIndex("shape2", 0);

パラメータ

名前	型	説明
`shapeName`	`string`	シェイプの名前。
`zIndex?`	`number`	シェイプのZインデックス。 Zインデックスの値は、0～シェイプ数-1までの間でなければなりません。Zインデックス値が大きいシェイプは、Zインデックス値が小さいシェイプの前面に表示されます。

戻り値

any

GC.Spread.Sheets.Shapes.GroupShape

クラス: GroupShape

階層

Table of contents

コンストラクタ

メソッド

コンストラクタ

constructor

パラメータ

オーバーライド

メソッド

add

パラメータ

戻り値

all

戻り値

allowMove

パラメータ

戻り値

継承元

allowResize

パラメータ

戻り値

継承元

allowRotate

パラメータ

戻り値

継承元

alt

パラメータ

戻り値

継承元

canPrint

パラメータ

戻り値

継承元

dynamicMove

パラメータ

戻り値

継承元

dynamicSize

パラメータ

戻り値

継承元

endColumn

パラメータ

戻り値

継承元

endColumnOffset

パラメータ

戻り値

継承元

endRow

パラメータ

戻り値

継承元

endRowOffset

パラメータ

戻り値

継承元

find

パラメータ

戻り値

getFormula

パラメータ

戻り値

オーバーライド

height

パラメータ

戻り値

継承元

hyperlink

パラメータ

戻り値

継承元

isLocked

パラメータ

戻り値

継承元

isSelected