home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / gnu / aplusplus-1.01-src.lha / src / amiga / aplusplus-1.01 / include / aplusplus / graphics / TextView.h < prev    next >
C/C++ Source or Header  |  1994-05-04  |  4KB  |  118 lines
  1. #ifndef APP_TextView_H
  2. #define APP_TextView_H
  3. /******************************************************************************
  4.  **
  5.  **    C++ Class Library for the Amiga© system software.
  6.  **
  7.  **    Copyright (C) 1994 by Armin Vogt  **  EMail: armin@uni-paderborn.de
  8.  **    All Rights Reserved.
  9.  **
  10.  **    $VER: apphome:APlusPlus/graphics/TextView.h 1.04 (04.05.94) $
  11.  **    
  12.  ******************************************************************************/
  13.  
  14. #include <APlusPlus/graphics/Canvas.h>
  15. #include <APlusPlus/intuition/RawKeyDecoder.h>
  16.  
  17.  
  18. /******************************************************************************************
  19.       » TextView class «
  20.  
  21.     The TextView class visualizes ASCII text within a rectangular view that can be moved
  22.     over the text.
  23.     The way in which the text is provided can be customized, as can the format of the text
  24.     output in matters of color and softstyle be adjusted context-sensitively.
  25.  
  26.  ******************************************************************************************/
  27.  
  28. class TextView : public Canvas
  29. {
  30.     private:
  31.         FontC font;    
  32.         LONG crsrx,crsry,lineCount;    // cursor position in the text
  33.         LONG cviewx,cviewy;                // cursor position in the view (1..visibleXY())
  34.         XYVAL cBoxLeft,cBoxRight;        // cursor box dimensions in pixel
  35.         UBYTE crsrOn;
  36.         
  37.         BOOL cursorIsOn() { return crsrOn==TRUE; }
  38.         void cursorOn() { crsrOn = TRUE; }
  39.         void cursorOff() { crsrOn = FALSE; }
  40.             
  41.         void toggleCBox();
  42.         void eraseCBox() { if (cursorIsOn()) toggleCBox(); }
  43.         void drawCBox() { if (cursorIsOn()) toggleCBox(); }
  44.     
  45.         LONG topLine() { return viewY()+1; }
  46.         LONG visibleLines() { return visibleY(); }
  47.             
  48.         void findCursor();
  49.         
  50.     protected:
  51.         RawKeyDecoder key;
  52.         
  53.         virtual void formatOutput(UBYTE *lineText,UWORD length);
  54.         /** formatOutput(text) can be overwritten to establish your special text output.
  55.          ** It is called when TextView finds it necessary to write a line. TextView prepares for
  56.          ** writing, then calles formatOutput with the string that is to be written.
  57.          ** Within this method you have to write the whole string by repeated use of 
  58.          ** print(). Positioning is done by TextView. You can change colors and softstyle 
  59.          ** between the print() calls. Don't assume any color or softstyle being set on entry.
  60.          ** The default method prints each text line as is.
  61.          **/
  62.          
  63.         void print(UBYTE *partString,UWORD length);    // used only within formatOutput()
  64. /*         Canvas::setAPen;        // used only within formatOutput() between print() calls
  65.         Canvas::setBPen;
  66.         Canvas::setDrMd;
  67.     */    
  68.     
  69.         virtual UBYTE *getLineString(LONG lineNr,UWORD& length)=0;
  70.         /** By calling this method a TextView object demands a 0-terminated string which it 
  71.          ** will display as line 'lineNr'. Your overwriting method has to return the address
  72.          ** of the string you want to have displayed as line 'lineNr'. The string will not be
  73.          ** copied and thus must be accessable until the next 'getLineString()' call.
  74.          **/
  75.         
  76.         void callback(const IntuiMessageC *imsg);
  77.         
  78.    public:
  79.       TextView(GOB_OWNER, AttrList& attrs);
  80.       ~TextView();
  81.                 
  82.         void drawSelf();
  83.                 
  84.         ULONG setAttributes(AttrList& attrs);
  85.         ULONG getAttribute(Tag tag,ULONG& dataStore);
  86.         
  87.         void writeLine(LONG lineNr);                // force rewriting a single line 
  88.         LONG lines() { return lineCount; }        // get text length in lines
  89.         
  90.         BOOL setCursor(LONG lineNr,LONG characterNr);    
  91.         void moveCursorTo(int CursorPosTag);        // special cursor positioning on text context
  92.         LONG cursorX() { return crsrx; }    // get character under cursor number (1..length of line string)
  93.         LONG cursorY() { return crsry; }    // get cursor line (1..lines())
  94. };
  95.  
  96. #define TXV_Dummy        (IOTYPE_TEXTVIEW+1)
  97.  
  98. #define TXV_Columns            (TXV_Dummy + 2)
  99.     /* Unused
  100.     */
  101.     
  102. #define TXV_Lines                (CNV_Height)
  103.     /* LONG: length of the text to be displayed.
  104.     */
  105.     
  106. #define TXV_FontName            (TXV_Dummy + 3)
  107. #define TXV_FontSize            (CNV_GranularityY)
  108.     /* Set the font (may be non-proportional) for the text display.
  109.     */
  110.     
  111. #define TXV_CursorOn            (TXV_Dummy + 4)
  112.     /* BOOL: TRUE for a visible cursor, FALSE for no cursor.
  113.     */
  114. #define TXV_CursorX            (TXV_Dummy + 5)
  115. #define TXV_CursorY            (TXV_Dummy + 6)
  116.  
  117. #endif
  118.