Home | History | Annotate | Download | only in editor 
      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 
     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 
    148         public ChoiceListItem(int id, String caption) {
    149             mId = id;
    150             mCaption = caption;
    151         }
    152 
    153         @Override
    154         public String toString() {
    155             return mCaption;
    156         }
    157 
    158         public int getId() {
    159             return mId;
    160         }
    161     }
    162 
    163     public interface Listener {
    164         void onUseAsPrimaryChosen();
    165         void onRemovePictureChosen();
    166         void onTakePhotoChosen();
    167         void onPickFromGalleryChosen();
    168     }
    169 }
    170