Customisation

Customisation

There are a number of ways to customise the way that PullToRefresh behaves and looks.

XML Attributes

There are a number of XML attributes you can use, the best way is to look at the attrs.xml file. Here I'll give a quick overview of the main ones:

• ptrAdapterViewBackground. Background to the AdapterView.
• ptrHeaderBackground. Background of the Header/Footer Views.
• ptrHeaderTextColor. Text Colour of the top line of text in the Header/Footer Views.
• ptrHeaderSubTextColor. Text Colour of the bottom line of text in the Header/Footer Views.
• ptrMode. Sets the Mode in which the Views will operate. Values are either pullDownFromTop, pullUpFromBottom or both. Defaults to pullDownFromTop.
• ptrShowIndicator. Whether to show the Indicators showing the user whether a Pull-to-Refresh is possible. Defaults to true.
• ptrDrawable. Drawable to show in the Header/Footer Views. Defaults to a refresh icon.
• ptrOverScroll. Whether OverScroll support is enabled. Only takes affect when running on Android v2.3+ Defaults to true.
• ptrHeaderTextAppearance. Sets the TextAppearance attribute on the upper TextView.
• ptrSubHeaderTextAppearance. Sets the TextAppearance attribute on the lower TextView.

Method Calls

There are also a number of methods available, most of which accompany the XML attributes above. The easiest way to see these is by Interface source file which contains all of the PullToRefresh related methods, and their Javadoc:

IPullToRefresh.java