CStatusBarCtrl::GetText

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ステータスバーコントロールの指定区画からテキストを取得します。

CString GetText(
   int nPane,
   int* pType = NULL
) const;
int GetText(
   LPCTSTR lpszText,
   int nPane,
   int* pType = NULL 
) const;

パラメータ

lpszText
テキストを受け取るバッファのアドレス。文字列は NULL で終わります。
nPane
テキストを取得する区画の 0 から始まるインデックス。
pType
型情報を受け取る整数へのポインタ。型は次の値のいずれかです。
- 0 テキストは、ステータスバーの面よりもくぼんだ境界線と共に描画されます。
- SBT_NOBORDERS テキストは境界線なしで描画されます。
- SBT_POPOUT テキストは、ステータスバーの面よりも浮き出した境界線と共に描画されます。
- SBT_OWNERDRAW テキストの描画種別が SBT_OWNERDRAW の場合は、pType はこのメッセージを受け取り、テキストに関連付けられている 32 ビット値を返します。長さと操作種別は返しません。

戻り値

テキストまたは現在のテキストを保持する CString の長さを文字数で返します。

使用例

int nType;
TCHAR* pszPaneOneText;

pszPaneOneText = new TCHAR[ m_wndSBC.GetTextLength(1, &nType) + 1 ];
int nTextLength = m_wndSBC.GetText(pszPaneOneText, 1, &nType);

switch(nType)
{
   case 0:
      // Text is drawn with a border to appear lower than the 
      // plane of the status bar
      break;
   case SBT_NOBORDERS:
      // text is drawn without borders
      break;
   case SBT_OWNERDRAW:
      // Text is drawn by the parent window
      break;
   case SBT_POPOUT:
      // Text is drawn with a border to appear higher than the 
      // plane of the status bar
      break;
}   

delete pszPaneOneText;