AcornSearch - Acorn and RISC OS information searching
RISC OS Search
containing
"Nutty quip goes here!"
Home  |  About  |  Filebase Archive  |  StrongHelp Manuals  |  Newsgroups  |  Module Database
Header:     textarea.h

Syntax:     
extern _kernel_oserror *textarea_set_background
(
unsigned int flags,
ObjectId     window, 
ComponentId  textarea,
void        *sprite_area,
void        *sprite,
int          x_off,
int          y_off
);              


Purpose:     Function sets a sprite to be rendered as a background to the text (requires TextGadgets 0.23). x_off and y_off are plot offsets in OS coordinates and allow the position of the sprite to be adjusted. Tiling and base alignment are controlled by the gadget state.
     Various extensions require TextGadgets 0.77:
     ·     Sprites can be specified by name instead of pointer by setting flags bit 0.
     ·     Any background sprite is removed if sprite_area == 0.
     ·     Sprites from the Wimp pool (which must be referred to by name) can be used by specifying sprite_area == 1.

[sh-index] Back to list of manuals