qdosmsq:traps:trap_3:defb

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

qdosmsq:traps:trap_3:defb [2009/05/17 14:47] (current)
george.gwilt created
Line 1: Line 1:
 +====== SD_BORDR/IOW_DEFB ======
 +
 +
 +This trap sets a window's colour and size.
 +
 +^Call Parameters^^Return Parameters^^
 +|D0.B|$0C|D0.L|Error return.|
 +|D1.B|Colour |D1.L|Corrupted.|
 +|D2.W|Width |D2.L|Preserved.|
 +|D3.W|Timeout|D3.L|Preserved.|
 +|A0.L|Channel ID |A0.L|Preserved.|
 +|A1.L| |A1.L|Corrupted.|
 +
 +===== Errors =====
 +
 +|ERR_NC|Not complete.|
 +|ERR_NO|Channel not open.|
 +
 +
 +===== Notes =====
 +  * All registers not shown above are not used on entry and are preserved on exit.
 +  * The width of the border is doubled on the vertical edges.
 +  * The border is set inside the window's limits.
 +  * All subsequent screen traps (except this one) use the reduced window size for defining cursor position and window limits.
 +  *  If the call changes the width of the border, the cursor is reset to the home position at top left.
 +  * As a special case if the colour is set to $80 the border is made transparent. 
 +
 +===== Example =====
 +The example below shows the use of this trap call to set a border. It is assumed that A0 contains the window's ID.
 +
 +<code>
 +brdr    moveq   #sd_brdr,d0     ; $0C
 +        moveq   #-1,d1          ; Grey border
 +        moveq   #3,d2           ; Width 3
 +        moveq   #-1,d3          ; Timeout
 +        trap    #3              ; Set the border
 +        tst.l   d0              ; OK? . .
 +        bne     error           ; . . no!
 +</code>
 +
  
  • qdosmsq/traps/trap_3/defb.txt
  • Last modified: 2009/05/17 14:47
  • by george.gwilt