ListPopupWindow

INPUT_METHOD_FROM_FOCUSABLE

int INPUT_METHOD_FROM_FOCUSABLE

Mode for setInputMethodMode(int): the requirements for the input method should be based on the focusability of the popup. That is if it is focusable than it needs to work with the input method, else it doesn't.

Constant Value: 0 (0x00000000)

INPUT_METHOD_NEEDED

int INPUT_METHOD_NEEDED

Mode for setInputMethodMode(int): this popup always needs to work with an input method, regardless of whether it is focusable. This means that it will always be displayed so that the user can also operate the input method while it is shown.

Constant Value: 1 (0x00000001)

INPUT_METHOD_NOT_NEEDED

int INPUT_METHOD_NOT_NEEDED

Mode for setInputMethodMode(int): this popup never needs to work with an input method, regardless of whether it is focusable. This means that it will always be displayed to use as much space on the screen as needed, regardless of whether this covers the input method.

Constant Value: 2 (0x00000002)

MATCH_PARENT

int MATCH_PARENT

Alias for MATCH_PARENT. If used to specify a popup width, the popup will match the width of the anchor view. If used to specify a popup height, the popup will fill available space.

Constant Value: -1 (0xffffffff)

POSITION_PROMPT_ABOVE

int POSITION_PROMPT_ABOVE

The provided prompt view should appear above list content.

Constant Value: 0 (0x00000000)

POSITION_PROMPT_BELOW

int POSITION_PROMPT_BELOW

The provided prompt view should appear below list content.

Constant Value: 1 (0x00000001)

WRAP_CONTENT

int WRAP_CONTENT

Alias for WRAP_CONTENT. If used to specify a popup width, the popup will use the width of its content.

Constant Value: -2 (0xfffffffe)

ListPopupWindow

ListPopupWindow (Context context)

Create a new, empty popup window capable of displaying items from a ListAdapter. Backgrounds should be set using setBackgroundDrawable(Drawable).

ListPopupWindow

ListPopupWindow (Context context, 
                AttributeSet attrs)

Create a new, empty popup window capable of displaying items from a ListAdapter. Backgrounds should be set using setBackgroundDrawable(Drawable).

ListPopupWindow

