public
static
interface
SurfaceHolder.Callback
| android.view.SurfaceHolder.Callback |
 Known Indirect Subclasses
|
A client may implement this interface to receive information about
changes to the surface. When used with a SurfaceView, the
Surface being held is only available between calls to
surfaceCreated(SurfaceHolder) and
surfaceDestroyed(SurfaceHolder). The Callback is set with
SurfaceHolder.addCallback method.
Public methods | |
|---|---|
abstract
void
|
surfaceChanged(SurfaceHolder holder, int format, int width, int height)
This is called immediately after any structural changes (format or size) have been made to the surface. |
abstract
void
|
surfaceCreated(SurfaceHolder holder)
This is called immediately after the surface is first created. |
abstract
void
|
surfaceDestroyed(SurfaceHolder holder)
This is called immediately before a surface is being destroyed. |
void surfaceChanged (SurfaceHolder holder, int format, int width, int height)
This is called immediately after any structural changes (format or
size) have been made to the surface. You should at this point update
the imagery in the surface. This method is always called at least
once, after surfaceCreated(SurfaceHolder).
| Parameters | |
|---|---|
holder |
SurfaceHolder:
The SurfaceHolder whose surface has changed. |
format |
int:
The new PixelFormat of the surface. |
width |
int:
The new width of the surface. |
height |
int:
The new height of the surface.
|
void surfaceCreated (SurfaceHolder holder)
This is called immediately after the surface is first created.
Implementations of this should start up whatever rendering code
they desire. Note that only one thread can ever draw into
a Surface, so you should not draw into the Surface here
if your normal rendering will be in another thread.
| Parameters | |
|---|---|
holder |
SurfaceHolder:
The SurfaceHolder whose surface is being created.
|
void surfaceDestroyed (SurfaceHolder holder)
This is called immediately before a surface is being destroyed. After returning from this call, you should no longer try to access this surface. If you have a rendering thread that directly accesses the surface, you must ensure that thread is no longer touching the Surface before returning from this function.
| Parameters | |
|---|---|
holder |
SurfaceHolder:
The SurfaceHolder whose surface is being destroyed.
|
Developers