/*
* Copyright (C) 2009 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.android.inputmethod.pinyin;
import android.content.Context;
import android.graphics.Canvas;
import android.graphics.Paint;
import android.graphics.Rect;
import android.graphics.Paint.FontMetricsInt;
import android.graphics.drawable.ColorDrawable;
import android.graphics.drawable.Drawable;
import android.os.Handler;
import android.view.Gravity;
import android.view.View;
import android.view.View.MeasureSpec;
import android.widget.PopupWindow;
/**
* Subclass of PopupWindow used as the feedback when user presses on a soft key
* or a candidate.
*/
public class BalloonHint extends PopupWindow {
/**
* Delayed time to show the balloon hint.
*/
public static final int TIME_DELAY_SHOW = 0;
/**
* Delayed time to dismiss the balloon hint.
*/
public static final int TIME_DELAY_DISMISS = 200;
/**
* The padding information of the balloon. Because PopupWindow's background
* can not be changed unless it is dismissed and shown again, we set the
* real background drawable to the content view, and make the PopupWindow's
* background transparent. So actually this padding information is for the
* content view.
*/
private Rect mPaddingRect = new Rect();
/**
* The context used to create this balloon hint object.
*/
private Context mContext;
/**
* Parent used to show the balloon window.
*/
private View mParent;
/**
* The content view of the balloon.
*/
BalloonView mBalloonView;
/**
* The measuring specification used to determine its size. Key-press
* balloons and candidates balloons have different measuring specifications.
*/
private int mMeasureSpecMode;
/**
* Used to indicate whether the balloon needs to be dismissed forcibly.
*/
private boolean mForceDismiss;
/**
* Timer used to show/dismiss the balloon window with some time delay.
*/
private BalloonTimer mBalloonTimer;
private int mParentLocationInWindow[] = new int[2];
public BalloonHint(Context context, View parent, int measureSpecMode) {
super(context);
mParent = parent;
mMeasureSpecMode = measureSpecMode;
setInputMethodMode(PopupWindow.INPUT_METHOD_NOT_NEEDED);
setTouchable(false);
setBackgroundDrawable(new ColorDrawable(0));
mBalloonView = new BalloonView(context);
mBalloonView.setClickable(false);
setContentView(mBalloonView);
mBalloonTimer = new BalloonTimer();
}
public Context getContext() {
return mContext;
}
public Rect getPadding() {
return mPaddingRect;
}
public void setBalloonBackground(Drawable drawable) {
// We usually pick up a background from a soft keyboard template,
// and the object may has been set to this balloon before.
if (mBalloonView.getBackground() == drawable) return;
mBalloonView.setBackgroundDrawable(drawable);
if (null != drawable) {
drawable.getPadding(mPaddingRect);
} else {
mPaddingRect.set(0, 0, 0, 0);
}
}
/**
* Set configurations to show text label in this balloon.
*
* @param label The text label to show in the balloon.
* @param textSize The text size used to show label.
* @param textBold Used to indicate whether the label should be bold.
* @param textColor The text color used to show label.
* @param width The desired width of the balloon. The real width is
* determined by the desired width and balloon's measuring
* specification.
* @param height The desired width of the balloon. The real width is
* determined by the desired width and balloon's measuring
* specification.
*/
public void setBalloonConfig(String label, float textSize,
boolean textBold, int textColor, int width, int height) {
mBalloonView.setTextConfig(label, textSize, textBold, textColor);
setBalloonSize(width, height);
}
/**
* Set configurations to show text label in this balloon.
*
* @param icon The icon used to shown in this balloon.
* @param width The desired width of the balloon. The real width is
* determined by the desired width and balloon's measuring
* specification.
* @param height The desired width of the balloon. The real width is
* determined by the desired width and balloon's measuring
* specification.
*/
public void setBalloonConfig(Drawable icon, int width, int height) {
mBalloonView.setIcon(icon);
setBalloonSize(width, height);
}
public boolean needForceDismiss() {
return mForceDismiss;
}
public int getPaddingLeft() {
return mPaddingRect.left;
}
public int getPaddingTop() {
return mPaddingRect.top;
}
public int getPaddingRight() {
return mPaddingRect.right;
}
public int getPaddingBottom() {
return mPaddingRect.bottom;
}
public void delayedShow(long delay, int locationInParent[]) {
if (mBalloonTimer.isPending()) {
mBalloonTimer.removeTimer();
}
if (delay <= 0) {
mParent.getLocationInWindow(mParentLocationInWindow);
showAtLocation(mParent, Gravity.LEFT | Gravity.TOP,
locationInParent[0], locationInParent[1]
+ mParentLocationInWindow[1]);
} else {
mBalloonTimer.startTimer(delay, BalloonTimer.ACTION_SHOW,
locationInParent, -1, -1);
}
}
public void delayedUpdate(long delay, int locationInParent[],
int width, int height) {
mBalloonView.invalidate();
if (mBalloonTimer.isPending()) {
mBalloonTimer.removeTimer();
}
if (delay <= 0) {
mParent.getLocationInWindow(mParentLocationInWindow);
update(locationInParent[0], locationInParent[1]
+ mParentLocationInWindow[1], width, height);
} else {
mBalloonTimer.startTimer(delay, BalloonTimer.ACTION_UPDATE,
locationInParent, width, height);
}
}
public void delayedDismiss(long delay) {
if (mBalloonTimer.isPending()) {
mBalloonTimer.removeTimer();
int pendingAction = mBalloonTimer.getAction();
if (0 != delay && BalloonTimer.ACTION_HIDE != pendingAction) {
mBalloonTimer.run();
}
}
if (delay <= 0) {
dismiss();
} else {
mBalloonTimer.startTimer(delay, BalloonTimer.ACTION_HIDE, null, -1,
-1);
}
}
public void removeTimer() {
if (mBalloonTimer.isPending()) {
mBalloonTimer.removeTimer();
}
}
private void setBalloonSize(int width, int height) {
int widthMeasureSpec = MeasureSpec.makeMeasureSpec(width,
mMeasureSpecMode);
int heightMeasureSpec = MeasureSpec.makeMeasureSpec(height,
mMeasureSpecMode);
mBalloonView.measure(widthMeasureSpec, heightMeasureSpec);
int oldWidth = getWidth();
int oldHeight = getHeight();
int newWidth = mBalloonView.getMeasuredWidth() + getPaddingLeft()
+ getPaddingRight();
int newHeight = mBalloonView.getMeasuredHeight() + getPaddingTop()
+ getPaddingBottom();
setWidth(newWidth);
setHeight(newHeight);
// If update() is called to update both size and position, the system
// will first MOVE the PopupWindow to the new position, and then
// perform a size-updating operation, so there will be a flash in
// PopupWindow if user presses a key and moves finger to next one whose
// size is different.
// PopupWindow will handle the updating issue in one go in the future,
// but before that, if we find the size is changed, a mandatory dismiss
// operation is required. In our UI design, normal QWERTY keys' width
// can be different in 1-pixel, and we do not dismiss the balloon when
// user move between QWERTY keys.
mForceDismiss = false;
if (isShowing()) {
mForceDismiss = oldWidth - newWidth > 1 || newWidth - oldWidth > 1;
}
}
private class BalloonTimer extends Handler implements Runnable {
public static final int ACTION_SHOW = 1;
public static final int ACTION_HIDE = 2;
public static final int ACTION_UPDATE = 3;
/**
* The pending action.
*/
private int mAction;
private int mPositionInParent[] = new int[2];
private int mWidth;
private int mHeight;
private boolean mTimerPending = false;
public void startTimer(long time, int action, int positionInParent[],
int width, int height) {
mAction = action;
if (ACTION_HIDE != action) {
mPositionInParent[0] = positionInParent[0];
mPositionInParent[1] = positionInParent[1];
}
mWidth = width;
mHeight = height;
postDelayed(this, time);
mTimerPending = true;
}
public boolean isPending() {
return mTimerPending;
}
public boolean removeTimer() {
if (mTimerPending) {
mTimerPending = false;
removeCallbacks(this);
return true;
}
return false;
}
public int getAction() {
return mAction;
}
public void run() {
switch (mAction) {
case ACTION_SHOW:
mParent.getLocationInWindow(mParentLocationInWindow);
showAtLocation(mParent, Gravity.LEFT | Gravity.TOP,
mPositionInParent[0], mPositionInParent[1]
+ mParentLocationInWindow[1]);
break;
case ACTION_HIDE:
dismiss();
break;
case ACTION_UPDATE:
mParent.getLocationInWindow(mParentLocationInWindow);
update(mPositionInParent[0], mPositionInParent[1]
+ mParentLocationInWindow[1], mWidth, mHeight);
}
mTimerPending = false;
}
}
private class BalloonView extends View {
/**
* Suspension points used to display long items.
*/
private static final String SUSPENSION_POINTS = "...";
/**
* The icon to be shown. If it is not null, {@link #mLabel} will be
* ignored.
*/
private Drawable mIcon;
/**
* The label to be shown. It is enabled only if {@link #mIcon} is null.
*/
private String mLabel;
private int mLabeColor = 0xff000000;
private Paint mPaintLabel;
private FontMetricsInt mFmi;
/**
* The width to show suspension points.
*/
private float mSuspensionPointsWidth;
public BalloonView(Context context) {
super(context);
mPaintLabel = new Paint();
mPaintLabel.setColor(mLabeColor);
mPaintLabel.setAntiAlias(true);
mPaintLabel.setFakeBoldText(true);
mFmi = mPaintLabel.getFontMetricsInt();
}
public void setIcon(Drawable icon) {
mIcon = icon;
}
public void setTextConfig(String label, float fontSize,
boolean textBold, int textColor) {
// Icon should be cleared so that the label will be enabled.
mIcon = null;
mLabel = label;
mPaintLabel.setTextSize(fontSize);
mPaintLabel.setFakeBoldText(textBold);
mPaintLabel.setColor(textColor);
mFmi = mPaintLabel.getFontMetricsInt();
mSuspensionPointsWidth = mPaintLabel.measureText(SUSPENSION_POINTS);
}
@Override
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
final int widthMode = MeasureSpec.getMode(widthMeasureSpec);
final int heightMode = MeasureSpec.getMode(heightMeasureSpec);
final int widthSize = MeasureSpec.getSize(widthMeasureSpec);
final int heightSize = MeasureSpec.getSize(heightMeasureSpec);
if (widthMode == MeasureSpec.EXACTLY) {
setMeasuredDimension(widthSize, heightSize);
return;
}
int measuredWidth = mPaddingLeft + mPaddingRight;
int measuredHeight = mPaddingTop + mPaddingBottom;
if (null != mIcon) {
measuredWidth += mIcon.getIntrinsicWidth();
measuredHeight += mIcon.getIntrinsicHeight();
} else if (null != mLabel) {
measuredWidth += (int) (mPaintLabel.measureText(mLabel));
measuredHeight += mFmi.bottom - mFmi.top;
}
if (widthSize > measuredWidth || widthMode == MeasureSpec.AT_MOST) {
measuredWidth = widthSize;
}
if (heightSize > measuredHeight
|| heightMode == MeasureSpec.AT_MOST) {
measuredHeight = heightSize;
}
int maxWidth = Environment.getInstance().getScreenWidth() -
mPaddingLeft - mPaddingRight;
if (measuredWidth > maxWidth) {
measuredWidth = maxWidth;
}
setMeasuredDimension(measuredWidth, measuredHeight);
}
@Override
protected void onDraw(Canvas canvas) {
int width = getWidth();
int height = getHeight();
if (null != mIcon) {
int marginLeft = (width - mIcon.getIntrinsicWidth()) / 2;
int marginRight = width - mIcon.getIntrinsicWidth()
- marginLeft;
int marginTop = (height - mIcon.getIntrinsicHeight()) / 2;
int marginBottom = height - mIcon.getIntrinsicHeight()
- marginTop;
mIcon.setBounds(marginLeft, marginTop, width - marginRight,
height - marginBottom);
mIcon.draw(canvas);
} else if (null != mLabel) {
float labelMeasuredWidth = mPaintLabel.measureText(mLabel);
float x = mPaddingLeft;
x += (width - labelMeasuredWidth - mPaddingLeft - mPaddingRight) / 2.0f;
String labelToDraw = mLabel;
if (x < mPaddingLeft) {
x = mPaddingLeft;
labelToDraw = getLimitedLabelForDrawing(mLabel,
width - mPaddingLeft - mPaddingRight);
}
int fontHeight = mFmi.bottom - mFmi.top;
float marginY = (height - fontHeight) / 2.0f;
float y = marginY - mFmi.top;
canvas.drawText(labelToDraw, x, y, mPaintLabel);
}
}
private String getLimitedLabelForDrawing(String rawLabel,
float widthToDraw) {
int subLen = rawLabel.length();
if (subLen <= 1) return rawLabel;
do {
subLen--;
float width = mPaintLabel.measureText(rawLabel, 0, subLen);
if (width + mSuspensionPointsWidth <= widthToDraw || 1 >= subLen) {
return rawLabel.substring(0, subLen) +
SUSPENSION_POINTS;
}
} while (true);
}
}
}
|
