19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 171a44d5dcabc18cd5ef111f732ccff91683a1a093Neal Nguyenpackage android.widget; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.graphics.Canvas; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.graphics.Paint; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.View; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example of how to write a custom subclass of View. LabelView 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is used to draw simple text views. Note that it does not handle 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * styled text or right-to-left writing systems. 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class LabelView extends View { 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Constructor. This version is only needed if you will be instantiating 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the object manually (not from a layout XML file). 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context the application environment 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public LabelView(Context context) { 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(context); 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project initLabelView(); 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct object, initializing with any attributes we understand from a 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * layout file. These attributes are defined in 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * SDK/assets/res/any/classes.xml. 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.view.View#View(android.content.Context, android.util.AttributeSet) 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public LabelView(Context context, AttributeSet attrs) { 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(context, attrs); 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project initLabelView(); 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Resources.StyledAttributes a = context.obtainStyledAttributes(attrs, 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project R.styleable.LabelView); 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CharSequence s = a.getString(R.styleable.LabelView_text); 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (s != null) { 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setText(s.toString()); 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ColorStateList textColor = a.getColorList(R.styleable. 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project LabelView_textColor); 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (textColor != null) { 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setTextColor(textColor.getDefaultColor(0)); 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int textSize = a.getInt(R.styleable.LabelView_textSize, 0); 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (textSize > 0) { 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setTextSize(textSize); 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project a.recycle(); 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void initLabelView() { 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTextPaint = new Paint(); 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTextPaint.setAntiAlias(true); 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTextPaint.setTextSize(16); 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTextPaint.setColor(0xFF000000); 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPaddingLeft = 3; 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPaddingTop = 3; 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPaddingRight = 3; 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPaddingBottom = 3; 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the text to display in this label 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to display. This will be drawn as one line. 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setText(String text) { 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mText = text; 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requestLayout(); 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project invalidate(); 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the text size for this label 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param size Font size 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setTextSize(int size) { 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTextPaint.setTextSize(size); 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requestLayout(); 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project invalidate(); 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the text color for this label 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color ARGB value for the text 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setTextColor(int color) { 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTextPaint.setColor(color); 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project invalidate(); 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.view.View#measure(int, int) 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) { 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setMeasuredDimension(measureWidth(widthMeasureSpec), 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project measureHeight(heightMeasureSpec)); 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Determines the width of this view 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param measureSpec A measureSpec packed into an int 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The width of the view, honoring constraints from measureSpec 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int measureWidth(int measureSpec) { 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int result; 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int specMode = MeasureSpec.getMode(measureSpec); 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int specSize = MeasureSpec.getSize(measureSpec); 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (specMode == MeasureSpec.EXACTLY) { 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // We were told how big to be 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project result = specSize; 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Measure the text 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project result = (int) mTextPaint.measureText(mText) + mPaddingLeft 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + mPaddingRight; 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (specMode == MeasureSpec.AT_MOST) { 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Respect AT_MOST value if that was what is called for by measureSpec 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project result = Math.min(result, specSize); 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return result; 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Determines the height of this view 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param measureSpec A measureSpec packed into an int 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The height of the view, honoring constraints from measureSpec 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int measureHeight(int measureSpec) { 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int result; 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int specMode = MeasureSpec.getMode(measureSpec); 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int specSize = MeasureSpec.getSize(measureSpec); 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mAscent = (int) mTextPaint.ascent(); 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (specMode == MeasureSpec.EXACTLY) { 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // We were told how big to be 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project result = specSize; 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Measure the text (beware: ascent is a negative number) 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project result = (int) (-mAscent + mTextPaint.descent()) + mPaddingTop 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + mPaddingBottom; 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (specMode == MeasureSpec.AT_MOST) { 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Respect AT_MOST value if that was what is called for by measureSpec 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project result = Math.min(result, specSize); 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return result; 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Render the text 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.view.View#onDraw(android.graphics.Canvas) 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onDraw(Canvas canvas) { 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onDraw(canvas); 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project canvas.drawText(mText, mPaddingLeft, mPaddingTop - mAscent, mTextPaint); 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Paint mTextPaint; 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mText; 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mAscent; 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 192