农民伯伯android,Android3.1r1API中文文档——ImageView（cnmahj+农民伯伯）.doc.doc-CSDN博客

Android3.1r1API中文文档——ImageView(cnmahj+农民伯伯).doc.doc

ImageView

译者署名： cnmahj、农民伯伯

译者博客：/cnmahj

版本：Android 3.1 r1

结构

继承关系

public class View.OnClickListner extends View

java.lang.Object

android.view.View

android.widget.ImageView

直接子类

ImageButton, QuickContactBadge

间接子类

ZoomButton

类概述

显示任意图像，例如图标。ImageView类可以加载各种来源的图片(如资源或图片库)，需要计算图像的尺寸，比便它可以在其他布局中使用，并提供例如缩放和着色(渲染)各种显示选项。

嵌套类

enum ImageView.ScaleType

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

XML属性

属性名称

描述

android:adjustViewBounds

设置该属性为真可以在 ImageView 调整边界时保持图片的纵横比例。(译者注：需要与maxWidth、MaxHeight一起使用，否则单独使用没有效果。)

android:baseline

视图内基线的偏移量

android:baselineAlignBottom

如果为true，图像视图将基线与父控件底部边缘对齐。

android:cropToPadding

如果为真，会剪切图片以适应内边距的大小。(译者注：是否截取指定区域用空白代替。单独设置无效果，需要与scrollY一起使用，效果如下，实现代码见代码部分：

)

android:maxHeight

为视图提供最大高度的可选参数。(译者注：单独使用无效，需要与setAdjustViewBounds一起使用。如果想设置图片固定大小，又想保持图片宽高比，需要如下设置：

1)设置setAdjustViewBounds为true；

2)设置maxWidth、MaxHeight；

3)设置设置layout_width和layout_height为wrap_content。)

android:maxWidth

为视图提供最大宽度的可选参数。

android:scaleType

控制为了使图片适合 ImageView 的大小，应该如何变更图片大小或移动图片。一定是下列常量之一：

常量

值

描述

matrix

用矩阵来绘图

fitXY

拉伸图片(不按比例)以填充View的宽高

fitStart

按比例拉伸图片，拉伸后图片的高度为View的高度，且显示在View的左边

fitCenter

按比例拉伸图片，拉伸后图片的高度为View的高度，且显示在View的中间

fitEnd

按比例拉伸图片，拉伸后图片的高度为View的高度，且显示在View的右边

center

按原图大小显示图片，但图片宽高大于View的宽高时，截图图片中间部分显示

centerCrop

按比例放大原图直至等于某边View的宽高显示。

centerInside

当原图宽高或等于View的宽高时，按原图大小居中显示；反之将原图缩放至View的宽高居中显示。

(译者注：设置图片的填充方式。)

android:src

设置可绘制对象作为 ImageView 显示的内容

android:tint

为图片设置着色颜色。(译者注：将图片渲染成指定的颜色。见下图：

左边为原图，右边为设置后的效果，见后面代码。)

公共方法

public final void clearColorFilter ()

(译者注：清除颜色过滤，参见这里)

public int getBaseline ()

返回部件顶端到文本基线的偏移量。如果小部件不支持基线对齐，该方法返回 -1。

返回值

小部件顶端到文本基线的偏移量；或者是 -1 当小部件不支持基线对齐时。

public boolean getBaselineAlignBottom ()

返回当前视图基线是否将考虑视图的底部。

参见

setBaselineAlignBottom(boolean)

public Drawable getDrawable ()

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

public Matrix getImageMatrix ()

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

public ImageView.ScaleType getScaleType ()

返回当前 ImageView 使用的缩放类型。