ListPopupWindow

Kotlin |Java

open class ListPopupWindow

kotlin.Any
↳	android.widget.ListPopupWindow

A ListPopupWindow anchors itself to a host view and displays a list of choices.

ListPopupWindow contains a number of tricky behaviors surrounding positioning, scrolling parents to fit the dropdown, interacting sanely with the IME if present, and others.

Summary

XML attributes
`android:dropDownHorizontalOffset`	Amount of pixels by which the drop down should be offset horizontally.
`android:dropDownVerticalOffset`	Amount of pixels by which the drop down should be offset vertically.

Constants
static Int	`INPUT_METHOD_FROM_FOCUSABLE` Mode for `setInputMethodMode(int)`: the requirements for the input method should be based on the focusability of the popup.
static Int	`INPUT_METHOD_NEEDED` Mode for `setInputMethodMode(int)`: this popup always needs to work with an input method, regardless of whether it is focusable.
static 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.
static Int	`MATCH_PARENT` Alias for `ViewGroup.LayoutParams#MATCH_PARENT`.
static Int	`POSITION_PROMPT_ABOVE` The provided prompt view should appear above list content.
static Int	`POSITION_PROMPT_BELOW` The provided prompt view should appear below list content.
static Int	`WRAP_CONTENT` Alias for `ViewGroup.LayoutParams#WRAP_CONTENT`.

Public constructors
`ListPopupWindow(context: Context)` Create a new, empty popup window capable of displaying items from a ListAdapter.
`ListPopupWindow(context: Context, attrs: AttributeSet?)` Create a new, empty popup window capable of displaying items from a ListAdapter.
`ListPopupWindow(context: Context, attrs: AttributeSet?, defStyleAttr: Int)` Create a new, empty popup window capable of displaying items from a ListAdapter.
`ListPopupWindow(context: Context, attrs: AttributeSet?, defStyleAttr: Int, defStyleRes: Int)` Create a new, empty popup window capable of displaying items from a ListAdapter.

Public methods
open Unit	`clearListSelection()` Clear any current list selection.
open View.OnTouchListener!	`createDragToOpenListener(src: View!)` Returns an `OnTouchListener` that can be added to the source view to implement drag-to-open behavior.
open Unit	`dismiss()` Dismiss the popup window.
open View?	`getAnchorView()` Returns the view that will be used to anchor this popup.
open Int	`getAnimationStyle()` Returns the animation style that will be used when the popup window is shown or dismissed.
open Drawable?	`getBackground()`
open Rect?	`getEpicenterBounds()` Returns bounds which are used as a popup's epicenter of the enter and exit transitions.
open Int	`getHeight()`
open Int	`getHorizontalOffset()`
open Int	`getInputMethodMode()` Return the current value in `setInputMethodMode(int)`.
open ListView?	`getListView()`
open Int	`getPromptPosition()`
open Any?	`getSelectedItem()`
open Long	`getSelectedItemId()`
open Int	`getSelectedItemPosition()`
open View?	`getSelectedView()`
open Int	`getSoftInputMode()` Returns the current value in `setSoftInputMode(int)`.
open Int	`getVerticalOffset()`
open Int	`getWidth()`
open Boolean	`isInputMethodNotNeeded()`
open Boolean	`isModal()` Returns whether the popup window will be modal when shown.
open Boolean	`isShowing()`
open Boolean	`onKeyDown(keyCode: Int, event: KeyEvent)` Filter key down events.
open Boolean	`onKeyPreIme(keyCode: Int, event: KeyEvent)` Filter pre-IME key events.
open Boolean	`onKeyUp(keyCode: Int, event: KeyEvent)` Filter key up events.
open Boolean	`performItemClick(position: Int)` Perform an item click operation on the specified list adapter position.
open Unit	`postShow()` Post a `show()` call to the UI thread.
open Unit	`setAdapter(adapter: ListAdapter?)` Sets the adapter that provides the data and the views to represent the data in this popup window.
open Unit	`setAnchorView(anchor: View?)` Sets the popup's anchor view.
open Unit	`setAnimationStyle(animationStyle: Int)` Set an animation style to use when the popup window is shown or dismissed.
open Unit	`setBackgroundDrawable(d: Drawable?)` Sets a drawable to be the background for the popup window.
open Unit	`setContentWidth(width: Int)` Sets the width of the popup window by the size of its content.
open Unit	`setDropDownGravity(gravity: Int)` Set the gravity of the dropdown list.
open Unit	`setEpicenterBounds(bounds: Rect?)` Specifies the anchor-relative bounds of the popup's transition epicenter.
open Unit	`setHeight(height: Int)` Sets the height of the popup window in pixels.
open Unit	`setHorizontalOffset(offset: Int)` Set the horizontal offset of this popup from its anchor view in pixels.
open Unit	`setInputMethodMode(mode: Int)` Control how the popup operates with an input method: one of `INPUT_METHOD_FROM_FOCUSABLE`, `INPUT_METHOD_NEEDED`, or `INPUT_METHOD_NOT_NEEDED`.
open Unit	`setListSelector(selector: Drawable!)` Sets a drawable to use as the list item selector.
open Unit	`setModal(modal: Boolean)` Set whether this window should be modal when shown.
open Unit	`setOnDismissListener(listener: PopupWindow.OnDismissListener?)` Set a listener to receive a callback when the popup is dismissed.
open Unit	`setOnItemClickListener(clickListener: AdapterView.OnItemClickListener?)` Sets a listener to receive events when a list item is clicked.
open Unit	`setOnItemSelectedListener(selectedListener: AdapterView.OnItemSelectedListener?)` Sets a listener to receive events when a list item is selected.
open Unit	`setPromptPosition(position: Int)` Set where the optional prompt view should appear.
open Unit	`setPromptView(prompt: View?)` Set a view to act as a user prompt for this popup window.
open Unit	`setSelection(position: Int)` Set the selected position of the list.
open Unit	`setSoftInputMode(mode: Int)` Sets the operating mode for the soft input area.
open Unit	`setVerticalOffset(offset: Int)` Set the vertical offset of this popup from its anchor view in pixels.
open Unit	`setWidth(width: Int)` Sets the width of the popup window in pixels.
open Unit	`setWindowLayoutType(layoutType: Int)` Set the layout type for this popup window.
open Unit	`show()` Show the popup list.

XML attributes

android:dropDownHorizontalOffset

android:dropDownHorizontalOffset

Amount of pixels by which the drop down should be offset horizontally.

May be a dimension value, which is a floating point number appended with a unit such as "14.5sp". Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size), in (inches), and mm (millimeters).

android:dropDownVerticalOffset

android:dropDownVerticalOffset

Amount of pixels by which the drop down should be offset vertically.

Parameters
`context`	Context: Context used for contained views. This value cannot be `null`.
`attrs`	AttributeSet?: Attributes from inflating parent views used to style the popup. This value may be `null`.

Parameters
`keyCode`	Int: keyCode param passed to the host view's onKeyDown
`event`	KeyEvent: event param passed to the host view's onKeyDown This value cannot be `null`.

ListPopupWindow

Summary

XML attributes

android:dropDownHorizontalOffset

android:dropDownVerticalOffset

Constants

INPUT_METHOD_FROM_FOCUSABLE

INPUT_METHOD_NEEDED

INPUT_METHOD_NOT_NEEDED

MATCH_PARENT

POSITION_PROMPT_ABOVE

POSITION_PROMPT_BELOW

WRAP_CONTENT

Public constructors