CStatusBarCtrl::SetText

更新 : 2007 年 11 月

ステータス バー コントロールの指定区画にテキストを設定します。

BOOL SetText(
   LPCTSTR lpszText,
   int nPane,
   int nType 
);

パラメータ

  • lpszText
    設定するテキストを指定する NULL で終わる文字列のアドレス。nType が SBT_OWNERDRAW のときは、lpszText は 32 ビットのデータを表します。

  • nPane
    設定される区画の 0 から始まるインデックス。この値に 255 を指定すると、ステータス バー コントロールは 1 つだけの区画からなる単純なコントロールであると見なします。

  • nType
    描画操作の型。次のいずれかの値を使用できます。

    • 0   テキストは、ステータス バーの面よりもくぼんだ境界線と共に描画されます。

    • SBT_NOBORDERS   テキストは境界線なしで描画されます。

    • SBT_OWNERDRAW    テキストは親ウィンドウが描画します。

    • SBT_POPOUT   テキストは、ステータス バーの面よりも浮き出した境界線と共に描画されます。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

このメッセージは、コントロール内の変更された部分を無効にします。これにより、コントロールが次に WM_PAINT メッセージを受け取ったときに、新しいテキストが表示されます。

使用例

VERIFY(m_wndSBC.SetText(_T("Text For Pane 1"), 1, 0));

必要条件

ヘッダー : afxcmn.h

参照

参照

CStatusBarCtrl クラス

階層図

CStatusBarCtrl::GetText

CStatusBarCtrl::GetTextLength

その他の技術情報

CStatusBarCtrl のメンバ