グラフィックオブジェクト

Graphic-objs

グラフィックオブジェクトはOriginの子ウィンドウにあり、Originのユーザによって作成されます。これらのオブジェクトはラベル、矢印、線及びその他ユーザーによって作成されたグラフィックエレメントを含みます。これらのオブジェクトはオブジェクトプロパティダイアログのプログラミングタブで定義されたそれらの名前を使ってスクリプトからアクセスできます。Origin2017より前のバージョンでは、プログラミングコントロールダイアログボックスと呼ばれていました。

このダイアログボックスを開くには、これらの方法があります。

• オブジェクトをクリックして選択し、メニューからフォーマット：オブジェクトプロパティを選択します。Origin2017より前のバージョンでは、フォーマット：プログラミングコントロールです。
• オブジェクト上で右クリックして、プロパティを選択します。その後、プログラミングタブに移動します。Origin2017より前のバージョンでは、プログラミングコントロールというコンテキストメニューがあります。
• オブジェクトをAlt+ダブルクリックします。

ダイアログボックスのプログラミングタブのテキストボックスにスクリプトを入力すると、これらのラベルにスクリプトを添付できます。このスクリプトの実行トリガーは～のあとでスクリプトを実行のあとでスクリプトを実行ドロップダウンから設定できます。

一般的には、LabTalkスクリプトからアクセスできるのは名前のついたオブジェクトのみです。ただし、名前のないオブジェクトでもこの後書くようにthis.表記を使えばダイアログのプログラミングタブからスクリプトでアクセスすることができます。

GObject 変数型

GObjectはレイヤにあるグラフィックオブジェクトのLabTalk変数型です。削除する場合はLabel -r objectNameを使うことができます。

一般的なシンタックスは：

GObject name = [GraphPageName]LayerName!ObjectName; // ページ名、レイヤ名、オブジェクト名を使用

GObject name = [GraphPageName]LayerIndex!ObjectName; // ページ名、レイヤ番号、オブジェクト名を使用

GObject name = LayerName!ObjectName; // ページをアクティブにしてレイヤ名、オブジェクト名を使用

GObject name = LayerIndex!ObjectName; // ページをアクティブにしてレイヤ番号、オブジェクト名を使用

GObject name = ObjectName; // ページ、レイヤをアクティブにしてオブジェクト名を使用

既存のオブジェクトとまだ作成されていないオブジェクトの両方に対して GObject 変数を宣言できます。

例えば、

//ここではGObjectを宣言してそのグラフィックオブジェクトを作成します
win -t plot;          // グラフウィンドウを作成

// ‘line1’に接続された myLine という名前の GObject を宣言
GObject myLine = line1; 
//ここでオブジェクトを作成します（リストoには'line1'が表示されます）
draw -n myLine -lm {1,2,3,4}; 
win -t plot;          // 新しいグラフウィンドウを作成

// myLineがアクティブでない異なるグラフにあったとしても、
// GObject名を使ってまだそれを制御することができます
myLine.X += 2; // Move the line

label -r myLine; //オブジェクトを削除

//　多くの場合、グラフィック オブジェクトは既に存在します 
GObject leg = legend; // 凡例オブジェクトに紐づける
leg.fsize = 28; // フォントサイズを28に設定
leg.color = color(blue); // テキストの色を青に
leg.background = 0; // 周囲のボックスをオフにする

Note：元のグラフをアクティブにしたlist o には、物理的なオブジェクト名であるline1が表示されますが、プログラミングの構成要素であるmyLineは表示されません。

プロパティ

これらのオブジェクトの一般的なプロパティを以下に示します。すべてのプロパティがすべてのオブジェクトに適用されるわけではありません。例えば、テキストプロパティは線オブジェクトには適用されません。

構文

[winName!]objName.property = value;

または

this.property = value;

• WinName! はグラフィックオブジェクトがアクティブでないページにある場合に必要です。これは名前付きオブジェクトが存在するウィンドウを指定します。オブジェクトが存在するレイヤは、そのページのアクティブなレイヤである必要があります。宣言したGObjectを使う場合、WinNameは必要ありません。

• objNameはオブジェクトプロパティダイアログボックスにあるオブジェクトの名前のテキストボックスに表示されているオブジェクトの名前か、もしくは宣言したGObject変数の名前です。

• Propertyは利用できるobjNameプロパティの1つです。

objectName.=を実行するとほぼすべてのオブジェクトのプロパティを見ることができます。

一般的なプロパティ

サンプル

• レイヤの左上に凡例を配置する

legend.background = 1;
legend.y = layer1.y.to - legend.dy / 2;
legend.x = layer1.x.from + legend.dx / 2;

• circle1という名前の円オブジェクトの色を変更する

