1 /* 2 * Copyright (C) 2010 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 com.android.contacts.editor; 18 19 import android.content.Context; 20 import android.view.View; 21 import android.widget.AdapterView; 22 import android.widget.AdapterView.OnItemClickListener; 23 import android.widget.ArrayAdapter; 24 import android.widget.ListAdapter; 25 import android.widget.ListPopupWindow; 26 27 import com.android.contacts.R; 28 import com.android.contacts.util.PhoneCapabilityTester; 29 import com.android.contacts.util.UiClosables; 30 31 import java.util.ArrayList; 32 33 /** 34 * Shows a popup asking the user what to do for a photo. The result is passed back to the Listener 35 */ 36 public class PhotoActionPopup { 37 public static final String TAG = "PhotoActionPopup"; 38 39 /** 40 * Bitmask flags to specify which actions should be presented to the user. 41 */ 42 public static final class Flags { 43 /** If set, show choice to use as primary photo. */ 44 public static final int ALLOW_PRIMARY = 1; 45 /** If set, show choice to remove photo. */ 46 public static final int REMOVE_PHOTO = 2; 47 /** If set, show choices to take a picture with the camera, or pick one from the gallery. */ 48 public static final int TAKE_OR_PICK_PHOTO = 4; 49 /** 50 * If set, modifies the wording in the choices for TAKE_OR_PICK_PHOTO 51 * to emphasize that the existing photo will be replaced. 52 */ 53 public static final int TAKE_OR_PICK_PHOTO_REPLACE_WORDING = 8; 54 } 55 56 /** 57 * Convenient combinations of commonly-used flags (see {@link Flags}). 58 */ 59 public static final class Modes { 60 public static final int NO_PHOTO = 61 Flags.TAKE_OR_PICK_PHOTO; 62 public static final int READ_ONLY_ALLOW_PRIMARY = 63 Flags.ALLOW_PRIMARY; 64 public static final int PHOTO_DISALLOW_PRIMARY = 65 Flags.REMOVE_PHOTO | 66 Flags.TAKE_OR_PICK_PHOTO | 67 Flags.TAKE_OR_PICK_PHOTO_REPLACE_WORDING; 68 public static final int PHOTO_ALLOW_PRIMARY = 69 Flags.ALLOW_PRIMARY | 70 Flags.REMOVE_PHOTO | 71 Flags.TAKE_OR_PICK_PHOTO | 72 Flags.TAKE_OR_PICK_PHOTO_REPLACE_WORDING; 73 } 74 createPopupMenu(Context context, View anchorView, final Listener listener, int mode)75 public static ListPopupWindow createPopupMenu(Context context, View anchorView, 76 final Listener listener, int mode) { 77 // Build choices, depending on the current mode. We assume this Dialog is never called 78 // if there are NO choices (e.g. a read-only picture is already super-primary) 79 final ArrayList<ChoiceListItem> choices = new ArrayList<ChoiceListItem>(4); 80 // Use as Primary 81 if ((mode & Flags.ALLOW_PRIMARY) > 0) { 82 choices.add(new ChoiceListItem(ChoiceListItem.ID_USE_AS_PRIMARY, 83 context.getString(R.string.use_photo_as_primary))); 84 } 85 // Remove 86 if ((mode & Flags.REMOVE_PHOTO) > 0) { 87 choices.add(new ChoiceListItem(ChoiceListItem.ID_REMOVE, 88 context.getString(R.string.removePhoto))); 89 } 90 // Take photo or pick one from the gallery. Wording differs if there is already a photo. 91 if ((mode & Flags.TAKE_OR_PICK_PHOTO) > 0) { 92 boolean replace = (mode & Flags.TAKE_OR_PICK_PHOTO_REPLACE_WORDING) > 0; 93 final int takePhotoResId = replace ? R.string.take_new_photo : R.string.take_photo; 94 final String takePhotoString = context.getString(takePhotoResId); 95 final int pickPhotoResId = replace ? R.string.pick_new_photo : R.string.pick_photo; 96 final String pickPhotoString = context.getString(pickPhotoResId); 97 if (PhoneCapabilityTester.isCameraIntentRegistered(context)) { 98 choices.add(new ChoiceListItem(ChoiceListItem.ID_TAKE_PHOTO, takePhotoString)); 99 } 100 choices.add(new ChoiceListItem(ChoiceListItem.ID_PICK_PHOTO, pickPhotoString)); 101 } 102 103 final ListAdapter adapter = new ArrayAdapter<ChoiceListItem>(context, 104 R.layout.select_dialog_item, choices); 105 106 final ListPopupWindow listPopupWindow = new ListPopupWindow(context); 107 final OnItemClickListener clickListener = new OnItemClickListener() { 108 @Override 109 public void onItemClick(AdapterView<?> parent, View view, int position, long id) { 110 final ChoiceListItem choice = choices.get(position); 111 switch (choice.getId()) { 112 case ChoiceListItem.ID_USE_AS_PRIMARY: 113 listener.onUseAsPrimaryChosen(); 114 break; 115 case ChoiceListItem.ID_REMOVE: 116 listener.onRemovePictureChosen(); 117 break; 118 case ChoiceListItem.ID_TAKE_PHOTO: 119 listener.onTakePhotoChosen(); 120 break; 121 case ChoiceListItem.ID_PICK_PHOTO: 122 listener.onPickFromGalleryChosen(); 123 break; 124 } 125 126 UiClosables.closeQuietly(listPopupWindow); 127 } 128 }; 129 130 listPopupWindow.setAnchorView(anchorView); 131 listPopupWindow.setAdapter(adapter); 132 listPopupWindow.setOnItemClickListener(clickListener); 133 listPopupWindow.setModal(true); 134 listPopupWindow.setInputMethodMode(ListPopupWindow.INPUT_METHOD_NOT_NEEDED); 135 final int minWidth = context.getResources().getDimensionPixelSize( 136 R.dimen.photo_action_popup_min_width); 137 if (anchorView.getWidth() < minWidth) { 138 listPopupWindow.setWidth(minWidth); 139 } 140 return listPopupWindow; 141 } 142 143 private static final class ChoiceListItem { 144 private final int mId; 145 private final String mCaption; 146 147 public static final int ID_USE_AS_PRIMARY = 0; 148 public static final int ID_TAKE_PHOTO = 1; 149 public static final int ID_PICK_PHOTO = 2; 150 public static final int ID_REMOVE = 3; 151 ChoiceListItem(int id, String caption)152 public ChoiceListItem(int id, String caption) { 153 mId = id; 154 mCaption = caption; 155 } 156 157 @Override toString()158 public String toString() { 159 return mCaption; 160 } 161 getId()162 public int getId() { 163 return mId; 164 } 165 } 166 167 public interface Listener { onUseAsPrimaryChosen()168 void onUseAsPrimaryChosen(); onRemovePictureChosen()169 void onRemovePictureChosen(); onTakePhotoChosen()170 void onTakePhotoChosen(); onPickFromGalleryChosen()171 void onPickFromGalleryChosen(); 172 } 173 } 174