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