Android 3.1 r1 API中文文档（6）——ImageView-续

public Drawable getDrawable ()

　　返回视图的可绘制对象；如果没有关联可绘制对象，返回空。

　　public Matrix getImageMatrix ()

　　返回视图的选项矩阵。当绘制时，应用于视图的可绘制对象。如果没有矩阵， 函数返回空。不要更改这个矩阵。如果你要为可绘制对象设置不同的矩阵， 请调用 setImageMatrix()。

　　public ImageView.ScaleType getScaleType ()

返回当前 ImageView 使用的缩放类型。
　　相关 XML 属性
　　　　　　android:scaleType

　　参见
ImageView.ScaleType

　　public void invalidateDrawable (Drawable dr)

使指定的可绘制对象失效。
参数
dr 要设为失效的可绘制对象。

　　public void jumpDrawablesToCurrentState ()

调用与视图相关的所有可绘制对象的Drawable.jumpToCurrentState()方法。

　　public int[] onCreateDrawableState (int extraSpace)

为当前视图生成新的 Drawable 状态时发生。当视图系统检测到缓存的可绘制对象失效时，调用该方法.你可以使用 getDrawableState() 方法重新取得当前的状态。
　　参数
　　extraSpace 如果为非零，该值为你要在返回值的数组中存放的你自己的状态信息的数量。
　　返回值
　　返回保存了视图的当前 Drawable 状态的数组。

　　public void setAdjustViewBounds (boolean adjustViewBounds)

当你需要在 ImageView 调整边框时保持可绘制对象的比例时，将该值设为真。
参数
adjustViewBounds 是否调整边框，以保持可绘制对象的原始比例。
相关 XML 属性
android:adjustViewBounds

public void setAlpha (int alpha)
（译者注：设置透明度）

public void setBaseline (int baseline)
　　设置部件顶部边界文本基线的偏移量。这个值覆盖setBaselineAlignBottom(boolean)设置的属性值。

参数
baseline 使用的基线，或不提供设置为-1。
相关 XML属性
android:baseline
参见
setBaseline(int)

public void setBaselineAlignBottom (boolean aligned)
设置是否设置视图底部的视图基线。设置这个值覆盖setBaseline()的所有调用。
参数
aligned 如果为true，图像视图将基线与父控件底部边缘对齐。
相关 XML属性
android:baselineAlignBottom

public final void setColorFilter (int color)
为图片设置着色选项。采用SRC_ATOP合成模式。
参数
color 应用的着色颜色。
相关 XML 属性
android:tint

public void setColorFilter (ColorFilter cf)
为图片应用任意颜色滤镜。
参数
cf 要应用的颜色滤镜（可能为空）

public final void setColorFilter (int color, PorterDuff.Mode mode)
为图片设置着色选项。
参数
color 应用的着色颜色。
mode 如何着色。标准模式为 SRC_ATOP。
相关 XML 属性
android:tint

public void setImageBitmap (Bitmap bm)

设置位图作为该 ImageView 的内容。
参数
bm 设置的位图。

public void setImageDrawable (Drawable drawable)

设置可绘制对象为该 ImageView 显示的内容。
参数
drawable 设置的可绘制对象。

public void setImageLevel (int level)

设置图片的等级，当图片来自于 LevelListDrawable 时。（译者注：使用参见这里）
参数
level 图片的新的等级。

public void setImageMatrix (Matrix matrix)
（译者注：矩阵变换）

public void setImageResource (int resId)

通过资源ID设置可绘制对象为该 ImageView 显示的内容。
注意：该操作读取位图，并在 UI 线程中解码，因此可能导致反应迟缓。 如果反应迟缓，可以考虑用 setImageDrawable(Drawable)、 setImageBitmap(Bitmap) 或者 BitmapFactory 代替。
参数
resId 可绘制对象的资源标识。
相关 XML 属性
android:src

public void setImageState (int[] state, boolean merge)

（译者注：设置视图的可见和不可见，使用参见这里）

public void setImageURI (Uri uri)

设置指定的 URI 为该 ImageView 显示的内容。
注意：该操作读取位图，并在 UI 线程中解码，因此可能导致反应迟缓。 如果反应迟缓，可以考虑用 setImageDrawable(Drawable)、 setImageBitmap(Bitmap) 或者 BitmapFactory 代替。
参数
uri 图像的 URI。

