The Be Book The Application Kit The Application Kit Index

BCursor

Derived from: none
Mix-in classes: BArchivable
Declared in:  be/app/Cursor.h
Library: libbe.so
Summary:  more...


You can use a BCursor to represent a mouse cursor as an object instead of as a block of pixel data; this can be more convenient in some situations. Also, if you want to call BApplication::SetCursor() without forcing an immediate sync of the Application Server, you have to use a BCursor.

The default BCursors are B_CURSOR_SYSTEM_DEFAULT for the hand cursor and B_CURSOR_I_BEAM for the I-beam text editing cursor.


Cursor Data Format

The first four bytes of cursor data give information about the cursor:

Next comes an array of pixel color data. Pixels are specified from left to right in rows starting at the top of the image and working downward. The size of an array element is the depth of the image. In one-bit depth...

Then comes the pixel transparency bitmask, given left-to-right and top-to-bottom. 1 is opaque, 0 is transparent. Transparency only applies to white pixels—black pixels are always opaque.


Constructor and Destructor


BCursor()

BCursor(const void *cursorData)
BCursor(BMessage *archive)

Initializes the new cursor object. If you specify a non-NULL value for cursorData, the cursor is initialized with the specified cursor data.

If you specify a NULL value for cursorData, the cursor is useless; since this class doesn't currently provide a means of setting the cursor data once the object is instantiated, you're out of luck, so why bother?

BCursor doesn't currently implement archiving, so you shouldn't use the second form.


~BCursor()

virtual ~BCursor()

Releases any resources used by the cursor.


Static Functions


Instantiate()

static BArchivable *Instantiate(BMessage *archive)

Not currently implemented; always returns NULL.

See also: BArchivable::Instantiate(), instantiate_object(), Archive()


The Be Book The Application Kit The Application Kit Index

The Be Book,
...in lovely HTML...
for BeOS Release 5.

Copyright © 2000 Be, Inc. All rights reserved..