[]
↳ ConnectorShape
• new ConnectorShape(worksheet
, name
, connectorType?
, beginX?
, beginY?
, endX?
, endY?
)
ConnectorShapeを表します。
名前 | 型 | 説明 |
---|---|---|
worksheet |
Worksheet |
シェイプのホストシート。 |
name |
string |
シェイプの名前。 |
connectorType? |
ConnectorType |
コネクターシェイプのタイプ。 |
beginX? |
number |
コネクターシェイプの始点の<i>x</i>位置。 |
beginY? |
number |
コネクターシェイプの始点の<i>y</i>位置。 |
endX? |
number |
コネクターシェイプの終点の<i>x</i>位置。 |
endY? |
number |
コネクターシェイプの終点の<i>y</i>位置。 |
▸ adjustments(arrayValue?
): any
コネクターシェイプの調整値を取得または設定します。
実例
var myConnector = sheet.shapes.addConnector("myConnector", GC.Spread.Sheets.Shapes.ConnectorType.elbow, 50, 50, 200, 500);
var adjustments = myConnector.adjustments();
console.log(adjustments);
adjustments = [-0.8];
myConnector.adjustments(adjustments);
名前 | 型 | 説明 |
---|---|---|
arrayValue? |
number [] |
配列に格納された調整値。 |
any
値が設定されていない場合、シェイプの現在の調整値を返します。
▸ 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
値が設定されていない場合、シェイプの終了列に対するオフセットを返します。
▸ endConnector(connector?
): IShapeConnector
connectorShapeの終点コネクター情報を取得または設定します。
実例
var shape1 = sheet.shapes.add("myShape1", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 62 * 9, 0, 200, 200);
var shape2 = sheet.shapes.addConnector("myShape", GC.Spread.Sheets.Shapes.ConnectorType.straight, 220, 120, 300, 120);
shape2.endConnector({name: shape1.name(), index: 2});
console.log(shape2.endConnector());
名前 | 型 | 説明 |
---|---|---|
connector? |
IShapeConnector |
connectorShapeの終点コネクター情報。 |
connectorInfo - 値が設定されていない場合、connectorShapeの終了コネクタ情報を返します。 connectorShapeに終了コネクタがない場合、nullを返します。
connectorInfo.name 終了コネクタの名前。
connectorInfo.index 終了コネクタの接続ポイントインデックス。
connectorInfo.shape 終了コネクタ。
▸ 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, "red");
var myConnector = sheet.shapes.addConnector("myConnector", GC.Spread.Sheets.Shapes.ConnectorType.elbow, 50, 50, 200, 500);
myConnector.setFormula("style.line.color", "=Sheet1!B1");
myConnector.getFormula("style.line.color");//returns "=Sheet1!B1"
名前 | 型 | 説明 |
---|---|---|
path |
string |
数式の文字列を受け入れることができるパス。 「x」、 「y」、 「width」、 「height」、 |
「style.line.color」、 「style.line.lineStyle」、 「style.line.width」、 「style.line.capType」、 「style.line.joinType」、 「style.line.transparency」のいずれかに設定できます。
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
値が設定されていない場合、このシェイプが選択されているかどうかを返します。
▸ 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
値が設定されていない場合、シェイプの名前を返します。
▸ setFormula(path
, formula
): void
パスによってシェイプに数式の文字列を設定します。
実例
sheet.name("Sheet1");
sheet.setValue(0, 1, "red");
var myConnector = sheet.shapes.addConnector("myConnector", GC.Spread.Sheets.Shapes.ConnectorType.elbow, 50, 50, 200, 500);
myConnector.setFormula("style.line.color", "=Sheet1!B1");
名前 | 型 | 説明 |
---|---|---|
path |
string |
数式の文字列を受け入れることができるパス。 「x」、 「y」、 「width」、 「height」、 |
「style.line.color」、 「style.line.lineStyle」、 「style.line.width」、 「style.line.capType」、 「style.line.joinType」、 「style.line.transparency」のいずれかに設定できます。
| 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
値が設定されていない場合、シェイプの開始列に対するオフセットを返します。
▸ startConnector(connector?
): IShapeConnector
connectorShapeの始点コネクター情報を取得または設定します。
実例
var shape1 = sheet.shapes.add("myShape1", GC.Spread.Sheets.Shapes.AutoShapeType.rectangle, 62 * 9, 0, 200, 200);
var shape2 = sheet.shapes.addConnector("myShape", GC.Spread.Sheets.Shapes.ConnectorType.straight, 220, 120, 300, 120);
shape2.startConnector({name: shape1.name(), index: 2});
console.log(shape2.startConnector());
名前 | 型 | 説明 |
---|---|---|
connector? |
IShapeConnector |
connectorShapeの始点コネクター情報。 |
connectorInfo - 値が設定されていない場合、connectorShapeの開始コネクタ情報を返します。 connectorShapeに終了コネクタがない場合、nullを返します。
connectorInfo.name 開始コネクタの名前。
connectorInfo.index 開始コネクタの接続ポイントインデックス。
connectorInfo.shape 開始コネクタ。
▸ 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?
): void
| ShapeStyle
コネクターシェイプのスタイルを取得または設定します。
実例
// 次のサンプルコードは、コネクターシェイプのスタイルを設定します。
var shape = sheet.shapes.addConnector("Shape1", GC.Spread.Sheets.Shapes.ConnectorType.straight, 100, 60, 200, 160);
var oldStyle = shape.style();
oldStyle.line.color = "red";
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.line.beginArrowheadStyle = GC.Spread.Sheets.Shapes.ArrowheadStyle.triangle;
oldStyle.line.beginArrowheadWidth = GC.Spread.Sheets.Shapes.ArrowheadWidth.narrow;
oldStyle.line.beginArrowheadLength = GC.Spread.Sheets.Shapes.ArrowheadLength.short;
oldStyle.line.endArrowheadStyle = GC.Spread.Sheets.Shapes.ArrowheadStyle.diamond;
oldStyle.line.endArrowheadWidth = GC.Spread.Sheets.Shapes.ArrowheadWidth.wide;
oldStyle.line.endArrowheadLength = GC.Spread.Sheets.Shapes.ArrowheadLength.long;
shape.style(oldStyle);
名前 | 型 | 説明 |
---|---|---|
value? |
ShapeStyle |
コネクターシェイプのスタイルを設定します。 |
void
| ShapeStyle
値が設定されていない場合、コネクターシェイプの現在のスタイルを返します。
▸ toImageSrc(): string
Base64 文字列タイプのシェイプ画像の src を取得します。
実例
let shapeImageSrc = sheet.shapes.all()[0].toImageSrc();
string
シェイプ画像の Base64 src 文字列を返します。
▸ type(): ConnectorType
connectorShapeのコネクタータイプを取得します。
実例
var shape = sheet.shapes.addConnector("myShape", GC.Spread.Sheets.Shapes.ConnectorType.straight, 220, 120, 300, 120);
var shapeName = shape.type();
シェイプのコネクタータイプを返します。
▸ 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
値が設定されていない場合、シェイプの垂直位置を返します。