public void setMaxHeight (int maxHeight)
用于设置该视图支持的最大高度的可选参数。只有 setAdjustViewBounds(boolean) 为真时有效。要设置图像最大尺寸为 100×100，并保持原始比率，做法如下：
1) 设置 adjustViewBounds 为真；
2) 设置 maxWidth 和 maxHeight 为 100；
3) 设置宽、高的布局参数为 WRAP_CONTENT。
注意，如果原始图像较小，即使设置了该参数，图像仍然要比 100×100 小。如果要设置图片为 固定大小，需要在布局参数中指定大小，并使用 setScaleType(ImageView.ScaleType) 函数来检测，如何 将其调整到适当的大小。
参数
maxHeight 该视图的最大高度。
相关 XML 属性
android:maxHeight

public void setMaxWidth (int maxWidth)

用于设置该视图支持的最大宽度的可选参数。只有 setAdjustViewBounds(boolean) 为真时有效。要设置图像最大尺寸为 100×100，并保持原始比率，做法如下：
4) 设置 adjustViewBounds 为真；
5) 设置 maxWidth 和 maxHeight 为 100；
6) 设置宽、高的布局参数为 WRAP_CONTENT。
注意，如果原始图像较小，即使设置了该参数，图像仍然要比 100×100 小。如果要设置图片为 固定大小，需要在布局参数中指定大小，并使用 setScaleType(ImageView.ScaleType) 函数来检测，如何 将其调整到适当的大小。
参数
maxWidth 该视图的最大宽度。
相关 XML 属性
android:maxWidth

public void setScaleType (ImageView.ScaleType scaleType)
控制图像应该如何缩放和移动，以使图像与 ImageView 一致。
参数
scaleType 需要的缩放方式。
相关 XML 属性
android:scaleType

public void setSelected (boolean selected)
改变视图的选中状态。视图有选中和未选中两个状态。注意，选择状态不同于焦点。 典型的选中的视图是象 ListView 和 GridView 这样的 AdapterView 中显示的 内容；选中的内容会显示为高亮。
参数
selected 为真，将视图设为选中状态；否则为假。

受保护方法

protected void drawableStateChanged ()
在视图状态的变化影响到所显示可绘制对象的状态时调用该方法。
覆盖该方法时，要确保调用了父类的该方法。

protected void onDraw (Canvas canvas)
实现该方法，用于自己绘制内容。
参数
canvas 用于绘制背景的画布。

protected void onMeasure (int widthMeasureSpec, int heightMeasureSpec)
评估视图及其内容，以决定其宽度和高度.此方法由 measure(int, int) 调用，子类可以重载以提供更精确、更有效率的衡量其内容尺寸的方法。
约定： 覆盖该方法时，必须调用 setMeasuredDimension(int, int) 方法来保存评估结果的视图的宽度和高度.如果忘记将导致 measure(int, int) 方法抛出IllegalStateException异常。要有效的利用父类的 onMeasure(int, int)方法。
基类测量的是背景的大小，除非 MeasureSpec 允许超过背景.子类应该重写 onMeasure(int, int) 方法，以为其内容提供更适合的大小。
如果重写了该方法，子类要确保其高度和宽度大于等于视图的最小高度和宽度. （getSuggestedMinimumHeight() 和 getSuggestedMinimumWidth()）
参数
widthMeasureSpec 父视图要求的横向空间大小.该要求由 View.MeasureSpec 进行了编码处理。
heightMeasureSpec 父视图要求的纵向空间大小.该要求由 View.MeasureSpec 进行了编码处理。

protected boolean onSetAlpha (int alpha)
透明度改变时执行。子类可以使用该方法指定透明度值，然后返回真； 在调用 onDraw() 时，使用该透明度值。如果返回假，则先在不可见的缓存中绘制视图， 完成该请求；看起来不错，但是可能相对于在子类中绘制要慢。默认实现返回假。
参数
alpha 应用到视图的透明度值 (0…255)。
返回值
如果该类可以绘制该阿尔法值返回真。

protected boolean setFrame (int l, int t, int r, int b)
为视图指定大小和位置。 该方法有布局调用。
参数
l 左侧位置，相对于父容器。
t 顶部位置，相对于父容器。
r 右侧位置，相对于父容器。
b 底部位置，相对于父容器。
返回值
true 如果新的大小和位置与之前的不同，返回真。

