CStatusBarCtrl::GetText

  • Article

intGetText(LPCTSTRlpszText**,intnPane,int*pType) const;**

Return Value

The length, in characters, of the text.

Parameters

lpszText

Address of the buffer that receives the text. This parameter is a null-terminated string.

nPane

Zero-based index of the part from which to retrieve text.

pType

Pointer to an integer that receives the type information. The type can be one of these values:

  • 0   The text is drawn with a border to appear lower than the plane of the status bar.

  • SBT_NOBORDERS   The text is drawn without borders.

  • SBT_POPOUT   The text is drawn with a border to appear higher than the plane of the status bar.

  • SBT_OWNERDRAW   If the text has the SBT_OWNERDRAW drawing type, pType receives this message and returns the 32-bit value associated with the text instead of the length and operation type.

Remarks

Call this function to retrieve the text from the given part of a status bar control.

Example

int nType;
char* szPaneOneText;

szPaneOneText = new char[ GetTextLength( 1, &nType ) ];
int nTextLength = GetText( szPaneOneText, 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;
}

CStatusBarCtrl Overview |  Class Members |  Hierarchy Chart

See Also   CStatusBarCtrl::SetText, CStatusBarCtrl::GetTextLength