├── .gitignore
├── AndroidManifest.xml
├── README
├── build.xml
├── local.properties
├── proguard-project.txt
├── project.properties
├── res
    ├── drawable-mdpi
    │   ├── message_read_status_read.png
    │   └── message_read_status_unread.png
    ├── drawable
    │   ├── message_list_item_background.xml
    │   └── message_read_status.xml
    ├── layout
    │   └── message_list_item.xml
    └── values
    │   ├── attrs.xml
    │   └── colors.xml
└── src
    └── com
        └── charlesharley
            └── example
                └── android
                    └── customdrawablestates
                        ├── HomeActivity.java
                        └── MessageListItemView.java


/.gitignore:
--------------------------------------------------------------------------------
1 | # IntelliJ IDEA project files
2 | *.iml
3 | .idea
4 | 
5 | # Build directories
6 | gen
7 | out
8 | bin
9 | 


--------------------------------------------------------------------------------
/AndroidManifest.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <manifest xmlns:android="http://schemas.android.com/apk/res/android"
 3 |           package="com.charlesharley.example.android.customdrawablestates"
 4 |           android:versionCode="1"
 5 |           android:versionName="1.0"
 6 |           >
 7 | 
 8 |     <uses-sdk android:minSdkVersion="7" android:targetSdkVersion="15" />
 9 | 
10 |     <application android:label="Custom Drawable States Example">
11 | 
12 |         <activity android:name="HomeActivity">
13 |             <intent-filter>
14 |                 <action android:name="android.intent.action.MAIN" />
15 |                 <category android:name="android.intent.category.LAUNCHER" />
16 |             </intent-filter>
17 |         </activity>
18 | 
19 |     </application>
20 | 
21 | </manifest>
22 | 


--------------------------------------------------------------------------------
/README:
--------------------------------------------------------------------------------
1 | Example Android application demonstrating how to use custom drawable states to enhance your Android application with minimal effort.
2 | 
3 | See this tutorial for further details:
4 | 
5 | Icons used are from the FatCow icon set, http://www.fatcow.com/free-icons


--------------------------------------------------------------------------------
/build.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project name="Custom Drawable States Example" default="help">
 3 | 
 4 |     <!-- The local.properties file is created and updated by the 'android' tool.
 5 |          It contains the path to the SDK. It should *NOT* be checked into
 6 |          Version Control Systems. -->
 7 |     <property file="local.properties" />
 8 | 
 9 |     <!-- The ant.properties file can be created by you. It is only edited by the
10 |          'android' tool to add properties to it.
11 |          This is the place to change some Ant specific build properties.
12 |          Here are some properties you may want to change/update:
13 | 
14 |          source.dir
15 |              The name of the source directory. Default is 'src'.
16 |          out.dir
17 |              The name of the output directory. Default is 'bin'.
18 | 
19 |          For other overridable properties, look at the beginning of the rules
20 |          files in the SDK, at tools/ant/build.xml
21 | 
22 |          Properties related to the SDK location or the project target should
23 |          be updated using the 'android' tool with the 'update' action.
24 | 
25 |          This file is an integral part of the build system for your
26 |          application and should be checked into Version Control Systems.
27 | 
28 |          -->
29 |     <property file="ant.properties" />
30 | 
31 |     <!-- The project.properties file is created and updated by the 'android'
32 |          tool, as well as ADT.
33 | 
34 |          This contains project specific properties such as project target, and library
35 |          dependencies. Lower level build properties are stored in ant.properties
36 |          (or in .classpath for Eclipse projects).
37 | 
38 |          This file is an integral part of the build system for your
39 |          application and should be checked into Version Control Systems. -->
40 |     <loadproperties srcFile="project.properties" />
41 | 
42 |     <!-- quick check on sdk.dir -->
43 |     <fail
44 |             message="sdk.dir is missing. Make sure to generate local.properties using 'android update project' or to inject it through an env var"
45 |             unless="sdk.dir"
46 |     />
47 | 
48 |     <!--
49 |         Import per project custom build rules if present at the root of the project.
50 |         This is the place to put custom intermediary targets such as:
51 |             -pre-build
52 |             -pre-compile
53 |             -post-compile (This is typically used for code obfuscation.
54 |                            Compiled code location: ${out.classes.absolute.dir}
55 |                            If this is not done in place, override ${out.dex.input.absolute.dir})
56 |             -post-package
57 |             -post-build
58 |             -pre-clean
59 |     -->
60 |     <import file="custom_rules.xml" optional="true" />
61 | 
62 |     <!-- Import the actual build file.
63 | 
64 |          To customize existing targets, there are two options:
65 |          - Customize only one target:
66 |              - copy/paste the target into this file, *before* the
67 |                <import> task.
68 |              - customize it to your needs.
69 |          - Customize the whole content of build.xml
70 |              - copy/paste the content of the rules files (minus the top node)
71 |                into this file, replacing the <import> task.
72 |              - customize to your needs.
73 | 
74 |          ***********************
75 |          ****** IMPORTANT ******
76 |          ***********************
77 |          In all cases you must update the value of version-tag below to read 'custom' instead of an integer,
78 |          in order to avoid having your file be overridden by tools such as "android update project"
79 |     -->
80 |     <!-- version-tag: 1 -->
81 |     <import file="${sdk.dir}/tools/ant/build.xml" />
82 | 
83 | </project>
84 | 


