1 /* 2 * Copyright (C) 2011 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.email.activity; 18 19 import com.android.email.R; 20 21 import android.app.Activity; 22 import android.app.Fragment; 23 import android.content.Context; 24 import android.content.res.Resources; 25 import android.view.View; 26 27 public class UiUtilities { 28 private UiUtilities() { 29 } 30 31 /** 32 * Formats the given size as a String in bytes, kB, MB or GB. Ex: 12,315,000 = 11 MB 33 */ 34 public static String formatSize(Context context, long size) { 35 final Resources res = context.getResources(); 36 final long KB = 1024; 37 final long MB = (KB * 1024); 38 final long GB = (MB * 1024); 39 40 int resId; 41 int value; 42 43 if (size < KB) { 44 resId = R.plurals.message_view_attachment_bytes; 45 value = (int) size; 46 } else if (size < MB) { 47 resId = R.plurals.message_view_attachment_kilobytes; 48 value = (int) (size / KB); 49 } else if (size < GB) { 50 resId = R.plurals.message_view_attachment_megabytes; 51 value = (int) (size / MB); 52 } else { 53 resId = R.plurals.message_view_attachment_gigabytes; 54 value = (int) (size / GB); 55 } 56 return res.getQuantityString(resId, value, value); 57 } 58 59 public static String getMessageCountForUi(Context context, int count, 60 boolean replaceZeroWithBlank) { 61 if (replaceZeroWithBlank && (count == 0)) { 62 return ""; 63 } else if (count > 999) { 64 return context.getString(R.string.more_than_999); 65 } else { 66 return Integer.toString(count); 67 } 68 } 69 70 /** Generics version of {@link Activity#findViewById} */ 71 @SuppressWarnings("unchecked") 72 public static <T extends View> T getViewOrNull(Activity parent, int viewId) { 73 return (T) parent.findViewById(viewId); 74 } 75 76 /** Generics version of {@link View#findViewById} */ 77 @SuppressWarnings("unchecked") 78 public static <T extends View> T getViewOrNull(View parent, int viewId) { 79 return (T) parent.findViewById(viewId); 80 } 81 82 /** 83 * Same as {@link Activity#findViewById}, but crashes if there's no view. 84 */ 85 @SuppressWarnings("unchecked") 86 public static <T extends View> T getView(Activity parent, int viewId) { 87 return (T) checkView(parent.findViewById(viewId)); 88 } 89 90 /** 91 * Same as {@link View#findViewById}, but crashes if there's no view. 92 */ 93 @SuppressWarnings("unchecked") 94 public static <T extends View> T getView(View parent, int viewId) { 95 return (T) checkView(parent.findViewById(viewId)); 96 } 97 98 private static View checkView(View v) { 99 if (v == null) { 100 throw new IllegalArgumentException("View doesn't exist"); 101 } 102 return v; 103 } 104 105 /** 106 * Same as {@link View#setVisibility(int)}, but doesn't crash even if {@code view} is null. 107 */ 108 public static void setVisibilitySafe(View v, int visibility) { 109 if (v != null) { 110 v.setVisibility(visibility); 111 } 112 } 113 114 /** 115 * Same as {@link View#setVisibility(int)}, but doesn't crash even if {@code view} is null. 116 */ 117 public static void setVisibilitySafe(Activity parent, int viewId, int visibility) { 118 setVisibilitySafe(parent.findViewById(viewId), visibility); 119 } 120 121 /** 122 * Same as {@link View#setVisibility(int)}, but doesn't crash even if {@code view} is null. 123 */ 124 public static void setVisibilitySafe(View parent, int viewId, int visibility) { 125 setVisibilitySafe(parent.findViewById(viewId), visibility); 126 } 127 128 /** 129 * Used by an {@link Fragment} to install itself to the host activity. 130 * 131 * @see FragmentInstallable 132 */ 133 public static void installFragment(Fragment fragment) { 134 final Activity a = fragment.getActivity(); 135 if (a instanceof FragmentInstallable) { 136 ((FragmentInstallable) a).onInstallFragment(fragment); 137 } 138 } 139 140 /** 141 * Used by an {@link Fragment} to uninstall itself from the host activity. 142 * 143 * @see FragmentInstallable 144 */ 145 public static void uninstallFragment(Fragment fragment) { 146 final Activity a = fragment.getActivity(); 147 if (a instanceof FragmentInstallable) { 148 ((FragmentInstallable) a).onUninstallFragment(fragment); 149 } 150 } 151 152 private static int sDebugForcedPaneMode = 0; 153 154 /** 155 * Force 1-pane UI or 2-pane UI. 156 * 157 * @param paneMode Set 1 if 1-pane UI should be used. Set 2 if 2-pane UI should be used. 158 * Set 0 to use the default UI. 159 */ 160 static void setDebugPaneMode(int paneMode) { 161 sDebugForcedPaneMode = paneMode; 162 } 163 164 /** 165 * @return {@code true} if 2-pane UI should be used. {@code false} otherwise. 166 */ 167 public static boolean useTwoPane(Context context) { 168 if (sDebugForcedPaneMode == 1) { 169 return false; 170 } 171 if (sDebugForcedPaneMode == 2) { 172 return true; 173 } 174 return context.getResources().getBoolean(R.bool.use_two_pane); 175 } 176 177 /** 178 * Return whether to show search results in a split pane. 179 */ 180 public static boolean showTwoPaneSearchResults(Context context) { 181 return context.getResources().getBoolean(R.bool.show_two_pane_search_result); 182 } 183 } 184
