Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
GrabRequest struc
    grlpData    dd  ?       ;long pointer to I/O buffer
    grXorg      db  ?       ;x origin (unsigned)
    grYorg      db  ?       ;y origin (unsigned)
    grXext      db  ?       ;x extent (unsigned)
    grYext      db  ?       ;y extent (unsigned)
    grStyle     db  ?       ;style flags
    grChar      db  ?       ;character code for fill operations
    grAttr      db  ?       ;attribute for fill operations
GrabRequest ends
 
The GRABREQUEST structure contains information used to capture all or a
portion of the screen.
 
Member                                    Description
────────────────────────────────────────────────────────────────────────────
 
grlpData                                  Contains the address of the buffer
                                          to receive or containing the
                                          screen data.
 
grXorg                                    Specifies the x-origin (unsigned)
                                          of the upper-left corner of the
                                          block.
 
grYorg                                    Specifies the y-origin (unsigned)
                                          of the upper-left corner of the
                                          block.
 
grXext                                    Specifies the x-extent of the
                                          block. If grXext is zero, the
                                          entire screen width is assumed.
 
grYext                                    Specifies the y-extent of the
                                          block. If grYext is zero, the
                                          entire screen height is assumed.
 
grStyle                                   Specifies the type and format of
                                          the block operation. It can be a
                                          combination of one Screen
                                          Operation and one Format value.
                                          The following are the values for
                                          the Screen Operation.
 
                                          Value                Screen Operat
                                          ──────────────────────────────────
                                          F_BOTH (00h)         Fills with
                                                               single
                                                               character and
                                                               attribute.
 
                                          F_CHAR (01h)         Fills with
                                                               single
                                                               character
                                                               only.
 
                                          F_ATTR (02h)         Fills with
                                                               single
                                                               attribute
                                                               only.
 
                                          C_BOTH (03h)         Copies
                                                               characters
                                                               and
                                                               attributes
                                                               from
                                                               grlpData.
 
                                          C_CHAR (04h)         Copies
                                                               characters
                                                               only from
                                                               grlpData.
 
                                          C_ATTR (05h)         Copies
                                                               attributes
                                                               only from
                                                               grlpData.
 
                                          C_CHAR_F_ATTR (06h)  Copies
                                                               characters
                                                               from
                                                               grlpData and
                                                               fills with
                                                               single
                                                               attribute.
 
                                          C_ATTR_F_CHAR (07h)  Copies
                                                               attributes
                                                               from
                                                               grlpData and
                                                               fills with
                                                               single
                                                               character.
 
The following are the values for Format.
                                          ──────────────────────────────────
                                          FMT_NATIVE (00h)  Uses format
                                                            native to mode.
 
                                          FMT_OTHER (80h)   Uses clipboard
                                                            format or format
                                                            specified by the
                                                            Screen Operation
                                                            value.
 
grChar                                    Specifies a character code for
                                          fill operations.
 
grAttr                                    Specifies an attribute byte for
                                          fill operations.
 
Comments
 
All block functions receive a pointer to a GRABREQUEST structure in the
ES:DI register pair. Not all the members are used by all functions.
 
See Also
 
GetBlock
 
 
                                      ♦