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

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

StartBrightCaption メソッド

◇ 機能および役割

ボディ部または拡張ボディ部の中の項目について、フォーカスされた項目の見出し欄 (Caption) の背景色を指定の色にする処理 (見出し欄ブライト処理) を開始する。

見出し欄としては、この画面上に見出しラベル (Label, Panel, PanelSS) または見出しボタン (Button, ButtonSS) を配置しておき、見出しラベルの場合には Lb_項目略称 というコントロール名に、見出しボタンの場合には Cs_項目略称 というコントロール名にしておくという事前準備作業が必要である。

見出し欄としては、この画面上に見出しラベル (JLabel, JPanel) または見出しボタン (JButton) を配置しておき、見出しラベルの場合には Lb_項目略称 というコントロール名に、見出しボタンの場合には Cs_項目略称 というコントロール名にしておくという事前準備作業が必要である。

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

AppliTech.WorkFrame.FormBase (ローカル)

◇ 呼出し方

fB.StartBrightCaption(非ブライト状態のラベルの背景色, ブライト状態のラベルの背景色, 非ブライト状態のボタンの背景色, ブライト状態のボタンの背景色)

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

◇ 戻り値の型および意味

(戻り値なし)

◇ パラメタの型および意味

非ブライト状態のラベルの背景色 (System.Drawing.Color): この色がフォーカスの外れた項目の見出しラベルの背景色として使われる。

ブライト状態のラベルの背景色 (System.Drawing.Color): この色がフォーカスされた項目の見出しラベルの背景色として使われる。

非ブライト状態のボタンの背景色 (System.Drawing.Color): この色がフォーカスの外れた項目の見出しボタンの背景色として使われる。

ブライト状態のボタンの背景色 (System.Drawing.Color): この色がフォーカスされた項目の見出しボタンの背景色として使われる。

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

｢現 FormBase でないので使用できません (StartBrightCaption)｣

｢BeginPrg フックメソッドの中からしか呼び出せません (StartBrightCaption)｣

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

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

画面オプション「ブライト処理」がオンでないと、このメソッドの機能は発揮されない。

パラメタとして指定した非ブライト状態のラベルの背景色とブライト状態のラベルの背景色が同じ色の場合には、見出しラベルに関するブライト処置はなされない。

パラメタとして指定した非ブライト状態のボタンの背景色とブライト状態のボタンの背景色が同じ色の場合には、見出しボタンに関するブライト処置はなされない。

ボディ部または拡張ボディ部の中のフォーカスされた項目の見出しラベルが存在しないとき、あるいは存在してもプロパティ Enabled または Visible が False の場合には、見出しラベルに関するブライト処置はなされない。

ボディ部または拡張ボディ部の中のフォーカスされた項目の見出しボタンが存在しないとき、あるいは存在してもプロパティ Enabled または Visible が False の場合には、見出しボタンに関するブライト処置はなされない。

複数の項目に対応する見出しラベル (たとえば、コード合成ツールの項目長という見出しラベル) については、各項目に対応する見出しラベルを同じサイズにして画面の同じ位置に配置して、各見出しラベルにそれぞれの項目に対応するコントロール名をつけることによって、妥当な表示にすることができる。

このメソッドで開始した標準の見出し欄ブライト処理でなされる表示以外のことをしたい場合には、BrightOnOff を用いればよい。

◇ 関連事項

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

このメソッドで開始した見出し欄ブライト処理に関する補助をする画面フックメソッドとして、BrightOnOff がある。

◇ 使用例

Friend Function BeginPrg(ByVal fB As FormBase) As Boolean
    ' 見出し欄に関するブライト処理の設定をします。
    fB.StartBrightCaption(Color.Khaki, _
                          Color.Gold, _
                          Color.LightYellow, _
                          Color.Gold)
    Return FormBase.BEGINPRG_Allow
End Function

internal bool BeginPrg( FormBase fB ) {
    // 見出し欄に関するブライト処理の設定をします。
    fB.StartBrightCaption(Color.LightGray,
                            Color.Gold,
                            Color.LightYellow,
                            Color.Gold);
    return FormBase.BEGINPRG_Allow;
}

boolean BeginPrg( FormBase fB ) {
    // 見出し欄に関するブライト処理の設定をします。
    fB.StartBrightCaption(new Color(211, 211, 211),
                            new Color(255, 215, 0),
                            new Color(255, 255, 224),
                            new Color(255, 215, 0));
    return FormBase.BEGINPRG_Allow;
}