メンバ一覧 StartInOutPresentation 前のメソッド 次のメソッド

VB C# ALL プログラミング言語によるフィルタ (ここで選んだ言語で選別された説明や図だけが表示されます)

StartInOutPresentation メソッド

機能および役割

各項目の背景色をそれぞれの項目の入出 (InOut) の指定に対応したものになるように設定する。すなわち、表示項目、必須入力項目、任意入力項目という 3 種類に分類した色分けをすることができる。

ボディ部および拡張ボディ部については、その項目が属する明細行が奇数行目か偶数行目かに従った色分けをすることもできる。

所属クラス (ツーピーススタイルの場合にこのメソッドが宣言されているクラス)

AppliTech.WorkFrame.FormBase (ローカル)

呼出し方

fB.StartInOutPresentation(表示項目用の背景色1, 必須入力項目用の背景色1, 任意入力項目用の背景色1, 表示項目用の背景色2, 必須入力項目用の背景色2, 任意入力項目用の背景色2)

(ただし fB は、クラス FormBase のインスタンス)

戻り値の型および意味

(戻り値なし)

パラメタの型および意味

表示項目用の背景色1 (System.Drawing.Color): この色が表示項目の背景色として使われる (注 1)。

必須入力項目用の背景色1 (System.Drawing.Color): この色が必須入力項目の背景色として使われる (注 1)。

任意入力項目用の背景色1 (System.Drawing.Color): この色が任意入力項目の背景色として使われる (注 1)。

表示項目用の背景色2 (System.Drawing.Color): この色が表示項目の背景色として使われる (注 2)。

必須入力項目用の背景色2 (System.Drawing.Color): この色が必須入力項目の背景色として使われる (注 2)。

任意入力項目用の背景色2 (System.Drawing.Color): この色が任意入力項目の背景色として使われる (注 2)。

(注 1): 背景色1 (表示項目用の背景色1、必須入力項目用の背景色1、任意入力項目用の背景色1) が使われるのは、ヘッド部の項目、テール部の項目、ボディ部の奇数行目 (先頭行など) の項目、拡張ボディ部の奇数行目 (先頭行など) の項目である。

(注 2): 背景色2 (表示項目用の背景色2、必須入力項目用の背景色2、任意入力項目用の背景色2) が使われるのは、ボディ部の偶数行目の項目、拡張ボディ部の偶数行目の項目である。

例外の発生 (誤った呼出しの際に発生する例外)

「現 FormBase でないので使用できません (StartInOutPresentation)」

「BeginPrg フックメソッドの中からしか呼び出せません (StartInOutPresentation)」

使用上のヒントと注意事項

このメソッドを呼び出せるのは、フックメソッド BeginPrg の中 (またはその延長線上) だけに限られている。

このメソッドを呼び出さない限り、従来の項目色システムの動作に何の変化もない。

このメソッドを呼び出した後にも、従来の項目色システムを使うことができるが若干の違いが生じる。すなわち、パレット番号 0 の背景色としては、このメソッドで指定した色が使われるようになる。パレット番号 0 以外の背景色は、これまでと同じである。また、文字色は、これまでと同じである。

フックメソッド Skip によって入力の可否を制御している項目については、入力の可否に従った背景色にすることはできない。入力の可否に従った背景色にするには、総括表の入出欄に指定するか、またはメソッド InOutModeItemInOutModeMInOutModeN によって入力の可否を指定することが必要である。

もしも、メソッド SetCLs によって奇数明細行・偶数明細行の色指定をしているプログラムがあれば、このメソッドを用いることによって、すっきりした見やすいプログラムにすることができる。 すなわち、従来の奇数行・偶数行の色指定をしているプログラムを取り除き、このメソッドを呼び出すようにすればよい。

関連事項

画面の表情を豊かにするために新設されたメソッドには、 StartBrightCaptionStartFadeinFadeoutStartInOutPresentation (本メソッド) の三つがある。

使用例

Friend Function BeginPrg(ByVal fB As FormBase) As Boolean
    ' 背景色を各項目の入出 (InOut) の指定に対応したものに設定します。
    fB.StartInOutPresentation(Color.LightGray, _
                              Color.White, _
                              Color.WhiteSmoke, _
                              Color.LightBlue, _
                              Color.AliceBlue, _
                              Color.LightCyan)
    Return FormBase.BEGINPRG_Allow
End Function
internal bool BeginPrg( FormBase fB ) {
    // 背景色を各項目の入出 (InOut) の指定に対応したものに設定します。
    fB.StartInOutPresentation(Color.LightGray,
                            Color.White,
                            Color.WhiteSmoke,
                            Color.LightBlue,
                            Color.AliceBlue,
                            Color.LightCyan);
    return FormBase.BEGINPRG_Allow;
}
boolean BeginPrg( FormBase fB ) {
    // 背景色を各項目の入出 (InOut) の指定に対応したものに設定します。
    fB.StartInOutPresentation(new Color(211, 211, 211),
                              Color.white,
                              new Color(245, 245, 245),
                              new Color(173, 216, 230),
                              new Color(240, 248, 255),
                              new Color(224, 255, 255));
    return FormBase.BEGINPRG_Allow;
}