Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File13.14.1.3.7  The control-flags                                     TOS

With the control-flags one can influence the benaviour of the font- 
selector.

      Name           Value    Meaning 
      CC_WINDOW      0x0001   Font-selector as a window 
      CC_APPMODAL    0x0002   Font-selector is application-modal 
      CC_FIX31       0x0004   All size specifications in 1/65536 point 
      CC_FAKESTYLE   0x0008   Simulate styles (only bitmap fonts) 
      CC_CLOSER      0x0010   Window with Closer, no OK button 
      CC_NOSIZE      0x0100   Do not alter size 
      CC_NOCOLOR     0x0200   Do not alter colour 
      CC_NOATTR      0x0400   Do not alter attributes 
      CC_NOWIDTH     0x0800   Do not alter width 
      CC_NOKERN      0x1000   Do not alter kerning 
      CC_NOSKEW      0x2000   Do not alter skewing 
      CC_NOALIGN     0x4000   Do not alter alignment 
      CC_NOROTATION  0x8000   Do not alter text rotation 
      CC_DFLTSIZE    0x10000  'Default' font size 
      CC_INVSTYLE    0x20000  'Inverse' attribute 

The function of the individual flags should be clear already from the 
names and short descriptions. Here still a few notes:

   . CC_APPMODAL
     'application-modal' means that the program is put in a mode in 
     which only the font-selector can be processed. Essentially this 
     means that the font-selector intercepts all WM_TOPPED messages 
     for other windows of the calling program and does not pass them 
     on, but makes itself the topped window instead. This is meant to 
     tell the user that he should first deal with the font-selector 
     before he can initiate another action in the program.

     The caller in this mode should of course forego topping its own 
     windows with wind_set(WF_TOP).

   . CC_FAKESTYLE
     This is a specialty that only Calvino offers at present: For 
     those bitmap fonts for which no light, italic or bold variants 
     are present, the missing cuts are each simulated with the VDI 
     function vst_effects.

   . CC_CLOSER
     If this flag and CC_WINDOW are set, then the font-selector is 
     provided with a Closer, while the 'OK' and the 'Cancel' buttons 
     are hidden. This is intenderd for cases where the font-selector 
     is to be used as a pure Drag&Drop selector.

   . CC_NO...
     With these flags one can determine which settings are not to be 
     altered. For instance, a program may want to prevent the size of 
     a font being changed, while a change of the font itself is to be 
     allowed. In that case the caller only has to set the CC_NOSIZE 
     flag.

     But please note that despite a set CC_NO... flag you always have 
     to pass a valid value. The meaning of these flags therefore is 
     that the preset values may not be changed, and not that these 
     values are not of interest.

Please note: Not all font-selectors support all of the control-flags! 
If a font-selector does not support a flag, then it will simply ignore 
it. On a successful(!) xfsl_init call, the font-selector will clear 
those flags in the control element of the xFSL_PAR structure that it 
does not understand.