1 <?xml version="1.0" encoding="utf-8"?> 2 <!-- 3 ~ Copyright (C) 2013 The Android Open Source Project 4 ~ 5 ~ Licensed under the Apache License, Version 2.0 (the "License"); 6 ~ you may not use this file except in compliance with the License. 7 ~ You may obtain a copy of the License at 8 ~ 9 ~ http://www.apache.org/licenses/LICENSE-2.0 10 ~ 11 ~ Unless required by applicable law or agreed to in writing, software 12 ~ distributed under the License is distributed on an "AS IS" BASIS, 13 ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 ~ See the License for the specific language governing permissions and 15 ~ limitations under the License 16 --> 17 18 <!-- In-call onscreen touch UI elements, used on some platforms. 19 20 This layout is a fullscreen overlay, drawn on top of the 21 non-touch-sensitive parts of the in-call UI (i.e. the call card). 22 23 The top-level View here is a InCallTouchUi (FrameLayout) with 2 children: 24 (1) inCallControls: the widgets visible while a regular call (or calls) is in progress 25 (2) incomingCallWidget: the UI displayed while an incoming call is ringing 26 In usual cases, one of these is visible at any given moment. 27 One exception is when incomingCallWidget is fading-out. At that moment, we show 28 inCallControls beneath incomingCallWidget for smoother transition. 29 --> 30 31 <!-- Main cluster of onscreen buttons on the lower part of the screen. --> 32 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 33 android:id="@+id/bottomButtons" 34 android:orientation="vertical" 35 android:layout_width="match_parent" 36 android:background="#0000ff" 37 android:layout_margin="0dp" 38 android:padding="0dp" 39 android:layout_height="wrap_content" 40 android:layout_alignParentBottom="true" 41 android:visibility="invisible"> 42 43 <!-- Row 1, the "extra button row": A couple of relatively rare 44 buttons used only in certain call states. 45 Most of the time this whole row is GONE. 46 For now, at least, there's only ever one button visible here 47 at a time, so this can be a simple FrameLayout. --> 48 <include android:id="@+id/extraButtonRow" 49 layout="@layout/extra_button_row" 50 android:layout_width="match_parent" 51 android:layout_height="wrap_content"/> 52 53 <!-- Row 2: The "End call" button. --> 54 <ImageButton android:id="@+id/endButton" 55 style="@style/InCallEndButton" 56 android:layout_width="match_parent" 57 android:src="@drawable/ic_in_call_phone_hangup" 58 android:background="@drawable/end_call_background" 59 android:contentDescription="@string/onscreenEndCallText"/> 60 61 <!-- Row 3: The main batch of in-call buttons: 62 Dialpad / Audio mode / Mute / Hold / Add call 63 Visible in all states except while an incoming call is 64 ringing. --> 65 <LinearLayout 66 android:orientation="horizontal" 67 android:layout_width="match_parent" 68 android:layout_height="wrap_content" 69 android:paddingStart="@dimen/button_cluster_side_padding" 70 android:paddingEnd="@dimen/button_cluster_side_padding" 71 android:background="@color/button_background" 72 > 73 74 <!-- This row has either 4 or 5 buttons, depending on 75 whether the device supports "Hold" (i.e. 4 buttons on 76 CDMA devices, 5 buttons on GSM devices.) The buttons 77 are interspersed with 'layout_weight="1"' placeholder 78 views so that they'll be spaced evenly in both cases. 79 80 But note there are a couple of *pairs* of buttons that share a 81 single "slot", namely Hold/Swap and Add/Merge. For these, the 82 code in InCallTouchUi is responsible for making sure that at any 83 point exactly one of the pair is VISIBLE and the other is 84 GONE. --> 85 86 <!-- Separator between left padding and 1st button --> 87 <View style="@style/VerticalSeparator"/> 88 89 <!-- "Dialpad" --> 90 <!-- This is a "compound button": it has checked and unchecked states. --> 91 <ToggleButton android:id="@+id/dialpadButton" 92 style="@style/InCallCompoundButton" 93 android:background="@drawable/btn_compound_dialpad" 94 android:contentDescription="@string/onscreenShowDialpadText" 95 /> 96 97 <!-- Separator between 1st and 2nd button --> 98 <View style="@style/VerticalSeparator"/> 99 100 <!-- "Audio mode" --> 101 <!-- This is a multi-mode button that can behave either like a 102 simple "compound button" with two states *or* like an 103 action button that brings up a popup menu; see 104 btn_compound_audio.xml and InCallTouchUi.updateAudioButton() 105 for the full details. --> 106 <ImageButton android:id="@+id/audioButton" 107 style="@style/InCallButton" 108 android:background="@drawable/btn_compound_audio" 109 android:contentDescription="@string/onscreenAudioText" 110 /> 111 112 <!-- Separator between 2nd and 3rd button --> 113 <View style="@style/VerticalSeparator"/> 114 115 <!-- "Mute" --> 116 <!-- This is a "compound button": it has checked and unchecked states. --> 117 <ImageButton android:id="@+id/muteButton" 118 style="@style/InCallButton" 119 android:background="@drawable/btn_fake_compound_mute" 120 android:contentDescription="@string/onscreenMuteText" 121 /> 122 123 <!-- Separator between 3rd and 4th button --> 124 <View style="@style/VerticalSeparator"/> 125 126 <!-- This slot is either "Hold" or "Swap", depending on 127 the state of the call. One or the other of these 128 must always be set to GONE. --> 129 <!-- "Hold" --> 130 <!-- This is a "compound button": it has checked and unchecked states. --> 131 <ImageButton android:id="@+id/holdButton" 132 style="@style/InCallButton" 133 android:background="@drawable/btn_fake_compound_hold" 134 android:contentDescription="@string/onscreenHoldText" 135 /> 136 <!-- "Swap" (or "Manage calls" in some CDMA states) --> 137 <ImageButton android:id="@+id/swapButton" 138 style="@style/InCallButton" 139 android:src="@drawable/ic_incall_switch_holo_dark" 140 android:contentDescription="@string/onscreenSwapCallsText" 141 android:visibility="gone" 142 /> 143 144 <!-- Separator between 4th and 5th button (if 5th exists) --> 145 <View android:id="@+id/holdSwapSpacer" 146 style="@style/VerticalSeparator"/> 147 148 <!-- This slot is either "Add" or "Merge", depending on 149 the state of the call. One or the other of these 150 must always be set to GONE. --> 151 <!-- "Add Call" --> 152 <ImageButton android:id="@+id/addButton" 153 style="@style/InCallButton" 154 android:src="@drawable/ic_add_contact_holo_dark" 155 android:contentDescription="@string/onscreenAddCallText" 156 android:visibility="gone" 157 /> 158 <!-- "Merge calls" --> 159 <!-- This button is used only on GSM devices, where we know 160 that "Add" and "Merge" are never available at the same time. 161 The "Merge" button for CDMA devices is "cdmaMergeButton" above. --> 162 <ImageButton android:id="@+id/mergeButton" 163 style="@style/InCallButton" 164 android:src="@drawable/ic_merge_holo_dark" 165 android:contentDescription="@string/onscreenMergeCallsText" 166 android:visibility="gone" 167 /> 168 169 <!-- Separator between 4th (or 5th) button and right padding --> 170 <View style="@style/VerticalSeparator"/> 171 172 </LinearLayout> 173 174 </LinearLayout> 175