ListPopupWindow (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

Create a new, empty popup window capable of displaying items from a ListAdapter. Backgrounds should be set using setBackgroundDrawable(Drawable).

ListPopupWindow

ListPopupWindow (Context context, 
                AttributeSet attrs, 
                int defStyleAttr, 
                int defStyleRes)

Create a new, empty popup window capable of displaying items from a ListAdapter. Backgrounds should be set using setBackgroundDrawable(Drawable).

clearListSelection

void clearListSelection ()

Clear any current list selection. Only valid when isShowing() == true.

createDragToOpenListener

View.OnTouchListener createDragToOpenListener (View src)

Returns an View.OnTouchListener that can be added to the source view to implement drag-to-open behavior. Generally, the source view should be the same view that was passed to setAnchorView(View).

When the listener is set on a view, touching that view and dragging outside of its bounds will open the popup window. Lifting will select the currently touched list item.

Example usage:

 ListPopupWindow myPopup = new ListPopupWindow(context);
 myPopup.setAnchor(myAnchor);
 OnTouchListener dragListener = myPopup.createDragToOpenListener(myAnchor);
 myAnchor.setOnTouchListener(dragListener);
 

dismiss

void dismiss ()

Dismiss the popup window.

getAnchorView

View getAnchorView ()

Returns the view that will be used to anchor this popup.

getAnimationStyle

int getAnimationStyle ()

Returns the animation style that will be used when the popup window is shown or dismissed.

getBackground

Drawable getBackground ()

getHeight

int getHeight ()

getHorizontalOffset

int getHorizontalOffset ()

getInputMethodMode

int getInputMethodMode ()

Return the current value in setInputMethodMode(int).

getListView

ListView getListView ()

getPromptPosition

int getPromptPosition ()

getSelectedItem

Object getSelectedItem ()

getSelectedItemId

long getSelectedItemId ()

getSelectedItemPosition

int getSelectedItemPosition ()

getSelectedView

View getSelectedView ()

getSoftInputMode

int getSoftInputMode ()

Returns the current value in setSoftInputMode(int).

getVerticalOffset

int getVerticalOffset ()

getWidth

int getWidth ()

isInputMethodNotNeeded

boolean isInputMethodNotNeeded ()

isModal

boolean isModal ()

Returns whether the popup window will be modal when shown.

isShowing

boolean isShowing ()

onKeyDown

boolean onKeyDown (int keyCode, 
                KeyEvent event)

Filter key down events. By forwarding key down events to this function, views using non-modal ListPopupWindow can have it handle key selection of items.

onKeyPreIme

boolean onKeyPreIme (int keyCode, 
                KeyEvent event)

Filter pre-IME key events. By forwarding onKeyPreIme(int, KeyEvent) events to this function, views using ListPopupWindow can have it dismiss the popup when the back key is pressed.

onKeyUp

boolean onKeyUp (int keyCode, 
                KeyEvent event)

Filter key up events. By forwarding key up events to this function, views using non-modal ListPopupWindow can have it handle key selection of items.

performItemClick

boolean performItemClick (int position)

Perform an item click operation on the specified list adapter position.

postShow

void postShow ()

Post a show() call to the UI thread.

setAdapter

void setAdapter (ListAdapter adapter)

Sets the adapter that provides the data and the views to represent the data in this popup window.

setAnchorView

void setAnchorView (View anchor)

Sets the popup's anchor view. This popup will always be positioned relative to the anchor view when shown.

setAnimationStyle

void setAnimationStyle (int animationStyle)

Set an animation style to use when the popup window is shown or dismissed.

setBackgroundDrawable

void setBackgroundDrawable (Drawable d)

Sets a drawable to be the background for the popup window.

setContentWidth

void setContentWidth (int width)

Sets the width of the popup window by the size of its content. The final width may be larger to accommodate styled window dressing.

setDropDownGravity

void setDropDownGravity (int gravity)

Set the gravity of the dropdown list. This is commonly used to set gravity to START or END for alignment with the anchor.

setHeight

void setHeight (int height)

Sets the height of the popup window in pixels. Can also be MATCH_PARENT.

setHorizontalOffset

void setHorizontalOffset (int offset)

Set the horizontal offset of this popup from its anchor view in pixels.

setInputMethodMode

void setInputMethodMode (int mode)

Control how the popup operates with an input method: one of INPUT_METHOD_FROM_FOCUSABLE, INPUT_METHOD_NEEDED, or INPUT_METHOD_NOT_NEEDED.

If the popup is showing, calling this method will take effect only the next time the popup is shown or through a manual call to the show() method.

setListSelector

void setListSelector (Drawable selector)

Sets a drawable to use as the list item selector.

setModal

void setModal (boolean modal)

Set whether this window should be modal when shown.

If a popup window is modal, it will receive all touch and key input. If the user touches outside the popup window's content area the popup window will be dismissed.

setOnDismissListener

void setOnDismissListener (PopupWindow.OnDismissListener listener)

Set a listener to receive a callback when the popup is dismissed.

setOnItemClickListener

void setOnItemClickListener (AdapterView.OnItemClickListener clickListener)

Sets a listener to receive events when a list item is clicked.

setOnItemSelectedListener

void setOnItemSelectedListener (AdapterView.OnItemSelectedListener selectedListener)

Sets a listener to receive events when a list item is selected.

setPromptPosition

void setPromptPosition (int position)

Set where the optional prompt view should appear. The default is POSITION_PROMPT_ABOVE.

setPromptView

void setPromptView (View prompt)

Set a view to act as a user prompt for this popup window. Where the prompt view will appear is controlled by setPromptPosition(int).

setSelection

void setSelection (int position)

Set the selected position of the list. Only valid when isShowing() == true.

setSoftInputMode

void setSoftInputMode (int mode)

Sets the operating mode for the soft input area.

setVerticalOffset

void setVerticalOffset (int offset)

Set the vertical offset of this popup from its anchor view in pixels.

setWidth

void setWidth (int width)

Sets the width of the popup window in pixels. Can also be MATCH_PARENT or WRAP_CONTENT.

setWindowLayoutType

void setWindowLayoutType (int layoutType)

Set the layout type for this popup window.

See type for possible values.

show

void show ()

Show the popup list. If the list is already showing, this method will recalculate the popup's size and position.