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
17package android.widget;
18
19import android.annotation.Widget;
20import android.content.Context;
21import android.content.res.TypedArray;
22import android.util.AttributeSet;
23import android.view.accessibility.AccessibilityEvent;
24import android.view.accessibility.AccessibilityNodeInfo;
25import 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
46public 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