com.buglabs.status
Interface IStatusBarProvider

All Known Implementing Classes:

StatusBar

public interface IStatusBarProvider

A Status Bar is a bitmap display that can show the user simple status messages and icons. Clients may request resources from the Status Bar Provider in either bitmap form or text (String) form. The position and scale of the region are not controlled by the client. The client should not assume that it's region is always visible at all times.

Author:

ken

Method Summary

java.lang.String	acquireRegion(int length) Get text resource from Status Bar provider.
java.lang.String	acquireRegion(int height, int width) Get bitmap resource from Status Bar provider.
void	releaseRegion(java.lang.String key)
void	write(java.lang.String key, boolean[][] bitmap) Write a bitmap to the status screen.
void	write(java.lang.String key, java.lang.String message) Write a text message to the status screen.

Method Detail

acquireRegion

java.lang.String acquireRegion(int height,
                               int width)

Get bitmap resource from Status Bar provider.

Parameters:

clientId - ID of client

height - required height for status bitmap

width - required width for status bitmap

Returns:

A key associated with requested region or null if no region can be allocated.

acquireRegion

java.lang.String acquireRegion(int length)

Get text resource from Status Bar provider.

Parameters:

clientId -

length -

Returns:

A key associated with requested region or null if no region can be allocated.

write

void write(java.lang.String key,
           boolean[][] bitmap)

Write a bitmap to the status screen. Must successfully aquire region before calling this method.

Parameters:

clientId -

bitmap -

write

void write(java.lang.String key,
           java.lang.String message)

Write a text message to the status screen. Must successfully aquire region before calling this method.

Parameters:

clientId -

message -

releaseRegion

void releaseRegion(java.lang.String key)