Android API 25 （Android 7.1.1）

ImageView

public class ImageView

extends View

Added in API level 1

java.lang.Object

   ↳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

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)

屬性說明：設定檢視是否基於底部邊緣進行基線對齊。預設為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(intmaxHeight)

屬性說明：設定檢視的最大高度的可選引數。

必須是帶單位的浮點型尺寸值（float），如：”14.5sp”。有效的單位包括：px(畫素)、dp(密度無關畫素)、sp(通常用於字型尺寸的可伸縮畫素)、in(英寸)、mm(毫米)。

也可以引用一個包含此型別值的資源（格式：@[package:]type:name）或主題屬性（格式：?[package][type:]name）。

對應的全域性屬性資源符號是maxHeight。

android:  maxWidth

API 1

關聯方法：setMaxWidth(intmaxWidth)

屬性說明：設定檢視的最大寬度的可選引數。

必須是帶單位的浮點型尺寸值（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屬性】

【公共建構函式】

ImageView(Context context)

ImageView(Context context, AttributeSet attrs)

ImageView(Context context, AttributeSet attrs, int defStyleAttr)

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