API 25 (Android 7.1.1 API) widget.ImageView——属性分析

Android API 25 （Android 7.1.1）

ImageView
public class ImageView
extends View

Added in
API level 1
 
java.lang.Object
   ↳android.view.View
    ↳android.widget.ImageView
 
已知直接子类
AppCompatImageView
ImageButton
QuickContactBadge
 

【概述】

显示任意图像，例如图标。 ImageView类可以加载来自各种源（例如资源或内容提供者）的图像，负责从图像计算其测量，使得其可以在任何布局管理器中使用，并且提供各种显示选项，例如缩放和着色。
 

【嵌套类】

枚举       ImageView.ScaleType
用于将图像的边界缩放到此视图的边界的选项。
 

【XML属性】

android:  adjustViewBounds

API 1
关联方法：setAdjustViewBounds(boolean
adjustViewBounds)
属性说明：设置是否保持宽高比。
必须是布尔值（boolean），“true”或“false”。
也可以引用一个包含此类型值的资源（格式：@[package:]type:name）或主题属性（格式：?[package][type:]name）。
对应的全局属性资源符号是adjustViewBounds。
 
注意：如果应用程序目标的API级别为17或更低，adjustViewBounds将允许drawable缩小视图边界，但不会增长到在所有情况下填充可用的测量空间。
这是为了与旧版MeasureSpec和RelativeLayout行为的兼容性。
 
需要与maxWidth、MaxHeight一起使用，否则单独使用没有效果。
android：adjustViewBounds=”true”
android:maxHeight=”200dp”
android:maxWidth=”200dp”
android:layout_width=”wrao_content”
android:layout_height=”wrao_content”
 

android:  baseline

API 11
关联方法：setBaseline(int
baseline)
属性说明：设置视图中的基线偏移。有关详细信息，请参阅{android.view.View＃getBaseline}
必须是带单位的浮点型尺寸值（float），如：”14.5sp”。有效的单位包括：px(像素)、dp(密度无关像素)、sp(通常用于字体尺寸的可伸缩像素)、in(英寸)、mm(毫米)。
也可以引用一个包含此类型值的资源（格式：@[package:]type:name）或主题属性（格式：?[package][type:]name）。
对应的全局属性资源符号是baseline。
 

android:  baselineAlignBottom

API 11
关联方法：setBaselineAlignBottom(boolean
aligned)
属性说明：[/b]设置视图是否基于底部边缘进行基线对齐。默认为true。
必须是布尔值（boolean），“true”或“false”。
也可以引用一个包含此类型值的资源（格式：@[package:]type:name）或主题属性（格式：?[package][type:]name）。
对应的全局属性资源符号是baselineAlignBottom。
 

android:  cropToPadding

API 1
关联方法：setCropToPadding(boolean
cropToPadding)
属性说明：设置视图是否剪裁以适合其填充。单独设置无效果，需要与scrollY一起使用。
必须是布尔值（boolean），“true”或“false”。
也可以引用一个包含此类型值的资源（格式：@[package:]type:name）或主题属性（格式：?[package][type:]name）。
对应的全局属性资源符号是cropToPadding。
 

android:  maxHeight

API 1
关联方法：setMaxHeight(int maxHeight)
属性说明：设置视图的最大高度的可选参数。
必须是带单位的浮点型尺寸值（float），如：”14.5sp”。有效的单位包括：px(像素)、dp(密度无关像素)、sp(通常用于字体尺寸的可伸缩像素)、in(英寸)、mm(毫米)。
也可以引用一个包含此类型值的资源（格式：@[package:]type:name）或主题属性（格式：?[package][type:]name）。
对应的全局属性资源符号是maxHeight。

android:  maxWidth

API 1
关联方法：setMaxWidth(int maxWidth) 
属性说明：设置视图的最大宽度的可选参数。
必须是带单位的浮点型尺寸值（float），如：”14.5sp”。有效的单位包括：px(像素)、dp(密度无关像素)、sp(通常用于字体尺寸的可伸缩像素)、in(英寸)、mm(毫米)。
也可以引用一个包含此类型值的资源（格式：@[package:]type:name）或主题属性（格式：?[package][type:]name）。
对应的全局属性资源符号是maxWidth。
 

android:  scaleType

API 1
关联方法：setScaleType(ImageView.ScaleType scaleType)
属性说明：设置图片的填充方式。控制如何调整图像大小或移动以匹配此ImageView的大小。请参阅ImageView.ScaleType。
必须是以下常量之一：
       matrix     用矩阵来绘图。根据3*3的矩阵对图片进行缩放
      fitXY      拉伸图片（不按比例）以填充View的宽高
       fitStart   按比例拉伸图片，拉伸后图片的高度为View的高度，且显示在View的左边
       fitCenter  按比例拉伸图片，拉伸后图片的高度为View的高度，且显示在View的中间
       fitEnd     按比例拉伸图片，拉伸后图片的高度为View的高度，且显示在View的右边
       center     按原图大小显示图片，但图片宽高大于VIE我的宽高时，截取中间部分显示
       centerCrop 按比例放大原图直至等于某边View的宽高显示
       centrInside当原图宽高或等于View的宽高时，按原图大小居中显示；反之将原图缩放至View的宽高居中显示
对应的全局属性资源符号是scaleType。
 

android:  src

API 1
关联方法：setImageResource(int
resId）
           setImageBitmap(Bitmap bm)
          setImageDrawable(Drawable drawable)
          setImageURL(Uri uri)
属性说明：设置此ImageView的drawable（如图片，也可以是颜色，但是需要指定View的大小）
必须引用另一个资源（格式：@[package:]type:name）或主题属性（格式：?[package][type:]name）。
可以是颜色值（color），格式”#rgb”、”#argb”、”#rrggbb”、”#aarrggbb”。
对应的全局属性资源符号是src。
 
这会在UI线程上执行Bitmap读取和解码，这可能会导致延迟瘫痪。 如果这是一个问题，考虑使用setImageDrawable（android.graphics.drawable.Drawable）或setImageBitmap（android.graphics.Bitmap）和BitmapFactory。
 
Android：src与Android：background的区别：
src存放的是原图的大小，不会进行拉伸。Background会根据ImageView组件给定的长宽进行拉伸。
Src是图片内容（前景），background是背景，可以同时使用。
  

android:  tint

API 21
关联方法：setImageTintList(ColorStateList
tint)
属性说明：设置图片色调。后续调用setImageDrawable（Drawable）将自动改变drawable并使用setTintList（ColorStateList）应用指定的色调和色调模式。
必须是颜色值（color），格式”#rgb”、”#argb”、”#rrggbb”、”#aarrggbb”。
也可以引用一个包含此类型值的资源（格式：@[package:]type:name）或主题属性（格式：?[package][type:]name）。
对应的全局属性资源符号是tint。
 

android:  tintMode

API 23
关联方法：setImageTintMode(PorterDuff.Mode
tintMode)
属性说明：设置图片色调的渲染模式。
必须是以下常量之一：
src_over
src_in
src_atop
multiply
screen
add
对应的全局属性资源符号是tintMode。
 

【继承自view.View的XML属性】

跳转view.View
 
 

【公共构造函数】

ImageView(Context context)
ImageView(Context context, AttributeSet attrs)
ImageView(Context context, AttributeSet attrs, int defStyleAttr)
ImageView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)