public class
MediaChooser

extends AbsActivityStarter

Inheritance

Class Overview

Allows the user to choose a piece of media (such as an image or a video) from the media gallery on his or her device.

This class should be used from an event handler in a Screen subclass. Display the media chooser by calling the start(Activity) method. When a selection is made, the mediaWasChosen method will be called on the screen, if it exists. For example: 

 public class MyScreen extends Screen
 {
     public void buttonClicked()
     {
         MediaChooser chooser = new MediaChooser();
         chooser.start(this);
     }
 
     public void mediaWasChosen(MediaChooser chooser)
     {
         // Do something with the media by calling chooser.getBitmap(),
         // chooser.getUri(), or chooser.getPath().
     }
 }

Summary

Public Constructors
MediaChooser()
Initializes a new media chooser that, by default, has the content type image/*.
Public Methods
Bitmap getBitmap()
A convenience method that returns the chosen image as a Bitmap if the selected media was an image.
String getPath()
Gets the file system path of the media that was chosen in the media chooser.
String getType()
Gets the content type of the acceptable kinds of media that can be selected by this media chooser.
Uri getUri()
Gets the Uri (uniform resource identifier) of the media that was chosen in the media chooser.
void handleActivityResult(Activity owner, Intent data, int requestCode, int resultCode)
void setType(String newType)

Sets the content type (also known as the MIME type or internet media type) of the acceptable kinds of media that can be selected by this media chooser.

void start(Activity owner, String method)
Starts the media chooser.
void start(Activity owner)
Starts the media chooser.
Protected Methods
String getDefaultCallback()
Methods inherited from class java.lang.Object
Object clone()
boolean equals(Object arg0)
void finalize()
final Class<?> getClass()
int hashCode()
final void notify()
final void notifyAll()
String toString()
final void wait()
final void wait(long arg0, int arg1)
final void wait(long arg0)

Public Constructors

public MediaChooser ()

Initializes a new media chooser that, by default, has the content type image/*.

Public Methods

public Bitmap getBitmap ()

A convenience method that returns the chosen image as a Bitmap if the selected media was an image. Otherwise, the method returns null.

Returns

a Bitmap that represents the image that was chosen, or null if it was not an image

public String getPath ()

Gets the file system path of the media that was chosen in the media chooser.

Returns

the file system path of the media that was chosen

public String getType ()

Gets the content type of the acceptable kinds of media that can be selected by this media chooser.

Returns

the content type for this media chooser

public Uri getUri ()

Gets the Uri (uniform resource identifier) of the media that was chosen in the media chooser.

Returns

the Uri of the media that was chosen

public void handleActivityResult (Activity owner, Intent data, int requestCode, int resultCode)

public void setType (String newType)

Sets the content type (also known as the MIME type or internet media type) of the acceptable kinds of media that can be selected by this media chooser. This content type can be a specific individual type (such as image/jpeg) or include a wildcard to support multiple related types (e.g., image/* or video/*).

More information about content types can be found in the Wikipedia article Internet media types.

Parameters
newType
the MIME type for this media chooser
public void start (Activity owner, String method)

Starts the media chooser. When the user has chosen an item from the media gallery, the owning Activity (or Screen) will have the method with the name specified by method called.

Parameters
owner
the activity or screen that owns this media chooser and will receive a notification when a media item is chosen
method
the name of the method that will be called on owner when a media item is chosen
public void start (Activity owner)

Starts the media chooser. When the user has chosen an item from the media gallery, the owning Activity (or Screen) will have its mediaWasChosen method called.

Parameters
owner
the activity or screen that owns this media chooser and will receive a notification when a media item is chosen

Protected Methods

protected String getDefaultCallback ()