Home | History | Annotate | Download | only in widget 
      1 /*
      2  * Copyright (C) 2006 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.widget;
     18 
     19 import android.annotation.Widget;
     20 import android.content.Context;
     21 import android.content.res.TypedArray;
     22 import android.util.AttributeSet;
     23 import android.view.accessibility.AccessibilityEvent;
     24 import android.view.accessibility.AccessibilityNodeInfo;
     25 import android.widget.RelativeLayout;
     26 
     27 /**
     28  * <p>A view group with two children, intended for use in ListViews. This item has two
     29  * {@link android.widget.TextView TextViews} elements (or subclasses) with the ID values
     30  * {@link android.R.id#text1 text1}
     31  * and {@link android.R.id#text2 text2}. There is an optional third View element with the
     32  * ID {@link android.R.id#selectedIcon selectedIcon}, which can be any View subclass
     33  * (though it is typically a graphic View, such as {@link android.widget.ImageView ImageView})
     34  * that can be displayed when a TwoLineListItem has focus. Android supplies a
     35  * {@link android.R.layout#two_line_list_item standard layout resource for TwoLineListView}
     36  * (which does not include a selected item icon), but you can design your own custom XML
     37  * layout for this object.
     38  *
     39  * @attr ref android.R.styleable#TwoLineListItem_mode
     40  *
     41  * @deprecated This class can be implemented easily by apps using a {@link RelativeLayout}
     42  * or a {@link LinearLayout}.
     43  */
     44 @Deprecated
     45 @Widget
     46 public class TwoLineListItem extends RelativeLayout {
     47 
     48     private TextView mText1;
     49     private TextView mText2;
     50 
     51     public TwoLineListItem(Context context) {
     52         this(context, null, 0);
     53     }
     54 
     55     public TwoLineListItem(Context context, AttributeSet attrs) {
     56         this(context, attrs, 0);
     57     }
     58 
     59     public TwoLineListItem(Context context, AttributeSet attrs, int defStyleAttr) {
     60         this(context, attrs, defStyleAttr, 0);
     61     }
     62 
     63     public TwoLineListItem(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
     64         super(context, attrs, defStyleAttr, defStyleRes);
     65 
     66         final TypedArray a = context.obtainStyledAttributes(
     67                 attrs, com.android.internal.R.styleable.TwoLineListItem, defStyleAttr, defStyleRes);
     68 
     69         a.recycle();
     70     }
     71 
     72     @Override
     73     protected void onFinishInflate() {
     74         super.onFinishInflate();
     75 
     76         mText1 = (TextView) findViewById(com.android.internal.R.id.text1);
     77         mText2 = (TextView) findViewById(com.android.internal.R.id.text2);
     78     }
     79 
     80     /**
     81      * Returns a handle to the item with ID text1.
     82      * @return A handle to the item with ID text1.
     83      */
     84     public TextView getText1() {
     85         return mText1;
     86     }
     87 
     88     /**
     89      * Returns a handle to the item with ID text2.
     90      * @return A handle to the item with ID text2.
     91      */
     92     public TextView getText2() {
     93         return mText2;
     94     }
     95 
     96     @Override
     97     public void onInitializeAccessibilityEvent(AccessibilityEvent event) {
     98         super.onInitializeAccessibilityEvent(event);
     99         event.setClassName(TwoLineListItem.class.getName());
    100     }
    101 
    102     @Override
    103     public void onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info) {
    104         super.onInitializeAccessibilityNodeInfo(info);
    105         info.setClassName(TwoLineListItem.class.getName());
    106     }
    107 }
    108