// まず最初にグラフ上に円オブジェクトを作成します
// 次にそれを下記2行のスクリプトで”circle1”という名前に変更します
circle1.color = 1; // 黒の境界線
circle1.fillcolor = color(yellow); // 黄色で塗りつぶし

• フローティンググラフオブジェクトのソースグラフ名を取得します。これは、フローティンググラフオブジェクトの名前が "bmp "で、アクティブなワークシートにあることを想定しています。

// bmp.type$ は ”Embedded Graph: [GraphName]”　を返します
// GraphName はソースグラフの実際の名前です
// 次のスクリプトは bmp.type$ からGraphNameを取りだすときに使います。 
%A = %[%(bmp.type$), >18];
ty %[%A, %[%A]];// GraphNameの値が出力されます

Note: 部分文字列の表記は GraphNameを取り出す際に使います。

• オブジェクト "ポリライン "のxy座標をワークシートにコピーする。

polyline.getXY([Book1]1!A, [Book1]1!B);

• ワークシートのXY列の座標を使用してオブジェクト "Rect1 "を配置します。

draw -n Rect1 -b; // Rect1オブジェクトを描きます
Rect1.setXY(Book1_A, Book1_B); // Book1_A(X),Book1_B(Y)に座標を代入します

• イメージを切り取る

win -t plot;
string strInitPath$=system.path.program$+"Samples\Image Processing and Analysis";
dlgfile g:="*.jpg" m:=1 init:=strInitPath$;
int nn=fname.GetNumTokens(CRLF);
int cleft=50, ctop=30, cright=150, cbottom=130;
for(int ii = 1; ii <= nn; ii++) {
	string strf$ = fname.GetToken(ii, CRLF)$;
	string strGr$;
	insertImg2g fname:= strf$ type:=IMG xyp:=page oname:=strGr$;
	GObject gr = strGr$;
	gr.Crop$="$(cleft) $(ctop) $(cright) $(cbottom)"; //切り取り
	int nx = ii*page.width/5;
	int ny = 1000;
	gr.PageRect$="$(nx) $(ny) $(nx+600) $(ny + 600)";
}

選択したオブジェクトプロパティ

選択したグラフィックオブジェクトの基本的な特性を、構文を使って制御することができます。

s.property = value;

下記リストが利用可能なプロパティです。

プロパティ

例えば下記のように使えます。

s.size = 50;

これを使用してテキストオブジェクトが選択された場合のサイズを制御します。.

メソッド

これらのオブジェクトの一般的なメソッドを以下に示します。すべてのメソッドがすべてのオブジェクトに適用されるわけではありません。例えば、addtextメソッドは線オブジェクトには適用されません。

構文

[winName!]objName.Method(arguments)

または

this.Method(argument)

• WinName! はグラフィックオブジェクトがアクティブでないページにある場合に必要です。これは名前付きオブジェクトが存在するウィンドウを指定します。オブジェクトが存在するレイヤは、そのページのアクティブなレイヤである必要があります。宣言したGObjectを使う場合、WinNameは必要ありません。

• objNameはプログラミング制御ダイアログボックスにあるオブジェクトの名前のテキストボックスに表示されているオブジェクトの名前か、もしくは宣言したGObject変数の名前です。

• Methodは利用できるobjNameプロパティの1つです。

• 引数はメソッド固有です。

objectName.=を実行するとほぼすべてのオブジェクトのメソッドを見ることができます。

一般的なメソッド

サンプル

• テキスト追加.

// 文字列変数の宣言と値の代入
string stringVariable$ = " (modified)";
// 文字列レジスタ（A）に値を代入
// 新しい行がどのように値に含まれているかに注意してください
%A = "
Final";
//  既存の'text'という名前のオブジェクトに様々なテキストを追加
text.addtext("%(stringVariable$)");
text.addtext("%(CRLF)Data passes all tests");
text.addtext(A); // 文字列レジスタに引用符や%は不要です
// そして強制的にリフレッシュします
text.draw();

Note：%(CRLF)は、宣言文字列またはリテラル文字列にDOS改行（キャリッジリターン、ラインフィード）を追加する置換記法です。

• オブジェクトのn番目のホットスポットをクリックすることをシミュレートします。UIMオブジェクトの特徴として、複数のホットスポットがあります。

object.click(n);

• オブジェクトを再描画します。Option = local でホットスポットを再描画します。Option = global で全オブジェクトを再描画します。

object.draw(option);

• objectのスクリプトを実行します。

object.run();

• イメージを切り出します。

