Android
android.view
public static interface

android.view.SurfaceHolder.Callback

android.view.SurfaceHolder.Callback

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 The Callback is set with {@link SurfaceHolder#addCallback SurfaceHolder.addCallback method.

Summary

Public Methods

          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.
          void  surfaceCreated(SurfaceHolder holder)
This is called immediately after the surface is first created.
          void  surfaceDestroyed(SurfaceHolder holder)
This is called immediately before a surface is being destroyed.

Details

Public Methods

public 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 The SurfaceHolder whose surface has changed.
format The new PixelFormat of the surface.
width The new width of the surface.
height The new height of the surface.

public 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 The SurfaceHolder whose surface is being created.

public 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 The SurfaceHolder whose surface is being destroyed.
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:48