Freigeben über


CStatusBarCtrl::GetText

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;

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CStatusBarCtrl-Klasse

Hierarchien-Diagramm

CStatusBarCtrl::SetText

CStatusBarCtrl::GetTextLength