epoc32/include/frmconst.h
author William Roberts <williamr@symbian.org>
Tue, 16 Mar 2010 16:12:26 +0000
branchSymbian2
changeset 2 2fe1408b6811
parent 0 061f57f2323e
child 4 837f303aceeb
permissions -rw-r--r--
Final list of Symbian^2 public API header files
     1 // Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
     2 // All rights reserved.
     3 // This component and the accompanying materials are made available
     4 // under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
     5 // which accompanies this distribution, and is available
     6 // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
     7 //
     8 // Initial Contributors:
     9 // Nokia Corporation - initial contribution.
    10 //
    11 // Contributors:
    12 //
    13 // Description:
    14 // FOR INFORMATION ONLY (CONTAINS PANIC NUMBERS, ETC.) - NOT PART OF INTERFACE
    15 // 
    16 //
    17 
    18 #ifndef __FRMCONST_H__
    19 #define __FRMCONST_H__
    20 
    21 #include <w32std.h>
    22 
    23 /** 
    24 Visible versions of control characters.
    25 @internalComponent
    26 */
    27 const TText KVisibleParagraphBreak = 0x00B6;		// paragraph sign (pilcrow)
    28 const TText KVisibleLineBreak = 0x2193;				// down arrow
    29 const TText KVisibleNonBreakSpace = 0x00B0;			// degree sign
    30 const TText KVisiblePotentialHyphen = 0x00AC;		// not sign
    31 const TText KVisibleNonBreakHyphen = 0x007E;		// spacing tilde
    32 const TText KVisibleSpace = 0x00B7;					// middle dot
    33 const TText KVisibleTab = 0x2192;					// right arrow
    34 const TText KVisiblePicture = 0x25A3;				// white square containing small black square
    35 
    36 /**
    37 Control characters to allow or inhibit line breaks.
    38 @internalComponent
    39 */
    40 const TText KZeroWidthSpace = 0x200B;
    41 const TText KZeroWidthNoBreakSpace = 0xFEFF;
    42 
    43 /**
    44 @publishedAll
    45 @released
    46 */
    47 enum TFormPanic
    48 	{
    49 	/** Not used 
    50 	*/
    51 	EFDummy = 0,				
    52 
    53 	// Used in ASSERT_ALWAYS
    54 
    55 	// Parameter errors
    56 	/** Document handle NULL has been passed in
    57 	*/
    58 	EFInvalidDocument = 200,	
    59 	/** A NULL layout handle has been passed in 
    60 	*/
    61 	EFInvalidLayout,			
    62 	/** The character edit type was unknown or incompatible with the format changed value 
    63 	*/
    64 	EFBadCharacterEditType,		
    65 	/** The horizontal scroll jump value has been set outside the allowable range (0,9999) 
    66 	*/
    67 	EFInvalidJumpValue,			
    68 
    69 	// Document
    70 	/** No or negative document position specified or greater than current document length 
    71 	*/
    72 	EFInvalidDocPos = 300,		
    73 
    74 	// Drawing
    75 	/** The function CTextView::SetLineCursorBitmap has not been called even though a line cursor is being used 
    76 	*/
    77 	EFLineCursorBitmapNotSet = 400,	
    78 
    79 	// Pagination
    80 	/** No document to paginate 
    81 	*/
    82 	EFDocumentToPaginateNotSet = 500, 
    83 	/** Appending zero or negative characters per page to page list 
    84 	*/
    85 	EFInvalidNumberCharsOnPage,	
    86 	/** Page list should not be empty at this point 
    87 	*/
    88 	EFPageListEmpty,			
    89 
    90 	// Printing
    91 	/** The array containing the number of characters per page has not been set or is defective 
    92 	*/
    93 	EFInvalidPageList = 600,	
    94 	/** A page requested that is outside the page list given 
    95 	*/
    96 	EFInvalidPageNumber,		 
    97 
    98 	// Used only in ASSERT_DEBUG
    99 
   100 	// Errors in internal format information
   101 	/** Format doesn't fill band but is not to end of document 
   102 	*/
   103 	EFNotEnoughFormat = 700,	
   104 	/** A lines says it has height zero 
   105 	*/
   106 	EFZeroHeightLine,			
   107 	/** The selected range flag is on but the selection has zero length 
   108 	*/
   109 	EFSelectedRangeZeroLen,		
   110 	/** The cursor is a document position that is outside the formatted range 
   111 	*/
   112 	EFCursorNotInCurrentFormat,	
   113 	/** GetLineRect pixel that was asked for 
   114 	*/
   115 	EFPixelNotInFormattedLine,	
   116 	/** The complete scroll should have been possible 
   117 	*/
   118  	EFScrollCurtailed,			
   119 
   120 	// Logic error during format process
   121 	/** Should not be calling HandleCharEdit when there is a selection 
   122 	*/
   123 	EFSelectionCannotCharEdit = 800,	
   124 	/** This function should not be called when the format is out of date 
   125 	*/
   126 	EFFormatOutOfDate,			
   127 	/** Background formatting should not be going on 
   128 	*/
   129 	EFBackgroundFormatting,		
   130 
   131 	// Scrolling errors
   132 	/** The request for a scroll returned zero as the ammount to scroll by 
   133 	*/
   134 	EFScrollByZero1 = 900,		
   135 	/** A routine that does the scrolling is called with a value of zero or one having wrong sign 
   136 	*/
   137 	EFScrollByZero2,			
   138 	/** Algorithmic or assumption error in the scroll routine 
   139 	*/
   140 	EFScrollError,				
   141 	/** Error when scrolling text down 
   142 	*/
   143 	EFScrollDownError,			
   144 	/** Error when scrolling text up 
   145 	*/
   146 	EFScrollUpError,			
   147 	/** A scrolling routine was expecting a certain type of scroll and got a different one 
   148 	*/
   149 	EFInvalidScrollingType,		
   150 
   151 	// Out of memory
   152 	/** Cannot do this when in no memory mode 
   153 	*/
   154 	EFNoMemory = 1000,			
   155 	/** Trying to recover from no_memory when no no_memory condition has occured 
   156 	*/
   157 	EFRecoverNoMemory,			
   158 
   159 	// Cursor
   160 	/** The cursor has been moved to a position off the screen 
   161 	*/
   162 	EFCursorOffDisplay = 1100,	
   163 	/** Attempt to access the cursor navigation policy object when its pointer is 0 
   164 	*/
   165 	EFNoCursorPositionPolicy,	
   166 	/** Invalid positioning hint value supplied to API 
   167 	*/
   168 	EFPosHintInvalid,			
   169 	/** Curosr APIs found formatting not available for position supplied. 
   170 	*/
   171 	EFPositionNotFormatted,		
   172 	/** The document position was out of range for the current source document. 
   173 	*/
   174 	EFPositionInvalid,			
   175 
   176 	// Drawing
   177 	/** Trying to toggle the highlight on part of the screen when the selection is not visible 
   178 	*/
   179 	EFSelectionNotVisible = 1200, 
   180 	/** Clearing bottom partial line when not needed
   181 	*/
   182  	EFPartialLineClearError,    
   183 	/** The routine that does the display has been passed a null pointer to a graphics context 
   184 	*/
   185 	EFGcNotSet,					
   186 
   187 	//Internal Coding Errors	   
   188 	/** SetViewL has put the text at the wrong vertical height 
   189 	*/
   190 	EFViewNotPositionedCorrectly = 1300, 
   191 	/** The function call should not leave in this situation 
   192 	*/
   193 	EFShouldNotLeave,			
   194 	/** Trying to move cursor using wrong function call 
   195 	*/
   196 	EFIncorrectCursorMovement,	
   197 	/** Should be current picture frame 
   198 	*/
   199 	EFNoPictureFrame,			
   200 	/** A value of a system constant has changed to a value that has broken this code 
   201 	*/
   202 	EFSystemConstantsChanged	
   203 	};
   204 
   205 /**
   206 @internalComponent
   207 */
   208 void FormPanic(TFormPanic aPanic);
   209 
   210 
   211 enum TCursorMove
   212 /**
   213 This enum holds all the allowed movements of the document cursor by this
   214 cursor positioning framework.
   215 @publishedPartner
   216 @released
   217 */
   218 	{
   219 	/** No cursor movement 
   220 	*/
   221 	ECursNoMovement,
   222     /** Single character cursor movement to the left 
   223     */
   224     ECursLeft,
   225     /** Single character cursor movement to the right 
   226     */
   227     ECursRight,
   228     /** Line up cursor movement 
   229     */
   230     ECursLineUp,
   231     /** Line down cursor movement 
   232     */
   233     ECursLineDown,
   234     /** Not used, present for backwards compatibility for page movement 
   235     */
   236     ECursReserved1,
   237     ECursReserved2,
   238     /** Cursor movement to line start 
   239     */
   240     ECursLineBegin,
   241     /** Cursor movement to line end 
   242     */
   243     ECursLineEnd
   244 	};
   245 
   246 
   247 #endif // __FRMCONST_H__