CStatusBarCtrl::GetText

Artigo
08/25/2010

Recupera o texto de determinada parte de um BAR de status controle.

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

Parâmetros

lpszText
Endereço do buffer que receberá o texto.Este parâmetro é uma seqüência de caracteres terminada com caractere nulo.
nPane
Índice baseado em zero da parte da qual recuperar texto.
pType
Ponteiro para um número inteiro que recebe as informações de tipo.O tipo pode ser um destes valores:
- 0 O texto é desenhado com uma borda apareça inferior do plano do BAR de status.
- SBT_NOBORDERS O texto é desenhado sem bordas.
- SBT_POPOUT O texto é desenhado com uma borda apareça maior do que o plano da BAR de status.
- SBT_OWNERDRAW Se o texto tem o SBT_OWNERDRAW tipo de desenho pType recebe esta mensagem e retorna o valor de 32 bit associado com o texto em vez do tipo de comprimento e a operação.

Valor de retorno

O comprimento, em caracteres do texto ou um CString contendo o texto corrente.

Exemplo

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;