string strInitPath$=system.path.program$+"Samples\Image Processing and Analysis";
dlgfile g:="*.jpg" m:=1 init:=strInitPath$;
int nn=fname.GetNumTokens(CRLF);
int cleft=50, ctop=30, cright=150, cbottom=130;
for(int ii = 1; ii <= nn; ii++) {
	string strf$ = fname.GetToken(ii, CRLF)$;
	string strGr$;
	insertImg2g fname:= strf$ type:=IMG xyp:=page oname:=strGr$;
	GObject gr = strGr$;
	if(gr.Crop($(cleft) $(ctop) $(cright) $(cbottom)) == 0) {
		int nx = ii*page.width/5;
		int ny = 1000;
		gr.PageRect$="$(nx) $(ny) $(nx+600) $(ny + 600)";
	}
}

接続メソッド

グラフィックオブジェクトは、接続メソッドを使用して接続することができ、接続の動作を制御するさまざまなオプションとオプションの接続線が表示されます。

なお、Origin 2022bでは、ターゲットテキストオブジェクトとソース描画オブジェクトを接続するための”相対位置”メソッドが追加されました。このメソッドは、以前の”接続”メソッドに追加されるものですが、”相対位置”には、dwRigid（>= 17）、nTargetRefPt（= 0）、nSourceRefPt（>= 26）の特定の値が必要となることに注意してください。URPC=1（デフォルト）の場合、GUIオブジェクトの距離計測とアスタリスクブラケット（プロット操作・オブジェクト作成ツールバー）がこのメソッドで追加されます。

構文

sourceObject.Connect(targetObject, bVisible, dwRigid, nTargetRefPt, nSourceRefPt)

• sourceObjectには、オブジェクト名またはGObject変数を指定することができます。
• sourceObject.Connect(targetObject) は、コネクタの UID を返します。

パラメータ

サンプル

// GObject 変数を使用
// 2つのレイヤを持つグラフをアクティブに
// それぞれのレイヤに同じ名前のテキストオブジェクトがあります
GObject aa = [Graph1]1!text;
GObject bb = [Graph1]2!text;
bb.Connect(aa,1);

// オブジェクト名を使用
// グラフ上で"myTextLabel"という名前のテキストオブジェクトを作成
// さらに "myLine"という名前の線オブジェクトを作成
myTextLabel.Connect(myLine,0);

// GObject 変数と オブジェクト名を使用
// グラフのレイヤ1で "myTextLabel"という名前のテキストオブジェクトを作成
// さらに "myLine"という名前の線オブジェクトを作成
GObject aa = [Graph1]1!myTextLabel;
aa.Connect(myLine,0);

// レイヤ1に線プロットを作成、グラフをアクティブにし、
//テキストオブジェクトを追加 
GObject aa = 1!text;
range rr = 1!1;
aa.Connect(rr,1,1,3);

// 相対位置メソッド
// rect "と "text "という2つのオブジェクトがあるとして
// テキストを矩形の左下隅に貼り付ける
rect.connect(text, 0, 17, 0, 26);

GetConnected メソッド

1つのグラフィックオブジェクトは、その接続されたすべてのグラフィックオブジェクトをこのメソッドで取得することができます。

label コマンドも参照してください。

構文

graphicObject.GetConnected(stringArray, option=0)

• graphicObjectには、オブジェクト名またはGObject変数を指定することができます。

戻り値

接続されているグラフィックオブジェクトの数を返します。接続されたグラフィックオブジェクトがない場合は、0を返します。

パラメータ

例

// GObject 変数を使用
GObject go = [Graph1]1!text;
StringArray sa; 
numObjs = go.GetConnected(sa);

// 再帰的にオブジェクト名を使用
StringArray sa;
numObjs = myLine.GetConnected(sa, 1);

// 接続されたグラフィックオブジェクトの名前を取得する
StringArray sa;
numObjs = myLine.GetConnected(sa,1);
if(numObjs>0)  //接続されたオブジェクトがある場合
{
	for(int iObj=1; iObj<=numObjs; iObj++)  //接続されたオブジェクト名を出力
	{
		string str$ = sa.GetAt(iObj)$;  // 名前を取得
		type %(str$);  // 型名
	}
}

一般的なサンプル

• Graph2ウィンドウのArrowオブジェクトの水平方向の移動を無効にするスクリプトです。

Graph2!Arrow.hmove = 0;

• スクリプトウィンドウに入力すると、次のスクリプトは、Buttonオブジェクトの中心のX、Y座標をスクリプトウィンドウに出力します。

Button.x =;
Button.y =;

• 次のスクリプトは、Graph1ウィンドウのModeというオブジェクトに関連付けられたスクリプトを実行します。

Graph1!mode.run();

• 最後のスクリプトは、draw()メソッドを使って、Data2ウィンドウにWksDataオブジェクトを再描画しています。

Data2!WksData.draw(global);