[]
↳ Shape
• new Shape(worksheet
, name
, autoShapeTypeOrModel
, left?
, top?
, width?
, height?
)
名前 | 型 | 説明 |
---|---|---|
worksheet |
Worksheet |
シェイプのホストワークシート。 |
name |
string |
シェイプの名前。名前が空の文字列の場合、一意の名前が生成します。 |
autoShapeTypeOrModel |
IShapeModel | AutoShapeType |
シェイプのタイプ(組み込みタイプのいずれか)、またはカスタムシェイプのモデル。 |
left? |
number |
- |
top? |
number |
- |
width? |
number |
- |
height? |
number |
- |
▸ adjustments(arrayValue?
): void
| number
[]
シェイプの調整値を取得または設定します。
実例
var blockArc = sheet.shapes.add("", GC.Spread.Sheets.Shapes.AutoShapeType.blockArc, 100, 60, 200, 160);
var adjustments = blockArc.adjustments();
console.log(adjustments);
adjustments[0] = 150;
adjustments[1] = 15;
adjustments[2] = 0.35;
blockArc.adjustments(adjustments);
blockArc.isSelected(true);
名前 | 型 | 説明 |
---|---|---|
arrayValue? |
number [] |
配列に格納された調整値。 |
void
| number
[]
値が設定されていない場合、シェイプの現在の調整値を返します。
▸ 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
値が設定されていない場合、シェイプの移動を無効にするかどうかの設定を返します。
▸ 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
値が設定されていない場合、シェイプのサイズ変更を無効にするかどうかの設定を返します。
▸ 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
値が設定されていない場合、シェイプの回転を無効にするかどうかの設定を返します。
▸ 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
シェイプの代替テキスト。
▸ 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
値が設定されていない場合、このシェイプが印刷可能かどうかを返します。
▸ 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
値が設定されていない場合、このシェイプが動的に移動するかどうかを返します。
▸ 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
値が設定されていない場合、このシェイプのサイズが動的に変更されるかどうかを返します。
▸ 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
値が設定されていない場合、シェイプの位置の終了列インデックスを返します。
▸ 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
値が設定されていない場合、シェイプの終了列に対するオフセットを返します。
▸ 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
値が設定されていない場合、シェイプの位置の終了行インデックスを返します。
▸ 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
値が設定されていない場合、シェイプの終了行に対するオフセットを返します。
▸ getFormula(path
): string
パスによってシェイプから数式の文字列を取得します。
実例
sheet.name("Sheet1");
sheet.setValue(0, 1, "This is a rectangle.");
var shape1 = sheet.shapes.add("myShape1", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 100, 100, 200, 200);
shape1.setFormula("text", "=Sheet1!B1");
shape1.getFormula("text");//returns "=Sheet1!B1"
名前 | 型 | 説明 |
---|---|---|
path |
string |
数式の文字列を受け入れることができるパス。 「x」、「y」、「width」、「height」、「rotate」、「text」、「style.fill.color」、 「style.fill.transparency」、「style.fill.src」、 「style.fill.tilePictureAsTexture」、「style.fill.offsetLeft」、 「style.fill.offsetRight」、 「style.fill.offsetTop」、 「style.fill.offsetBottom」、「style.fill.offsetX」、 「style.fill.offsetY」、 「style.fill.scaleX」、 「style.fill.scaleY」、 「style.fill.alignment」、 「style.fill.mirrorType」、「style.fill.type」、 「style.fill.angle」、 「style.fill.direction」、「style.fill.stops.0.color」、 「style.fill.stops.0.position」、 「style.fill.stops.0.transparency」、 「style.fill.stops.0.brightness」、「style.line.color」、 「style.line.lineStyle」、 「style.line.width」、 「style.line.capType」、 「style.line.joinType」、 「style.line.compoundType」、 「style .line.transparency 」、「style.textEffect.color」、 「style.textEffect.transparency」、 「style.textEffect.font」、「style.textFrame.vAlign」、「style.textFrame.hAlign」のいずれかに設定できます。 |
string
パスによってシェイプから数式の文字列を返します。
▸ 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
値が設定されていない場合、シェイプの高さを返します。
▸ 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
値が設定されていない場合は、シェイプの現在のハイパーリンク設定を返します。
▸ 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
値が設定されていない場合、このシェイプがロックされているかどうかを返します。
▸ 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
値が設定されていない場合、このシェイプが選択されているかどうかを返します。
▸ isTextBox(value?
): boolean
| void
テキストボックスシェイプを取得または設定します。
実例
var rectangle = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 100, 60, 200, 160);
rectangle.isTextBox(true);
名前 | 型 |
---|---|
value? |
boolean |
boolean
| void
値が設定されていない場合は、シェイプがテキストボックスであるかどうかを返します。
▸ 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
値が設定されていない場合、このシェイプが表示されるかどうかを返します。
▸ 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
値が設定されていない場合、シェイプの名前を返します。
▸ rotate(value?
): number
| void
シェイプの回転角度(度単位)を取得または設定します。
実例
var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.rotate();
heart.rotate(n + 30);
名前 | 型 | 説明 |
---|---|---|
value? |
string | number |
数値によって指定されたシェイプの回転角度(度単位)、または数値を取得できる数式(=で始まる)。 |
number
| void
値が設定されていない場合、シェイプの回転角度(度単位)を返します。
▸ setFormula(path
, formula
): void
パスによってシェイプに数式の文字列を設定します。
実例
sheet.name("Sheet1");
sheet.setValue(0, 1, "This is a rectangle.");
var shape1 = sheet.shapes.add("myShape1", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 100, 100, 200, 200);
shape1.setFormula("text", "=Sheet1!B1");
名前 | 型 | 説明 |
---|---|---|
path |
string |
数式の文字列を受け入れることができるパス。 「x」、「y」、「width」、「height」、「rotate」、「text」、「style.fill.color」、 「style.fill.transparency」、「style.fill.src」、 「style.fill.tilePictureAsTexture」、「style.fill.offsetLeft」、 「style.fill.offsetRight」、 「style.fill.offsetTop」、 「style.fill.offsetBottom」、「style.fill.offsetX」、 「style.fill.offsetY」、 「style.fill.scaleX」、 「style.fill.scaleY」、 「style.fill.alignment」、 「style.fill.mirrorType」、「style.fill.type」、 「style.fill.angle」、 「style.fill.direction」、「style.fill.stops.0.color」、 「style.fill.stops.0.position」、 「style.fill.stops.0.transparency」、 「style.fill.stops.0.brightness」、「style.line.color」、 「style.line.lineStyle」、 「style.line.width」、 「style.line.capType」、 「style.line.joinType」、 「style.line.compoundType」、 「style .line.transparency 」、「style.textEffect.color」、 「style.textEffect.transparency」、 「style.textEffect.font」、「style.textFrame.vAlign」、「style.textFrame.hAlign」のいずれかに設定できます。 |
formula |
string |
数式文字列。 |
void
▸ 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
値が設定されていない場合、シェイプのハンドルを表示するかどうかの設定を返します。
▸ 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
値が設定されていない場合、シェイプの位置の開始列インデックスを返します。
▸ 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
値が設定されていない場合、シェイプの開始列に対するオフセットを返します。
▸ 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
値が設定されていない場合、シェイプの位置の開始行インデックスを返します。
▸ 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
値が設定されていない場合、シェイプの開始行に対するオフセットを返します。
▸ style(value?
): any
シェイプのスタイルを取得または設定します。
実例
// 次のサンプルコードは、シェイプのスタイルを設定します。
var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var oldStyle = heart.style();
oldStyle.fill.color = "red";
oldStyle.fill.transparency = 0.5;
oldStyle.line.color = "green";
oldStyle.line.lineStyle = GC.Spread.Sheets.Shapes.PresetLineDashStyle.dashDot;
oldStyle.line.width = 5;
oldStyle.line.capType = GC.Spread.Sheets.Shapes.LineCapStyle.square;
oldStyle.line.joinType = GC.Spread.Sheets.Shapes.LineJoinStyle.miter;
oldStyle.line.compoundType = GC.Spread.Sheets.Shapes.CompoundType.double;
oldStyle.line.transparency = 0.5;
oldStyle.textEffect.color = "yellow";
oldStyle.textEffect.transparency = 0.5;
oldStyle.textEffect.font = "20px Arial";
oldStyle.textFrame.vAlign = GC.Spread.Sheets.VerticalAlign.center;
oldStyle.textFrame.hAlign = GC.Spread.Sheets.HorizontalAlign.center;
heart.style(oldStyle);
heart.text("Heart");
名前 | 型 | 説明 |
---|---|---|
value? |
ShapeStyle |
シェイプのスタイル。 |
any
値が設定されていない場合、シェイプの現在のスタイルを返します。
▸ text(value?
): any
シェイプのテキストを取得または設定します。
実例
var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
heart.text("My Shape");
var s = heart.text();
名前 | 型 | 説明 |
---|---|---|
value? |
string |
文字列によって指定されたシェイプのテキスト、または文字列を取得できる数式(=で始まる)。 |
any
値が設定されていない場合、シェイプのテキストを返します。
▸ toImageSrc(): string
Base64 文字列タイプのシェイプ画像の src を取得します。
実例
let shapeImageSrc = sheet.shapes.all()[0].toImageSrc();
string
シェイプ画像の Base64 src 文字列を返します。
▸ type(value?
): any
シェイプのタイプを取得または設定します。
実例
var heart = sheet.shapes.add("Shape1", GC.Spread.Sheets.Shapes.AutoShapeType.heart, 100, 60, 200, 160);
var n = heart.type();
heart.type(GC.Spread.Sheets.Shapes.AutoShapeType.cloud);
名前 | 型 | 説明 |
---|---|---|
value? |
AutoShapeType |
シェイプのタイプ。 |
any
値が設定されていない場合、シェイプのタイプを返します。
▸ 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
値が設定されていない場合、シェイプの幅を返します。
▸ 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
値が設定されていない場合、シェイプの水平位置を返します。
▸ 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
値が設定されていない場合、シェイプの垂直位置を返します。