Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄CDC►                                         ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  CSize TabbedTextOut( int x, int y, const char FAR* lpString,
                       int nCount, int nTabPositions,
                       LPINT lpnTabStopPositions, int nTabOrigin );
 
  Parameter             Description
 
  <x>                   Specifies the logical x-coordinate of the starting
                        point of the string.
 
  <y>                   Specifies the logical y-coordinate of the starting
                        point of the string.
 
  <lpString>            Points to the character string to draw. You can
                        pass either a const FAR pointer to an array of
                        characters or a ◄CString► object for this
                        parameter.
 
  <nCount>              Specifies the number of characters in the string.
 
  <nTabPositions>       Specifies the number of values in the array of
                        tab-stop positions.
 
  <lpnTabStopPositions> Points to an array containing the tab-stop
                        positions (in device units). The tab stops must be
                        sorted in increasing order; the smallest x-value
                        should be the first item in the array.
 
  <nTabOrigin>          Specifies the x-coordinate of the starting
                        position from which tabs are expanded (in logical
                        units).
 
  Remarks
 
  Writes a character string at a specified location, expanding tabs to the
  values specified in an array of tab-stop positions. Text is written in
  the currently selected font. If <nTabPositions> is 0 and
  <lpnTabStopPositions> is NULL, tabs are expanded to eight times the
  average character width.
 
  If <nTabPositions> is 1, the tab stops are separated by the distance
  specified by the first value in the <lpnTabStopPositions> array.
 
  If the <lpnTabStopPositions> array contains more than one value, a tab
  stop is set for each value in the array, up to the number specified by
  <nTabPositions>.
 
  The <nTabOrigin> parameter allows an application to call the
  TabbedTextOut function several times for a single line. If the
  application calls the function more than once with the <nTabOrigin> set
  to the same value each time, the function expands all tabs relative to
  the position specified by <nTabOrigin>.
 
  By default, the current position is not used or updated by the function.
  If an application needs to update the current position when it calls the
  function, the application can call SetTextAlign with <nFlags> set to
  TA_UPDATECP. When this flag is set, Windows ignores <x> and <y> on
  subsequent calls to TabbedTextOut, using the current position instead.
 
  Return Value
 
  The dimensions of the string (in logical units) as a CSize.
 
  See Also
 
  ◄CDC::GetTabbedTextExtent►, ◄CDC::SetTextAlign►, ◄CDC::TextOut►,
  ◄::TabbedTextOut►
 
 
                                     -♦-