[]
Forguncy.ContainerCellBase
コンテナーセルの基本クラス。
↳ ContainerCellBase
• new ContainerCellBase()
▸ bind(type
, data?
, fn?
): void
セルが持つイベントに対してイベントハンドラを関連付けます。
Example
// 本サンプルコードでは、ボタンをクリックした際にダイアログボックスを表示する例を示します。
// イベントハンドラーにデータを受け渡さない場合:
Forguncy.Page.getCell("button1").bind("click", function () {
alert("Click!");
});
// イベントハンドラーにデータを受け渡す場合:
var text = "Click!";
Forguncy.Page.getCell("button1").bind("click", text, function (arg) {
alert(arg.data);
});
名前 | 型 | 説明 |
---|---|---|
type |
string |
関連付けするイベントを表す文字列。セルでサポートされているイベントについては、CellEventsクラスを参照してください。 |
data? |
any |
イベントハンドラーに渡すデータ。関数では第1パラメーターのdataプロパティから参照します。省略可能。 |
fn? |
Function |
イベント発生時に実行される関数。 |
void
▸ disable(): void
セルのユーザーとの対話を無効化します。
Example
// 本サンプルコードでは、disableメソッドを使用してチェックボックス型セルを無効化する例を示します。
// 現在のページを取得する。
var page = Forguncy.Page;
// 現在のページでcheckBoxという名前のチェックボックス型セルを取得する。
var cell = page.getCell("checkBox");
// チェックボックス型セルを無効化する。
cell.disable();
void
▸ enable(): void
セルのユーザーとの対話を有効化します。
Example
// 本サンプルコードでは、「checkBox1」チェックボックスをクリックして、「button1」ボタンの無効と有効を切り替える例を示します。
// 現在のページを取得する。
var p = Forguncy.Page;
p.ready(function () {
// 現在のページでbutton1という名前のボタン型セルを取得する。
var b = p.getCell("button1");
// 現在のページでcheckbox1という名前のチェックボックス型セルを取得する。
var c = p.getCell("checkbox1");
b.disable();
c.bind("valuechanged", function () {
if (c.getValue() == true)
{
// ボタン型セルを有効化する。
b.enable();
}
else
{
// ボタン型セルを無効化する。
b.disable();
}
})
});
void
▸ getValue(): any
セルの値を取得します。
Example
// 本サンプルコードでは、getValueメソッドで取得したセルの値をダイアログボックス上に表示します。
// 現在のページを取得する。
var page = Forguncy.Page;
// 現在のページでmyCellという名前のセルを取得する。
var cell = page.getCell("myCell");
// getValueメソッドでセルの値を取得する。
var cellValue = cell.getValue();
// ダイアログボックスを表示して取得したセルの値を表示する。
alert(cellValue);
any
▸ hasFocus(): boolean
セルにフォーカスがあるかどうかを取得します。戻り値がtrueの場合、セルはフォーカスを取得しています。falseの場合、セルはフォーカスを取得していません。
Example
// 本サンプルコードでは、hasFocusメソッドを使用して「myCell」セルがフォーカスを取得しているかどうかをダイアログボックスに表示する例を示します。
// 現在のページを取得する。
var p = Forguncy.Page;
// 現在のページでmyCellという名前のセルを取得する。
var cell = page.getCell("myCell");
// セルにフォーカスがあるかどうかを取得する。
var f = cell.hasFocus();
// セルにフォーカスがあるかどうかを示す値をダイアログボックスに表示する。
alert(f);
boolean
▸ hide(): void
セルを非表示にします。非表示にできるのはセルの背景ではなく、セルの値、もしくはセル型のみです。
Example
// 本サンプルコードでは、指定したセルをhideメソッドを使用して非表示にする例を示します。
// 現在のページを取得する。
var page = Forguncy.Page;
// 現在のページでmyCellという名前のセルを取得する。
var cell = page.getCell("myCell");
// myCellという名前のセルを非表示にする。
cell.hide();
void
▸ setBackColor(color
): void
セルの背景色を設定します。
Example
// 本サンプルコードでは、setBackColorメソッドを使用して指定したセルの背景色を設定する例を示します。
// 現在のページを取得する。
var page = Forguncy.Page;
// 現在のページでmyCellという名前のセルを取得する。
var cell = page.getCell("myCell");
// セルの背景色を設定する。
var setColor = cell.setBackColor("red");
名前 | 型 | 説明 |
---|---|---|
color |
any |
設定する背景色の色。設定する値は、次の3つの形式をサポートしています。
|
void
▸ setFocus(): void
セルがフォーカスを取得できる場合、セルにフォーカスを設定します。
Example
// 本サンプルコードでは、setFocusメソッドを使用して「myCell」セルにフォーカスを設定する例を示します。
// 現在のページを取得する。
var p = Forguncy.Page;
// 現在のページでmyCellという名前のセルを取得する。
var cell = page.getCell("myCell");
// 取得したセルにフォーカスを設定する。
cell.setFocus();
void
▸ setForeColor(color
): void
セルのフォントの色を設定します。
Example
// 本サンプルコードでは、setForeColorメソッドを使用して指定したセルのフォントの色を設定する例を示します。
// 現在のページを取得する。
var page = Forguncy.Page;
// 現在のページでmyCellという名前のセルを取得する。
var cell = page.getCell("myCell");
// セルのフォントの色を設定する。
var setColor = cell.setForeColor("red");
名前 | 型 | 説明 |
---|---|---|
color |
any |
設定するフォントの色。設定する値は、次の3つの形式をサポートしています。
|
void
▸ setReadOnly(isReadOnly
): any
セルの読み取り専用の状態を設定します。
Example
// 本サンプルコードでは、「checkBox1」チェックボックスをクリックして、「textbox1」テキストボックスの読み取り専用の状態を切り替える例を示します。
// 現在のページを取得する。
var p = Forguncy.Page;
p.ready(function () {
// 現在のページでtextbox1という名前のテキストボックス型セルを取得する。
var t = p.getCell("textbox1");
// 現在のページでcheckbox1という名前のチェックボックス型セルを取得する。
var c = p.getCell("checkbox1");
c.bind("valuechanged", function () {
if (c.getValue() == true)
{
// テキストボックス型セルを読み取り専用に設定する。
t.setReadOnly(true);
}
else
{
// テキストボックス型セルの読み取り専用を解除する。
t.setReadOnly(false);
}
})
});
名前 | 型 | 説明 |
---|---|---|
isReadOnly |
boolean |
読み取り専用に設定する場合にはtrue、そうでない場合にはfalse。 |
any
▸ setValue(value
): void
セルに値を設定します。本メソッドは、添付ファイル型セル、画像アップロード型セル、ログインユーザー型セルでは使用できません。
Example
// 本サンプルコードでは、ボタンをクリックしてテキストボックスに値を設定する例を示します。
// 現在のページを取得する。
var p = Forguncy.Page;
p.ready(function(){
p.getCell("button1").bind("click", function(){
// 現在のページでtextBox1という名前のセルを取得する。
var textCell = p.getCell("textBox1");
// セルに指定した値を設定する。
textCell.setValue("Forguncy");
})
});
名前 | 型 | 説明 |
---|---|---|
value |
any |
設定するセルの値。 |
void
▸ show(): void
非表示となっているセルを表示します。セルを非表示状態とするには、hideメソッドを使用します。
Example
// 本サンプルコードでは、指定したセルをshowメソッドを使用して表示する例を示します。
// 現在のページを取得する。
var page = Forguncy.Page;
// 現在のページでbuttonという名前のセルを取得する。
var cell = page.getCell("button");
// buttonという名前のセルを表示する。
var cellShow = cell.show();
void
▸ unbind(type
, fn?
): void
指定したイベントにおけるイベントハンドラーの関連付けを解除します。
Example
// ボタンのclickイベントにイベントハンドラーを関連付ける。
var onClick = function(arg) {
alert("Click!");
}
var clickEvent = Forguncy.CellEvents.Click;
var button1 = Forguncy.Page.getCell("button1");
button1.bind("click", onClick);
// イベントの種類とイベントハンドラーの両方を指定して関連付けを解除する。
button1.unbind("click", onClick);
// イベントの種類のみを指定してすべてのイベントハンドラーの関連付けを解除する。
button1.unbind("click");
名前 | 型 | 説明 |
---|---|---|
type |
any |
関連付けを解除するイベントの種類を表す文字列。セルでサポートされるイベントについては、CellEventsクラスを参照してください。 |
fn? |
Function |
関連付けを解除するイベントハンドラー。省略した場合、そのセルにおいて指定したイベントの種類に関連付けられているすべてのイベントハンドラーが解除されます。 |
void
▸ unbindAll(): void
セルからすべてのイベントハンドラーの関連付けを解除します。
Example
// 本サンプルコードでは、unbindAllメソッドを使用してセルに関連付けられているすべてのイベントハンドラーを解除する例を示します。
// イベントハンドラーの定義。
var onClick = function(arg) {
alert("Forguncy");
}
// 現在のページを取得する。
var page = Forguncy.Page;
// 現在のページでbuttonという名前のボタン型セルを取得する。
var cell = page.getCell("button");
// ボタン型セルに関連付けられているすべてのイベントハンドラーを解除する
cell.unbindAll();
void