Spinner下拉列表.doc

Spinner下拉列表extends AbsSpinnerimplements DialogInterface.OnClickListenerjava.lang.Object android.view.View android.view.ViewGroup android.widget.AdapterView android.widget.AbsSpinner android.widget.SpinnerKnown Direct SubclassesAppCompatSpinnerClass OverviewA view that displays one child at a time and lets the user pick among them. The items in the Spinner come from the Adapter associated with this view.See the Spinners guide.SummaryXML AttributesAttribute NameRelated MethodDescriptionandroid:dropDownHorizontalOffsetsetDropDownHorizontalOffset(int)Amount of pixels by which the drop down should be offset horizontally. android:dropDownSelectorList selector to use for spinnerMode=dropdown display. android:dropDownVerticalOffsetsetDropDownVerticalOffset(int)Amount of pixels by which the drop down should be offset vertically. android:dropDownWidthsetDropDownWidth(int)Width of the dropdown in spinnerMode=dropdown. android:gravitysetGravity(int)Gravity setting for positioning the currently selected item. android:popupBackgroundsetPopupBackgroundResource(int)Background drawable to use for the dropdown in spinnerMode=dropdown. android:promptThe prompt to display when the spinners dialog is shown. android:spinnerModeDisplay mode for spinner options. ExpandInherited XML AttributesFrom class android.widget.AbsSpinnerFrom class android.view.ViewGroupFrom class android.view.ViewConstantsintMODE_DIALOGUse a dialog window for selecting spinner MODE_DROPDOWNUse a dropdown anchored to the Spinner for selecting spinner options.ExpandInherited ConstantsFrom class android.widget.AdapterViewFrom class android.view.ViewGroupFrom class android.view.ViewExpandInherited FieldsFrom class android.view.ViewPublic ConstructorsSpinner(Context context)Construct a new spinner with the given contexts theme.Spinner(Context context, int mode)Construct a new spinner with the given contexts theme and the supplied mode of displaying choices.Spinner(Context context, AttributeSet attrs)Construct a new spinner with the given contexts theme and the supplied attribute set.Spinner(Context context, AttributeSet attrs, int defStyleAttr)Construct a new spinner with the given contexts theme, the supplied attribute set, and default style attribute.Spinner(Context context, AttributeSet attrs, int defStyleAttr, int mode)Construct a new spinner with the given contexts theme, the supplied attribute set, and default style.Spinner(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes, int mode)Construct a new spinner with the given contexts theme, the supplied attribute set, and default style.Spinner(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes, int mode, Resources.Theme popupTheme)Constructs a new spinner with the given contexts theme, the supplied attribute set, default styles, popup mode (one of MODE_DIALOG or MODE_DROPDOWN), and the context against which the popup should be inflated.Public MethodsCharSequencegetAccessibilityClassName()Return the class name of this object to be used for accessibility getBaseline()Return the offset of the widgets text baseline from the widgets top getDropDownHorizontalOffset()Get the configured horizontal offset in pixels for the spinners popup window of getDropDownVerticalOffset()Get the configured vertical offset in pixels for the spinners popup window of getDropDownWidth()Get the configured width of the spinners popup window of choices in getGravity()Describes how the selected item view is positioned.DrawablegetPopupBackground()Get the background drawable for the spinners popup window of choices.ContextgetPopupContext()CharSequencegetPrompt()voidonClick(DialogInterface dialog, int which)This method will be invoked when a button in the dialog is clicked.voidonRestoreInstanceState(Parcelable state)Hook allowing a view to re-apply a representation of its internal state that had previously been generated by onSaveInstanceState().ParcelableonSaveInstanceState()Hook allowing a view to generate a representation of its internal state that can later be used to create a new instance with that same state.booleanonTouchEvent(MotionEvent event)Implement this method to handle touch screen motion events.booleanperformClick()Call this views OnClickListener, if it is defined.voidsetAdapter(SpinnerAdapter adapter)Sets the SpinnerAdapter used to provide the data which backs this Spinner.voidsetDropDownHorizontalOffset(int pixels)Set a horizontal offset in pixels for the spinners popup window of choices.voidsetDropDownVerticalOffset(int pixels)Set a vertical offset in pixels for the spinners popup window of choices.voidsetDropDownWidth(int pixels)Set the width of the spinners popup window of choices in pixels.voidsetEnabled(boolean enabled)Set the enabled state of this view.voidsetGravity(int gravity)Describes how the selected item view is positioned.voidsetOnItemClickListener(AdapterView.OnItemClickListener l)A spinner does not support item click events.voidsetPopupBackgroundDrawable(Drawable background)Set the background drawable for the spinners popup window of choices.voidsetPopupBackgroundResource(int resId)Set the background drawable for the spinners popup window of choices.voidsetPrompt(CharSequence prompt)Sets the prompt to display when the dialog is shown.voidsetPromptId(int promptId)Sets the prompt to display when the dialog is shown.Protected MethodsvoidonDetachedFromWindow()This is called when the view is detached from a window.voidonLayout(boolean changed, int l, int t, int r, int b)Called from layout when this view should assign a size and position to each of its children.voidonMeasure(int widthMeasureSpec, int heightMeasureSpec)Measure the view and its content to determine the measured width and the measured height.ExpandInherited Methods From class android.widget.AbsSpinner From class android.widget.AdapterView From class android.view.ViewGroup From class android.view.View From class java.lang.Object From interface android.view.ViewParent From interface android.view.ViewManager From interface android.graphics.drawable.Drawable.Callback From interface android.view.KeyEvent.Callback From interface android.view.accessibility.AccessibilityEventSource From interface android.content.DialogInterface.OnClickListenerXML Attributesandroid:dropDownHorizontalOffsetAmount of pixels by which the drop down should be offset horizontally.Must 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), mm (millimeters).This may also be a reference to a resource (in the form package:type:name) or theme attribute (in the form ?package:type:name) containing a value of this type.This corresponds to the global attribute resource symbol dropDownHorizontalOffset.Related MethodssetDropDownHorizontalOffset(int)android:dropDownSelectorList selector to use for spinnerMode=dropdown display.May be a reference to another resource, in the form +package:type:name or to a theme attribute in the form ?package:type:name.May be a color value, in the form of #rgb, #argb, #rrggbb, or #aarrggbb.This corresponds to the global attribute resource symbol dropDownSelector.Related Methodsandroid:dropDownVerticalOffsetAmount of pixels by which the drop down should be offset vertically.Must 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), mm (millimeters).This may also be a reference to a resource (in the form package:type:name) or theme attribute (in the form ?package:type:name) containing a value of this type.This corresponds to the global attribute resource symbol dropDownVerticalOffset.Related MethodssetDropDownVerticalOffset(int)android:dropDownWidthWidth of the dropdown in spinnerMode=dropdown.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), mm (millimeters).This may also be a reference to a resource (in the form package:type:name) or theme attribute (in the form ?package:type:name) containing a value of this type.May be one of the following constant values.ConstantValueDescriptionfill_parent-1The dropdown should fill the width of the screen. This constant is deprecated starting from API Level 8 and is replaced by match_parent.match_parent-1The dropdown should fit the width of the screen. Introduced in API Level 8.wrap_content-2The dropdown should fit the width of its anchor.This corresponds to the global attribute resource symbol dropDownWidth.Related MethodssetDropDownWidth(int)android:gravityGravity setting for positioning the currently selected item.Must be one or more (separated by |) of the following constant values.ConstantValueDescriptiontop0x30Push object to the top of its container, not changing its size.bottom0x50Push object to the bottom of its container, not changing its size.left0x03Push object to the left of its container, not changing its size.right0x05Push object to the right of its container, not changing its size.center_vertical0x10Place object in the vertical center of its container, not changing its size.fill_vertical0x70Grow the vertical size of the object if needed so it completely fills its container.center_horizontal0x01Place object in the horizontal center of its container, not changing its size.fill_horizontal0x07Grow the horizontal size of the object if needed so it completely fills its container.center0x11Place the object in the center of its container in both the vertical and horizontal axis, not changing its size.fill0x77Grow the horizontal and vertical size of the object if needed so it completely fills its container.clip_vertical0x80Additional option that can be set to have the top and/or bottom edges of the child clipped to its containers bounds. The clip will be based on the vertical gravity: a top gravity will clip the bottom edge, a bottom gravity will clip the top edge, and neither will clip both edges.clip_horizontal0x08Additional option that can be set to have the left and/or right edges of the child clipped to its containers bounds. The clip will be based on the horizontal gravity: a left gravity will clip the right edge, a right gravity will clip the left edge, and neither will clip both edges.start0x00800003Push object to the beginning of its container, not changing its size.end0x00800005Push object to the end of its container, not changing its size.This corresponds to the global attribute resource symbol gravity.Related MethodssetGravity(int)android:popupBackgroundBackground drawable to use for the dropdown in spinnerMode=dropdown.May be a reference to another resource, in the form +package:type:name or to a theme attribute in the form ?package:type:name.May be a color value, in the form of #rgb, #argb, #rrggbb, or #aarrggbb.This corresponds to the global attribute resource symbol popupBackground.Related MethodssetPopupBackgroundResource(int)android:promptThe prompt to display when the spinners dialog is shown.Must be a reference to another resource, in the form +package:type:name or to a theme attribute in the form ?package:type:name.This corresponds to the global attribute resource symbol prompt.Related Methodsandroid:spinnerModeDisplay mode for spinner options.Must be one of the following constant values.ConstantValueDescriptiondialog0Spinner options will be presented to the user as a dialog window.dropdown1Spinner options will be presented to the user as an inline dropdown anchored to the spinner widget itself.This corresponds to the global attribute resource symbol spinnerMode.Related MethodsConstantspublic static final int MODE_DIALOGAdded in API level 11Use a dialog window for selecting spinner options.Constant Value: 0 (0x00000000)public static final int MODE_DROPDOWNAdded in API level 11Use a dropdown anchored to the Spinner for selecting spinner options.Constant Value: 1 (0x00000001)Public Constructorspublic Spinner (Context context)Added in API level 1Construct a new spinner with the given contexts theme.ParameterscontextThe Context the view is running in, through which it can access the current theme, resources, etc.public Spinner (Context context, int mode)Added in API level 11Construct a new spinner with the given contexts theme and the supplied mode of displaying choices. mode may be one of MODE_DIALOG or MODE_DROPDOWN.ParameterscontextThe Context the view is running in, through which it can access the current theme, resources, etc.modeConstant describing how the user will select choices from the spinner.See AlsoMODE_DIALOGMODE_DROPDOWNpublic Spinner (Context context, AttributeSet attrs)Added in API level 1Construct a new spinner with the given contexts theme and the supplied attribute set.ParameterscontextThe Context the view is running in, through which it can access the current theme, resources, etc.attrsThe attributes of the XML tag that is inflating the view.public Spinner (Context context, AttributeSet attrs, int defStyleAttr)Added in API level 1Construct a new spinner with the given contexts theme, the supplied attribute set, and default style attribute.ParameterscontextThe Context the view is running in, through which it can access the current theme, resources, etc.attrsThe attributes of the XML tag that is inflating the view.defStyleAttrAn attribute in the current theme that contains a reference to a style resource that supplies default values for the view. Can be 0 to not look for defaults.public Spinner (Context context, AttributeSet attrs, int defStyleAttr, int mode)Added in API level 11Construct a new spinner with the given contexts theme, the supplied attribute set, and default style. mode may be one of MODE_DIALOG or MODE_DROPDOWN and determines how the user will select choices from the spinner.ParameterscontextThe Context the view is running in, through which it can access the current theme, resources, etc.attrsThe attributes of the XML tag that is inflating the view.defStyleAttrAn attribute in the current theme that contains a reference to a style resource that supplies default values for the view. Can be 0 to not look for defaults.modeConstant describing how the user will select choices from the spinner.See AlsoMODE_DIALOGMODE_DROPDOWNpublic Spinner (Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes, int mode)Added in API level 21Construct a new spinner with the given contexts theme, the supplied attribute set, and default style. mode may be one of MODE_DIALOG or MODE_DROPDOWN and determines how the user will select choices from the spinner.ParameterscontextThe Context the view is running in, through which it can access the current theme, resources, etc.attrsThe attributes of the XML tag that is inflating the view.defStyleAttrAn attribute in the current theme that contains a reference to a style resource that supplies default values for the view. Can be 0 to not look for defaults.defStyleResA resource identifier of a style resource that supplies default values for the view, used only if defStyleAttr is 0 or can not be found in the theme. Can be 0 to not look for defaults.modeConstant describing how the user will select choices from the spinner.See AlsoMODE_DIALOGMODE_DROPDOWNpublic Spinner (Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes, int mode, Resources.Theme popupTheme)Added in API level 23Constructs a new spinner with the given contexts theme, the supplied attribute set, default styles, popup mode (one of MODE_DIALOG or MODE_DROPDOWN), and the context against which the popup should be inflated.ParameterscontextThe context against which the view is inflated, which provides access to the current theme, resources, etc.attrsThe attributes of the XML tag that is inflating the view.defStyleAttrAn attribute in the current theme that contains a reference to a style resource that supplies default values for the view. Can be 0 to not look for defaults.defStyleResA resource identifier of a style resource that supplies default values for the view, used only if defStyleAttr is 0 or can not be found in the theme. Can be 0 to not look for defaults.modeConstant describing how the user will select choices from the spinner.popupThemeThe theme against which the dialog or dropdown popup should be inflated. May be null to use the view theme. If set, this will override any value specified by Spinner_popupTheme.See AlsoMODE_DIALOGMODE_DROPDOWNPublic Methodspublic CharSequence getAccessibilityClassName ()Added in API level 23Return the class name of this object to be used for accessibility purposes. Subclasses should only override this if they are implementing something that should be seen as a completely new class of view wh