qdosmsq:traps:trap_3:defb [QDOS Internals]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== 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>