CStatusBarCtrl::GetText

發行項
02/28/2013

從狀態列控制項的指定區段擷取文字。

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

參數

lpszText
接收文字緩衝區的位址。這個參數是以 null 結尾的字串。
nPane
擷取的文字區段以零起始的索引。
pType
out 接收型別資訊之整數的指標。這個型別可以是下列其中一個值:
- 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;