cn.trinea.android.common.view

Class DropDownListView

java.lang.Object

ListView

cn.trinea.android.common.view.DropDownListView

public class DropDownListView
extends ListView

Listview whick can do something when drop down or scroll to bottom. for example, drop down to refresh and load more when scroll to bottom

DropDown Listener
• define isDropDownStyle="true" at layout xml or call setDropDownStyle(boolean) to enable drop down style before
• setOnDropDownListener(OnDropDownListener) set listener which will be excuted when drop down, but you should call onDropDownComplete() manual at the end of listener to reinstate status.
• setHeaderDefaultText(String), setHeaderLoadingText(String), setHeaderPullText(String), setHeaderReleaseText(String), setHeaderSecondText(CharSequence) to set text

OnBottom Listener
• define isOnBottomStyle="true" at layout xml or call setOnBottomStyle(boolean) to enable on bottom style before
• setOnBottomListener(OnClickListener) set listener which will be excuted when scroll to bottom, but you should call onBottomComplete() manual at the end of listener to reinstate status.
• you can define isAutoLoadOnBottom="true" at layout xml or call setAutoLoadOnBottom(boolean) to enable auto call OnBottomListener when scroll to bottom
• setFooterDefaultText(String), setFooterLoadingText(String), setFooterNoMoreText(String) to set text

other setting see http://www.trinea.cn/?p=523

principle see http://trinea.iteye.com/blog/1562281

Author:

Trinea 2012-5-20

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DropDownListView.OnDropDownListener OnDropDownListener, called when header released

Field Summary

Fields

Modifier and Type	Field and Description
static int	HEADER_STATUS_CLICK_TO_LOAD status which you can click to load, init satus
static int	HEADER_STATUS_DROP_DOWN_TO_LOAD status which you can drop down and then release to excute onDropDownListener, when height of header layout lower than a value
static int	HEADER_STATUS_LOADING status which is loading
static int	HEADER_STATUS_RELEASE_TO_LOAD status which you can release to excute onDropDownListener, when height of header layout higher than a value

Constructor Summary

Constructors

Constructor and Description
DropDownListView(Context context)
DropDownListView(Context context, AttributeSet attrs)
DropDownListView(Context context, AttributeSet attrs, int defStyle)

Method Summary

Methods

Modifier and Type	Method and Description
Button	getFooterButton() get footer button
java.lang.String	getFooterDefaultText() get footer default text, default is R.string.drop_down_list_footer_default_text
RelativeLayout	getFooterLayout() get footer layout view
java.lang.String	getFooterLoadingText() get footer loading text, default is R.string.drop_down_list_footer_loading_text
java.lang.String	getFooterNoMoreText() get footer no more text, default is R.string.drop_down_list_footer_no_more_text
java.lang.String	getHeaderDefaultText() get header default text, default is R.string.drop_down_list_header_default_text
RelativeLayout	getHeaderLayout() get header layout view
java.lang.String	getHeaderLoadingText() get header loading text, default is R.string.drop_down_list_header_loading_text
float	getHeaderPaddingTopRate() get rate about drop down distance and header padding top when drop down
java.lang.String	getHeaderPullText() get header pull text, default is R.string.drop_down_list_header_pull_text
int	getHeaderReleaseMinDistance() get min distance which header can release to loading
java.lang.String	getHeaderReleaseText() get header release text, default is R.string.drop_down_list_header_release_text
boolean	isAutoLoadOnBottom()
boolean	isDropDownStyle()
boolean	isHasMore() get whether has more
boolean	isOnBottomStyle()
boolean	isShowFooterProgressBar() get whether show footer loading progress bar when loading
boolean	isShowFooterWhenNoMore() get isShowFooterWhenNoMore
void	onBottom() on bottom loading, you can call it by manual, but you should manual call onBottomComplete at the same time.
void	onBottomComplete() on bottom load complete, restore view status
void	onDropDown() on drop down loading, you can call it by manual, but you should manual call onBottomComplete at the same time.
void	onDropDownComplete() drop down complete, restore view status
void	onDropDownComplete(java.lang.CharSequence secondText) drop down complete, restore view status
void	onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount)
void	onScrollStateChanged(AbsListView view, int scrollState)
boolean	onTouchEvent(MotionEvent event)
void	setAdapter(ListAdapter adapter)
void	setAutoLoadOnBottom(boolean isAutoLoadOnBottom) set whether auto load when on bottom
void	setDropDownStyle(boolean isDropDownStyle)
void	setFooterDefaultText(java.lang.String footerDefaultText) set footer default text, default is R.string.drop_down_list_footer_default_text
void	setFooterLoadingText(java.lang.String footerLoadingText) set footer loading text, default is R.string.drop_down_list_footer_loading_text
void	setFooterNoMoreText(java.lang.String footerNoMoreText) set footer no more text, default is R.string.drop_down_list_footer_no_more_text
void	setHasMore(boolean hasMore) set whether has more. if hasMore is false, onBottm will not be called when listView scroll to bottom
void	setHeaderDefaultText(java.lang.String headerDefaultText) set header default text, default is R.string.drop_down_list_header_default_text
void	setHeaderLoadingText(java.lang.String headerLoadingText) set header loading text, default is R.string.drop_down_list_header_loading_text
void	setHeaderPaddingTopRate(float headerPaddingTopRate) set rate about drop down distance and header padding top when drop down
void	setHeaderPullText(java.lang.String headerPullText) set header pull text, default is R.string.drop_down_list_header_pull_text
void	setHeaderReleaseMinDistance(int headerReleaseMinDistance) set min distance which header can release to loading
void	setHeaderReleaseText(java.lang.String headerReleaseText) set header release text, default is R.string.drop_down_list_header_release_text
void	setHeaderSecondText(java.lang.CharSequence secondText) set header second text
void	setOnBottomListener(OnClickListener onBottomListener)
void	setOnBottomStyle(boolean isOnBottomStyle)
void	setOnDropDownListener(DropDownListView.OnDropDownListener onDropDownListener)
void	setOnScrollListener(AbsListView.OnScrollListener listener)
void	setSecondPositionVisible() set second position visible(index is 1), because first position is header layout
void	setShowFooterProgressBar(boolean isShowFooterProgressBar) set whether show footer loading progress bar when loading
void	setShowFooterWhenNoMore(boolean isShowFooterWhenNoMore) set isShowFooterWhenNoMore

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

