CStatusBarCtrl::GetText

Article
03/04/2013

Extrait le texte de la partie donnée d'un contrôle de barre d'état.

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

Paramètres

lpszText
Adresse de la mémoire tampon qui accepte du texte.Ce paramètre est une chaîne terminée par le caractère NULL.
nPane
Index de base zéro de la partie de laquelle récupérer du texte.
pType
Pointeur vers un entier qui accepte les informations de type.Le type peut être l'une de ces valeurs :
- 0 Le texte est dessiné avec une bordure apparaisse plus petit que le plan de la barre d'état.
- SBT_NOBORDERS le texte est dessiné sans zones.
- SBT_POPOUT le texte est dessiné avec une bordure pour afficher plus élevé que le plan de la barre d'état.
- SBT_OWNERDRAW si le texte est le type de dessin d' SBT_OWNERDRAW , pType accepte le message et retourne la valeur 32 bits associée au texte au lieu de la longueur et le type d'exécution.

Valeur de retour

La longueur, en caractères, du texte ou de CString contenant le texte actuel.

Exemple

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;