--------------------------------------------------------------------------------
/local.properties:
--------------------------------------------------------------------------------
 1 | # This file is automatically generated by Android Tools.
 2 | # Do not modify this file -- YOUR CHANGES WILL BE ERASED!
 3 | #
 4 | # This file must *NOT* be checked into Version Control Systems,
 5 | # as it contains information specific to your local configuration.
 6 | 
 7 | # location of the SDK. This is only used by Ant
 8 | # For customization when using a Version Control System, please read the
 9 | # header note.
10 | sdk.dir=/Applications/AndroidSDK
11 | 


--------------------------------------------------------------------------------
/proguard-project.txt:
--------------------------------------------------------------------------------
 1 | # To enable ProGuard in your project, edit project.properties
 2 | # to define the proguard.config property as described in that file.
 3 | #
 4 | # Add project specific ProGuard rules here.
 5 | # By default, the flags in this file are appended to flags specified
 6 | # in ${sdk.dir}/tools/proguard/proguard-android.txt
 7 | # You can edit the include path and order by changing the ProGuard
 8 | # include property in project.properties.
 9 | #
10 | # For more details, see
11 | #   http://developer.android.com/guide/developing/tools/proguard.html
12 | 
13 | # Add any project specific keep options here:
14 | 
15 | # If your project uses WebView with JS, uncomment the following
16 | # and specify the fully qualified class name to the JavaScript interface
17 | # class:
18 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
19 | #   public *;
20 | #}
21 | 


--------------------------------------------------------------------------------
/project.properties:
--------------------------------------------------------------------------------
 1 | # This file is automatically generated by Android Tools.
 2 | # Do not modify this file -- YOUR CHANGES WILL BE ERASED!
 3 | #
 4 | # This file must be checked in Version Control Systems.
 5 | #
 6 | # To customize properties used by the Ant build system edit
 7 | # "ant.properties", and override values to adapt the script to your
 8 | # project structure.
 9 | #
10 | # To enable ProGuard to shrink and obfuscate your code, uncomment this (available properties: sdk.dir, user.home):
11 | #proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt:proguard-project.txt
12 | 
13 | # Project target.
14 | target=android-15
15 | 


--------------------------------------------------------------------------------
/res/drawable-mdpi/message_read_status_read.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CharlesHarley/Example-Android-CustomDrawableStates/a8b9ed7d1fc2bced6b98e1c399416ce4f56b1243/res/drawable-mdpi/message_read_status_read.png


--------------------------------------------------------------------------------
/res/drawable-mdpi/message_read_status_unread.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/CharlesHarley/Example-Android-CustomDrawableStates/a8b9ed7d1fc2bced6b98e1c399416ce4f56b1243/res/drawable-mdpi/message_read_status_unread.png


--------------------------------------------------------------------------------
/res/drawable/message_list_item_background.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <selector xmlns:android="http://schemas.android.com/apk/res/android"
 3 |           xmlns:example="http://schemas.android.com/apk/res/com.charlesharley.example.android.customdrawablestates"
 4 |           >
 5 | 
 6 |     <!--
 7 |     We make the pressed and focused selector items transparent so the ListView's own selector states show through.
 8 |     -->
 9 | 
10 |     <item android:state_pressed="true"
11 |           android:drawable="@android:color/transparent"
12 |           />
13 | 
14 |     <item android:state_focused="true"
15 |           android:drawable="@android:color/transparent"
16 |           />
17 | 
18 |     <item example:state_message_unread="true"
19 |           android:drawable="@color/message_list_item_background_unread"
20 |           />
21 | 
22 | </selector>


--------------------------------------------------------------------------------
/res/drawable/message_read_status.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <selector xmlns:android="http://schemas.android.com/apk/res/android"
 3 |           xmlns:example="http://schemas.android.com/apk/res/com.charlesharley.example.android.customdrawablestates"
 4 |           android:constantSize="true"
 5 |           >
 6 | 
 7 |     <item example:state_message_unread="true"
 8 |           android:drawable="@drawable/message_read_status_unread"
 9 |           />
10 | 
11 |     <item android:drawable="@drawable/message_read_status_read" />
12 | 
13 | </selector>