HEADER_STATUS_CLICK_TO_LOAD

public static final int HEADER_STATUS_CLICK_TO_LOAD

status which you can click to load, init satus

See Also:

Constant Field Values

HEADER_STATUS_DROP_DOWN_TO_LOAD

public static final int HEADER_STATUS_DROP_DOWN_TO_LOAD

status which you can drop down and then release to excute onDropDownListener, when height of header layout lower than a value

See Also:

Constant Field Values

HEADER_STATUS_RELEASE_TO_LOAD

public static final int HEADER_STATUS_RELEASE_TO_LOAD

status which you can release to excute onDropDownListener, when height of header layout higher than a value

See Also:

Constant Field Values

HEADER_STATUS_LOADING

public static final int HEADER_STATUS_LOADING

status which is loading

See Also:

Constant Field Values

Constructor Detail

DropDownListView

public DropDownListView(Context context)

DropDownListView

public DropDownListView(Context context,
                AttributeSet attrs)

DropDownListView

public DropDownListView(Context context,
                AttributeSet attrs,
                int defStyle)

Method Detail

isDropDownStyle

public boolean isDropDownStyle()

Returns:

isDropDownStyle

setDropDownStyle

public void setDropDownStyle(boolean isDropDownStyle)

Parameters:

isDropDownStyle -

isOnBottomStyle

public boolean isOnBottomStyle()

Returns:

isOnBottomStyle

setOnBottomStyle

public void setOnBottomStyle(boolean isOnBottomStyle)

Parameters:

isOnBottomStyle -

isAutoLoadOnBottom

public boolean isAutoLoadOnBottom()

Returns:

isAutoLoadOnBottom

setAutoLoadOnBottom

public void setAutoLoadOnBottom(boolean isAutoLoadOnBottom)

set whether auto load when on bottom

Parameters:

isAutoLoadOnBottom -

isShowFooterProgressBar

public boolean isShowFooterProgressBar()

get whether show footer loading progress bar when loading

Returns:

the isShowFooterProgressBar

setShowFooterProgressBar

public void setShowFooterProgressBar(boolean isShowFooterProgressBar)

set whether show footer loading progress bar when loading

Parameters:

isShowFooterProgressBar -

isShowFooterWhenNoMore

public boolean isShowFooterWhenNoMore()

get isShowFooterWhenNoMore

Returns:

the isShowFooterWhenNoMore

setShowFooterWhenNoMore

public void setShowFooterWhenNoMore(boolean isShowFooterWhenNoMore)

set isShowFooterWhenNoMore

Parameters:

isShowFooterWhenNoMore - the isShowFooterWhenNoMore to set

getFooterButton

public Button getFooterButton()

get footer button

Returns:

setAdapter

public void setAdapter(ListAdapter adapter)

setOnScrollListener

public void setOnScrollListener(AbsListView.OnScrollListener listener)

setOnDropDownListener

public void setOnDropDownListener(DropDownListView.OnDropDownListener onDropDownListener)

Parameters:

onDropDownListener -

setOnBottomListener

public void setOnBottomListener(OnClickListener onBottomListener)

Parameters:

