CStatusBarCtrl::GetText

Artikel
02/26/2013

Ruft den Text aus dem angegebenen Teil eines StatusBar-Steuerelements ab.

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

Parameter

lpszText
Adresse des Puffers, der den Text empfängt.Dieser Parameter ist eine auf NULL endende Zeichenfolge.
nPane
Der nullbasierte Index der des Teils, um Text abzurufen.
pType
Zeiger auf eine ganze Zahl, die die Typinformationen abruft.Der Typ kann einer dieser Werte sein:
- 0 der Text wird mit einem Rahmen gezeichnet, um niedriger zu werden als die Kachel der Statusleiste.
- SBT_NOBORDERS der Text wird ohne Kontext gezeichnet.
- SBT_POPOUT der Text wird mit einem Rahmen gezeichnet, um höher werden als die Kachel der Statusleiste.
- SBT_OWNERDRAW, wenn der Text die SBT_OWNERDRAW Zeichnungsart verfügt, pType empfängt diese Nachricht und gibt den 32-Bit-Wert zurück, der mit dem Text statt der Länge und des Vorgangstyps zugeordnet ist.

Rückgabewert

Die Länge, in Zeichen, des Texts oder des CString, die den aktuellen Text enthalten.

Beispiel

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;