--------------------------------------------------------------------------------
/res/layout/message_list_item.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | 
 3 | <!-- Expecting to be merged into a RelativeLayout. -->
 4 | <merge xmlns:android="http://schemas.android.com/apk/res/android">
 5 | 
 6 |     <ImageView
 7 |         android:id="@+id/message_read_status"
 8 |         android:layout_width="32dp"
 9 |         android:layout_height="fill_parent"
10 |         android:layout_alignParentLeft="true"
11 |         android:layout_centerVertical="true"
12 |         android:layout_marginRight="5dp"
13 |         android:src="@drawable/message_read_status"
14 |         android:duplicateParentState="true"
15 |         />
16 | 
17 |     <TextView
18 |         android:id="@+id/message_subject"
19 |         android:layout_width="wrap_content"
20 |         android:layout_height="fill_parent"
21 |         android:layout_centerVertical="true"
22 |         android:layout_toRightOf="@id/message_read_status"
23 |         android:gravity="center_vertical"
24 |         android:textSize="18sp"
25 |         android:textColor="@android:color/white"
26 |         />
27 | 
28 | </merge>


--------------------------------------------------------------------------------
/res/values/attrs.xml:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="utf-8"?>
2 | <resources>
3 | 
4 |     <declare-styleable name="MessageState">
5 |         <attr name="state_message_unread" format="boolean"/>
6 |     </declare-styleable>
7 | 
8 | </resources>


--------------------------------------------------------------------------------
/res/values/colors.xml:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="utf-8"?>
2 | <resources>
3 | 
4 |     <color name="message_list_item_background_unread">#ff274172</color>
5 | 
6 | </resources>


--------------------------------------------------------------------------------
/src/com/charlesharley/example/android/customdrawablestates/HomeActivity.java:
--------------------------------------------------------------------------------
 1 | /* Copyright 2012 Charles Harley
 2 |  *
 3 |  * Licensed under the Apache License, Version 2.0 (the "License");
 4 |  * you may not use this file except in compliance with the License.
 5 |  * You may obtain a copy of the License at
 6 |  *
 7 |  *     http://www.apache.org/licenses/LICENSE-2.0
 8 |  *
 9 |  * Unless required by applicable law or agreed to in writing, software
10 |  * distributed under the License is distributed on an "AS IS" BASIS,
11 |  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 |  * See the License for the specific language governing permissions and
13 |  * limitations under the License.
14 |  */
15 | package com.charlesharley.example.android.customdrawablestates;
16 | 
17 | import android.app.ListActivity;
18 | import android.os.Bundle;
19 | import android.view.View;
20 | import android.view.ViewGroup;
21 | import android.widget.BaseAdapter;
22 | 
23 | public class HomeActivity extends ListActivity {
24 | 
25 |     @Override
26 |     public void onCreate(Bundle savedInstanceState) {
27 |         super.onCreate(savedInstanceState);
28 | 
29 |         setListAdapter(new ExampleListAdapter());
30 |     }
31 | 
32 |     private static class ExampleListAdapter extends BaseAdapter {
33 | 
34 |         private Message[] messages;
35 | 
36 |         private ExampleListAdapter() {
37 |             messages = new Message[] {
38 |                     new Message("Gas bill overdue", true),
39 |                     new Message("Congratulations, you've won!", true),
40 |                     new Message("I love you!", false),
41 |                     new Message("Please reply!", false),
42 |                     new Message("You ignoring me?", false),
43 |                     new Message("Not heard from you", false),
44 |                     new Message("Electricity bill", true),
45 |                     new Message("Gas bill", true),
46 |                     new Message("Holiday plans", false),
47 |                     new Message("Marketing stuff", false),
48 |             };
49 |         }
50 | 
51 |         @Override
52 |         public int getCount() {
53 |             return messages.length;
54 |         }
55 | 
56 |         @Override
57 |         public Object getItem(int position) {
58 |             return messages[position];
59 |         }
60 | 
61 |         @Override
62 |         public long getItemId(int position) {
63 |             return position;
64 |         }
65 | 
66 |         @Override
67 |         public View getView(int position, View convertView, ViewGroup viewGroup) {
68 |             MessageListItemView messageListItemView = (MessageListItemView) convertView;
69 | 
70 |             if (messageListItemView == null) {
71 |                 messageListItemView = new MessageListItemView(viewGroup.getContext());
72 |             }
73 | 
74 |             Message message = (Message) getItem(position);
75 |             messageListItemView.setMessageSubject(message.subject);
76 |             messageListItemView.setMessageUnread(message.unread);
77 | 
78 |             return messageListItemView;
79 |         }
80 | 
81 |     }
82 | 
83 |     private static class Message {
84 | 
85 |         private String subject;
86 |         private boolean unread;
87 | 
88 |         private Message(String subject, boolean unread) {
89 |             this.subject = subject;
90 |             this.unread = unread;
91 |         }
92 | 
93 |     }
94 | 
95 | }
96 | 