onBottomListener -

onTouchEvent

public boolean onTouchEvent(MotionEvent event)

onScroll

public void onScroll(AbsListView view,
            int firstVisibleItem,
            int visibleItemCount,
            int totalItemCount)

onScrollStateChanged

public void onScrollStateChanged(AbsListView view,
                        int scrollState)

onDropDown

public void onDropDown()

on drop down loading, you can call it by manual, but you should manual call onBottomComplete at the same time.

onDropDownComplete

public void onDropDownComplete(java.lang.CharSequence secondText)

drop down complete, restore view status

Parameters:

secondText - display below header text, if null, not display

setHeaderSecondText

public void setHeaderSecondText(java.lang.CharSequence secondText)

set header second text

Parameters:

secondText - secondText display below header text, if null, not display

onDropDownComplete

public void onDropDownComplete()

drop down complete, restore view status

onBottom

public void onBottom()

on bottom loading, you can call it by manual, but you should manual call onBottomComplete at the same time.

onBottomComplete

public void onBottomComplete()

on bottom load complete, restore view status

setSecondPositionVisible

public void setSecondPositionVisible()

set second position visible(index is 1), because first position is header layout

setHasMore

public void setHasMore(boolean hasMore)

set whether has more. if hasMore is false, onBottm will not be called when listView scroll to bottom

Parameters:

hasMore -

isHasMore

public boolean isHasMore()

get whether has more

Returns:

getHeaderLayout

public RelativeLayout getHeaderLayout()

get header layout view

Returns:

getFooterLayout

public RelativeLayout getFooterLayout()

get footer layout view

Returns:

getHeaderPaddingTopRate

public float getHeaderPaddingTopRate()

get rate about drop down distance and header padding top when drop down

Returns:

headerPaddingTopRate

setHeaderPaddingTopRate

public void setHeaderPaddingTopRate(float headerPaddingTopRate)

set rate about drop down distance and header padding top when drop down

Parameters:

headerPaddingTopRate -

getHeaderReleaseMinDistance

public int getHeaderReleaseMinDistance()

get min distance which header can release to loading

Returns:

headerReleaseMinDistance

setHeaderReleaseMinDistance

public void setHeaderReleaseMinDistance(int headerReleaseMinDistance)

set min distance which header can release to loading

Parameters:

headerReleaseMinDistance -

getHeaderDefaultText

public java.lang.String getHeaderDefaultText()

get header default text, default is R.string.drop_down_list_header_default_text

Returns:

setHeaderDefaultText

public void setHeaderDefaultText(java.lang.String headerDefaultText)

set header default text, default is R.string.drop_down_list_header_default_text

Parameters:

headerDefaultText -

getHeaderPullText

public java.lang.String getHeaderPullText()

get header pull text, default is R.string.drop_down_list_header_pull_text

Returns:

setHeaderPullText

public void setHeaderPullText(java.lang.String headerPullText)

set header pull text, default is R.string.drop_down_list_header_pull_text

Parameters:

headerPullText -

getHeaderReleaseText

public java.lang.String getHeaderReleaseText()

get header release text, default is R.string.drop_down_list_header_release_text

Returns:

setHeaderReleaseText

public void setHeaderReleaseText(java.lang.String headerReleaseText)

set header release text, default is R.string.drop_down_list_header_release_text

Parameters:

headerReleaseText -

getHeaderLoadingText

public java.lang.String getHeaderLoadingText()

get header loading text, default is R.string.drop_down_list_header_loading_text

Returns:

setHeaderLoadingText

public void setHeaderLoadingText(java.lang.String headerLoadingText)

set header loading text, default is R.string.drop_down_list_header_loading_text

Parameters:

headerLoadingText -

getFooterDefaultText

public java.lang.String getFooterDefaultText()

get footer default text, default is R.string.drop_down_list_footer_default_text

Returns:

setFooterDefaultText

public void setFooterDefaultText(java.lang.String footerDefaultText)

set footer default text, default is R.string.drop_down_list_footer_default_text

Parameters:

footerDefaultText -

getFooterLoadingText

public java.lang.String getFooterLoadingText()

get footer loading text, default is R.string.drop_down_list_footer_loading_text

Returns:

setFooterLoadingText

public void setFooterLoadingText(java.lang.String footerLoadingText)

set footer loading text, default is R.string.drop_down_list_footer_loading_text

Parameters:

footerLoadingText -

getFooterNoMoreText

public java.lang.String getFooterNoMoreText()

get footer no more text, default is R.string.drop_down_list_footer_no_more_text

Returns:

setFooterNoMoreText

public void setFooterNoMoreText(java.lang.String footerNoMoreText)

set footer no more text, default is R.string.drop_down_list_footer_no_more_text

Parameters:

footerNoMoreText -