1 /* 2 * Copyright (C) 2015 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package android.support.v4.widget; 18 19 import android.graphics.drawable.Drawable; 20 import android.os.Build; 21 import android.support.annotation.NonNull; 22 import android.support.annotation.Nullable; 23 import android.widget.TextView; 24 25 /** 26 * Helper for accessing features in {@link TextView} introduced after API level 27 * 4 in a backwards compatible fashion. 28 */ 29 public class TextViewCompat { 30 31 // Hide constructor TextViewCompat()32 private TextViewCompat() { 33 } 34 35 interface TextViewCompatImpl { 36 setCompoundDrawablesRelative(@onNull TextView textView, @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, @Nullable Drawable bottom)37 public void setCompoundDrawablesRelative(@NonNull TextView textView, 38 @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, 39 @Nullable Drawable bottom); 40 setCompoundDrawablesRelativeWithIntrinsicBounds(@onNull TextView textView, @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, @Nullable Drawable bottom)41 public void setCompoundDrawablesRelativeWithIntrinsicBounds(@NonNull TextView textView, 42 @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, 43 @Nullable Drawable bottom); 44 setCompoundDrawablesRelativeWithIntrinsicBounds(@onNull TextView textView, int start, int top, int end, int bottom)45 public void setCompoundDrawablesRelativeWithIntrinsicBounds(@NonNull TextView textView, 46 int start, int top, int end, int bottom); 47 48 } 49 50 static class BaseTextViewCompatImpl implements TextViewCompatImpl { 51 52 @Override setCompoundDrawablesRelative(@onNull TextView textView, @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, @Nullable Drawable bottom)53 public void setCompoundDrawablesRelative(@NonNull TextView textView, 54 @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, 55 @Nullable Drawable bottom) { 56 textView.setCompoundDrawables(start, top, end, bottom); 57 } 58 59 @Override setCompoundDrawablesRelativeWithIntrinsicBounds(@onNull TextView textView, @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, @Nullable Drawable bottom)60 public void setCompoundDrawablesRelativeWithIntrinsicBounds(@NonNull TextView textView, 61 @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, 62 @Nullable Drawable bottom) { 63 textView.setCompoundDrawablesWithIntrinsicBounds(start, top, end, bottom); 64 } 65 66 @Override setCompoundDrawablesRelativeWithIntrinsicBounds(@onNull TextView textView, int start, int top, int end, int bottom)67 public void setCompoundDrawablesRelativeWithIntrinsicBounds(@NonNull TextView textView, 68 int start, int top, int end, int bottom) { 69 textView.setCompoundDrawablesWithIntrinsicBounds(start, top, end, bottom); 70 } 71 72 } 73 74 static class JbMr1TextViewCompatImpl extends BaseTextViewCompatImpl { 75 76 @Override setCompoundDrawablesRelative(@onNull TextView textView, @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, @Nullable Drawable bottom)77 public void setCompoundDrawablesRelative(@NonNull TextView textView, 78 @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, 79 @Nullable Drawable bottom) { 80 TextViewCompatJbMr1.setCompoundDrawablesRelative(textView, start, top, end, bottom); 81 } 82 83 @Override setCompoundDrawablesRelativeWithIntrinsicBounds(@onNull TextView textView, @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, @Nullable Drawable bottom)84 public void setCompoundDrawablesRelativeWithIntrinsicBounds(@NonNull TextView textView, 85 @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, 86 @Nullable Drawable bottom) { 87 TextViewCompatJbMr1.setCompoundDrawablesRelativeWithIntrinsicBounds(textView, 88 start, top, end, bottom); 89 } 90 91 @Override setCompoundDrawablesRelativeWithIntrinsicBounds(@onNull TextView textView, int start, int top, int end, int bottom)92 public void setCompoundDrawablesRelativeWithIntrinsicBounds(@NonNull TextView textView, 93 int start, int top, int end, int bottom) { 94 TextViewCompatJbMr1.setCompoundDrawablesRelativeWithIntrinsicBounds(textView, 95 start, top, end, bottom); 96 } 97 98 } 99 100 static class JbMr2TextViewCompatImpl extends JbMr1TextViewCompatImpl { 101 102 @Override setCompoundDrawablesRelative(@onNull TextView textView, @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, @Nullable Drawable bottom)103 public void setCompoundDrawablesRelative(@NonNull TextView textView, 104 @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, 105 @Nullable Drawable bottom) { 106 TextViewCompatJbMr2.setCompoundDrawablesRelative(textView, start, top, end, bottom); 107 } 108 109 @Override setCompoundDrawablesRelativeWithIntrinsicBounds(@onNull TextView textView, @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, @Nullable Drawable bottom)110 public void setCompoundDrawablesRelativeWithIntrinsicBounds(@NonNull TextView textView, 111 @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, 112 @Nullable Drawable bottom) { 113 TextViewCompatJbMr2 114 .setCompoundDrawablesRelativeWithIntrinsicBounds(textView, start, top, end, 115 bottom); 116 } 117 118 @Override setCompoundDrawablesRelativeWithIntrinsicBounds(@onNull TextView textView, int start, int top, int end, int bottom)119 public void setCompoundDrawablesRelativeWithIntrinsicBounds(@NonNull TextView textView, 120 int start, int top, int end, int bottom) { 121 TextViewCompatJbMr2.setCompoundDrawablesRelativeWithIntrinsicBounds(textView, 122 start, top, end, bottom); 123 } 124 } 125 126 static final TextViewCompatImpl IMPL; 127 128 static { 129 final int version = Build.VERSION.SDK_INT; 130 if (version >= 18) { 131 IMPL = new JbMr2TextViewCompatImpl(); 132 } else if (version >= 17) { 133 IMPL = new JbMr1TextViewCompatImpl(); 134 } else { 135 IMPL = new BaseTextViewCompatImpl(); 136 } 137 } 138 139 /** 140 * Sets the Drawables (if any) to appear to the start of, above, to the end 141 * of, and below the text. Use {@code null} if you do not want a Drawable 142 * there. The Drawables must already have had {@link Drawable#setBounds} 143 * called. 144 * <p/> 145 * Calling this method will overwrite any Drawables previously set using 146 * {@link TextView#setCompoundDrawables} or related methods. 147 * 148 * @param textView The TextView against which to invoke the method. 149 * @attr ref android.R.styleable#TextView_drawableStart 150 * @attr ref android.R.styleable#TextView_drawableTop 151 * @attr ref android.R.styleable#TextView_drawableEnd 152 * @attr ref android.R.styleable#TextView_drawableBottom 153 */ setCompoundDrawablesRelative(@onNull TextView textView, @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, @Nullable Drawable bottom)154 public static void setCompoundDrawablesRelative(@NonNull TextView textView, 155 @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, 156 @Nullable Drawable bottom) { 157 IMPL.setCompoundDrawablesRelative(textView, start, top, end, bottom); 158 } 159 160 /** 161 * Sets the Drawables (if any) to appear to the start of, above, to the end 162 * of, and below the text. Use {@code null} if you do not want a Drawable 163 * there. The Drawables' bounds will be set to their intrinsic bounds. 164 * <p/> 165 * Calling this method will overwrite any Drawables previously set using 166 * {@link TextView#setCompoundDrawables} or related methods. 167 * 168 * @param textView The TextView against which to invoke the method. 169 * @attr ref android.R.styleable#TextView_drawableStart 170 * @attr ref android.R.styleable#TextView_drawableTop 171 * @attr ref android.R.styleable#TextView_drawableEnd 172 * @attr ref android.R.styleable#TextView_drawableBottom 173 */ setCompoundDrawablesRelativeWithIntrinsicBounds(@onNull TextView textView, @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, @Nullable Drawable bottom)174 public static void setCompoundDrawablesRelativeWithIntrinsicBounds(@NonNull TextView textView, 175 @Nullable Drawable start, @Nullable Drawable top, @Nullable Drawable end, 176 @Nullable Drawable bottom) { 177 IMPL.setCompoundDrawablesRelativeWithIntrinsicBounds(textView, start, top, end, bottom); 178 } 179 180 /** 181 * Sets the Drawables (if any) to appear to the start of, above, to the end 182 * of, and below the text. Use 0 if you do not want a Drawable there. The 183 * Drawables' bounds will be set to their intrinsic bounds. 184 * <p/> 185 * Calling this method will overwrite any Drawables previously set using 186 * {@link TextView#setCompoundDrawables} or related methods. 187 * 188 * @param textView The TextView against which to invoke the method. 189 * @param start Resource identifier of the start Drawable. 190 * @param top Resource identifier of the top Drawable. 191 * @param end Resource identifier of the end Drawable. 192 * @param bottom Resource identifier of the bottom Drawable. 193 * @attr ref android.R.styleable#TextView_drawableStart 194 * @attr ref android.R.styleable#TextView_drawableTop 195 * @attr ref android.R.styleable#TextView_drawableEnd 196 * @attr ref android.R.styleable#TextView_drawableBottom 197 */ setCompoundDrawablesRelativeWithIntrinsicBounds(@onNull TextView textView, int start, int top, int end, int bottom)198 public static void setCompoundDrawablesRelativeWithIntrinsicBounds(@NonNull TextView textView, 199 int start, int top, int end, int bottom) { 200 IMPL.setCompoundDrawablesRelativeWithIntrinsicBounds(textView, start, top, end, bottom); 201 } 202 203 } 204