--------------------------------------------------------------------------------
/src/com/charlesharley/example/android/customdrawablestates/MessageListItemView.java:
--------------------------------------------------------------------------------
  1 | /* Copyright 2012 Charles Harley
  2 |  *
  3 |  * Licensed under the Apache License, Version 2.0 (the "License");
  4 |  * you may not use this file except in compliance with the License.
  5 |  * You may obtain a copy of the License at
  6 |  *
  7 |  *     http://www.apache.org/licenses/LICENSE-2.0
  8 |  *
  9 |  * Unless required by applicable law or agreed to in writing, software
 10 |  * distributed under the License is distributed on an "AS IS" BASIS,
 11 |  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 12 |  * See the License for the specific language governing permissions and
 13 |  * limitations under the License.
 14 |  */
 15 | package com.charlesharley.example.android.customdrawablestates;
 16 | 
 17 | import android.content.Context;
 18 | import android.util.AttributeSet;
 19 | import android.util.DisplayMetrics;
 20 | import android.util.TypedValue;
 21 | import android.view.LayoutInflater;
 22 | import android.view.ViewGroup;
 23 | import android.widget.AbsListView;
 24 | import android.widget.RelativeLayout;
 25 | import android.widget.TextView;
 26 | 
 27 | public class MessageListItemView extends RelativeLayout {
 28 | 
 29 |     /**
 30 |      * Custom message unread state variable for use with a {@link android.graphics.drawable.StateListDrawable}.
 31 |      */
 32 |     private static final int[] STATE_MESSAGE_UNREAD = {R.attr.state_message_unread};
 33 | 
 34 |     private TextView messageSubject;
 35 |     private boolean messageUnread;
 36 | 
 37 |     public MessageListItemView(Context context) {
 38 |         this(context, null);
 39 |     }
 40 | 
 41 |     public MessageListItemView(Context context, AttributeSet attributeSet) {
 42 |         super(context, attributeSet);
 43 | 
 44 |         loadViews();
 45 |     }
 46 | 
 47 |     public MessageListItemView(Context context, AttributeSet attributeSet, int defStyle) {
 48 |         super(context, attributeSet, defStyle);
 49 | 
 50 |         loadViews();
 51 |     }
 52 | 
 53 |     private void loadViews() {
 54 |         LayoutInflater layoutInflater = (LayoutInflater) getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE);
 55 |         layoutInflater.inflate(R.layout.message_list_item, this, true);
 56 | 
 57 |         int fiveDPInPixels = convertDIPToPixels(5);
 58 |         int fiftyDPInPixels = convertDIPToPixels(50);
 59 | 
 60 |         setPadding(fiveDPInPixels, fiveDPInPixels, fiveDPInPixels, fiveDPInPixels);
 61 |         setLayoutParams(new AbsListView.LayoutParams(ViewGroup.LayoutParams.FILL_PARENT, fiftyDPInPixels));
 62 |         setBackgroundResource(R.drawable.message_list_item_background);
 63 | 
 64 |         messageSubject = (TextView) findViewById(R.id.message_subject);
 65 |     }
 66 | 
 67 |     public int convertDIPToPixels(int dip) {
 68 |         // In production code this method would exist in a utility library.
 69 |         // e.g see my ScreenUtils class: https://gist.github.com/2504204
 70 |         DisplayMetrics displayMetrics = getContext().getResources().getDisplayMetrics();
 71 |         return (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, dip, displayMetrics);
 72 |     }
 73 | 
 74 |     @Override
 75 |     protected int[] onCreateDrawableState(int extraSpace) {
 76 |         // If the message is unread then we merge our custom message unread state into
 77 |         // the existing drawable state before returning it.
 78 |         if (messageUnread) {
 79 |             // We are going to add 1 extra state.
 80 |             final int[] drawableState = super.onCreateDrawableState(extraSpace + 1);
 81 | 
 82 |             mergeDrawableStates(drawableState, STATE_MESSAGE_UNREAD);
 83 | 
 84 |             return drawableState;
 85 |         } else {
 86 |             return super.onCreateDrawableState(extraSpace);
 87 |         }
 88 |     }
 89 | 
 90 |     public void setMessageSubject(String subject) {
 91 |         messageSubject.setText(subject);
 92 |     }
 93 | 
 94 |     public void setMessageUnread(boolean messageUnread) {
 95 |         // Performance optimisation: only update the state if it has changed.
 96 |         if (this.messageUnread != messageUnread) {
 97 |             this.messageUnread = messageUnread;
 98 | 
 99 |             // Refresh the drawable state so that it includes the message unread state if required.
100 |             refreshDrawableState();
101 |         }
102 |     }
103 | 
104 | }
105 | 


--------------------------------------------------------------------------------