protected boolean verifyDrawable (Drawable dr)
如果你的视图子类显示自己的可绘制对象，他应该重写此方法并为自己的每个可绘制对象返回真。该函数允许为这些可绘制对象准备动画效果。
重写此方法时，要保证调用其父类的该方法。
参数
dr 待校验的可绘制对象.如果是你显示的对象之一，返回真；否则返回调用父类的返回值。
返回值
boolean 如果可绘制对象已经显示在视图上了，返回真；否则返回假，不允许动画效果。

补充

文章精选

Android ImageView 加边框

Android用ImageView显示本地和网上的图片

imageView动画效果

示例代码

android:tint

<ImageView android:background="@android:color/white" android:src="@drawable/btn_mode_switch_bg"
android:layout_width="wrap_content" android:layout_height="wrap_content"></ImageView>
<ImageView android:layout_marginLeft="5dp" android:background="@android:color/white" android:tint="#ffff00" android:src="@drawable/btn_mode_switch_bg"
android:layout_width="wrap_content" android:layout_height="wrap_content"></ImageView>

android:cropToPadding
<ImageView android:background="@android:color/white" android:scrollY="-10px" android:cropToPadding="true" android:src="@drawable/btn_mode_switch_bg"
android:layout_width="wrap_content" android:layout_height="wrap_content"></ImageView>
<ImageView android:background="@android:color/white" android:scrollY="10px" android:cropToPadding="true" android:src="@drawable/btn_mode_switch_bg"
android:layout_width="wrap_content" android:layout_height="wrap_content"></ImageView>
<ImageView android:paddingTop="10px" android:background="@android:color/white" android:scrollY="10px" android:cropToPadding="true" android:src="@drawable/btn_mode_switch_bg"
android:layout_width="wrap_content" android:layout_height="wrap_content"></ImageView>
<ImageView android:paddingTop="10px" android:background="@android:color/white" android:scrollY="10px" android:cropToPadding="false" android:src="@drawable/btn_mode_switch_bg"
android:layout_width="wrap_content" android:layout_height="wrap_content"></ImageView>

ImageView.ScaleType
译者署名：小易
译者博客：http://blog.sina.com.cn/xjtuyi
版本：Android 3.1 r1

结构
继承关系
public static final enum ImageView.ScaleType extends Enum<E extends Enum<E>>

java.lang.Object
java.lang.Enum<E extends java.lang.Enum<E>>
android.widget.ImageView.ScaleType

类概述
将图片边界缩放，以适应视图边界时的可选项。

常量
public static final ImageView.ScaleType CENTER
在视图中使图像居中，不执行缩放。 在 XML 中可以使用的语法： android:scaleType="center"。

public static final ImageView.ScaleType CENTER_CROP
均衡的缩放图像（保持图像原始比例），使图片的两个坐标（宽、高）都大于等于 相应的视图坐标（负的内边距）。图像则位于视图的中央。 在 XML 中可以使用的语法：android:scaleType="centerCrop"。

public static final ImageView.ScaleType CENTER_INSIDE
均衡的缩放图像（保持图像原始比例），使图片的两个坐标（宽、高）都小于等于 相应的视图坐标（负的内边距）。图像则位于视图的中央。 在 XML 中可以使用的语法：android:scaleType="centerInside"。

public static final ImageView.ScaleType FIT_CENTER
使用 CENTER 方式缩放图像。 在 XML 中可以使用的语法： android:scaleType="fitCenter"。

public static final ImageView.ScaleType FIT_END
使用 END 方式缩放图像。 在 XML 中可以使用的语法： android:scaleType="fitEnd"。

public static final ImageView.ScaleType FIT_START
使用 START 方式缩放图像。 在 XML 中可以使用的语法：android:scaleType="fitStart"。

public static final ImageView.ScaleType FIT_XY
使用 FILL 方式缩放图像。 在 XML 中可以使用的语法： android:scaleType="fitXY"。

public static final ImageView.ScaleType MATRIX
绘制时，使用图像矩阵方式缩放。图像矩阵可以通过 setImageMatrix(Matrix) 设置。在 XML 中可以使用的语法： android:scaleType="matrix"。

补充

文章精选

Android API之ImageView.ScaleType代码演示