文章目录

一、自定义组件构造方法简介1、View(Context context) 构造函数2、View(Context context, @Nullable AttributeSet attrs)3、View(Context context, @Nullable AttributeSet attrs, int defStyleAttr) 构造函数4、View(Context context, @Nullable AttributeSet attrs, int defStyleAttr, int defStyleRes) 构造函数 二、代码示例三、源码及资源下载

官方文档 API : BitmapRegionDecoder

一、自定义组件构造方法简介

---

1、View(Context context) 构造函数

---

在代码中创建 View 对象 , 就会调用该构造函数 , 其中 Context context 参数是组件运行的环境 , 可以从该 Context 对象中获取当前的主题 , 资源等 ;

/** * 代码中创建组件调用该方法 * @param context View 组件运行的上下文对象 , 一般是 Activity , * 可以通过该上下获取当前主题 , 资源等 */ public LongImageView(Context context) { super(context); }

2、View(Context context, @Nullable AttributeSet attrs)

---

1 . 构造函数简介 :

① 构造函数使用时机 : 布局文件中使用组件调用该方法 , 当 View 组件从 XML 布局文件中构造时 , 调用该方法 ;

② 属性指定 : 提供的 AttributeSet 属性在 XML 文件中指定 ;

③ 默认风格 : 该方法使用默认的风格 defStyleAttr = 0 , 该组件的属性设置只有 Context 中的主题和 XML 中的属性 ;

2 . 参数分析 :

① Context context 参数 : View 组件运行的上下文环境 , 通过该对象可以获取当前主题 , 资源等 ;

② AttributeSet attrs 参数 : XML 布局文件中的 View 组件标签中的属性值 ;

/** * 布局文件中使用组件调用该方法 ; * 当 View 组件从 XML 布局文件中构造时 , 调用该方法 * 提供的 AttributeSet 属性在 XML 文件中指定 ; * 该方法使用默认的风格 defStyleAttr = 0 , * 该组件的属性设置只有 Context 中的主题和 XML 中的属性 ; * * @param context View 组件运行的上下文环境 , * 通过该对象可以获取当前主题 , 资源等 * @param attrs XML 布局文件中的 View 组件标签中的属性值 */ public LongImageView(Context context, @Nullable AttributeSet attrs) { super(context, attrs); }

3、View(Context context, @Nullable AttributeSet attrs, int defStyleAttr) 构造函数

---

1 . 构造函数简介 :

① 构造函数使用时机 : 布局文件中使用组件调用该方法 , 当 View 组件从 XML 布局文件中构造时 , 调用该方法 ;

② 主题风格 : 从 XML 中加载组件同时还会提供一个主题属性风格 ;

③ 属性指定 : 提供的 AttributeSet 属性在 XML 文件中指定 ;

④ 主题风格 : View 组件使用该构造方法 , 从布局中加载时 , 允许使用一个特定风格 ;

⑤ 示例 : 如 : 按钮类的构造函数会传入 defStyleAttr = R.attr.buttonStyle 风格作为参数 ;

2 . 参数分析 :

① Context context 参数 : View 组件运行的上下文环境 , 通过该对象可以获取当前主题 , 资源等 ;

② AttributeSet attrs 参数 : XML 布局文件中的 View 组件标签中的属性值 ;

③ int defStyleAttr 参数 : 默认的 Style 风格 , 当前的应用 Application 或 Activity 设置了风格主题后 , 才生效 ;

/** * 布局文件中加载组件 , 并提供一个主题属性风格 ; * View 组件使用该构造方法 , 从布局中加载时 , 允许使用一个特定风格 ; * 如 : 按钮类的构造函数会传入 defStyleAttr = R.attr.buttonStyle 风格作为参数 ; * * @param context View 组件运行的上下文环境 , * 通过该对象可以获取当前主题 , 资源等 * @param attrs XML 布局文件中的 View 组件标签中的属性值 * @param defStyleAttr 默认的 Style 风格 * 当前的应用 Application 或 Activity 设置了风格主题后 , 才生效 */ public LongImageView(Context context, @Nullable AttributeSet attrs, int defStyleAttr) { super(context, attrs, defStyleAttr); }

4、View(Context context, @Nullable AttributeSet attrs, int defStyleAttr, int defStyleRes) 构造函数

---

1 . 版本兼容 : Android 5.0（API 级别 21）LOLLIPOP 版本加入的构造函数 , 定义该构造函数 , 必须加上 @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP) 注解 ;

2 . 构造函数简介 :

① 构造函数使用时机 : 布局文件中使用组件调用该方法 , 当 View 组件从 XML 布局文件中构造时 , 调用该方法 ;

② 主题风格或资源 : 从 XML 中加载组件同时还会提供一个主题属性风格 , 或资源 ;

③ 属性指定 : 提供的 AttributeSet 属性在 XML 文件中指定 ;

④ 主题风格 : View 组件使用该构造方法 , 从布局中加载时 , 允许使用一个特定风格 ;

⑤ 示例 : 如 : 按钮类的构造函数会传入 defStyleAttr = R.attr.buttonStyle 风格作为参数 ;

3 . 属性设置优先级 ( 优先级从高到低 ) :

布局文件中的标签属性 AttributeSet

defStyleAttr 指定的默认风格

defStyleRes 指定的默认风格

主题的属性值

4 . 参数分析 :

① Context context 参数 : View 组件运行的上下文环境 , 通过该对象可以获取当前主题 , 资源等 ;

② AttributeSet attrs 参数 : XML 布局文件中的 View 组件标签中的属性值 ;

③ int defStyleAttr 参数 : 默认的 Style 风格 , 当前的应用 Application 或 Activity 设置了风格主题后 , 才生效 ;

④ int defStyleRes 参数 : style 资源的 id 标识符 , 提供组件的默认值 , 只有当 defStyleAttr 参数是 0 时 , 或者主题中没有 style 设置 ; 默认可以设置成 0 ;

/** * 布局文件中加载组件 , 并提供一个主题属性属性 , 或风格资源 ; * 该构造方法允许组件在加载时使用自己的风格 ; * * 属性设置优先级 ( 优先级从高到低 ) * 1. 布局文件中的标签属性 AttributeSet * 2. defStyleAttr 指定的默认风格 * 3. defStyleRes 指定的默认风格 * 4. 主题的属性值 * * @param context View 组件运行的上下文环境 , * 通过该对象可以获取当前主题 , 资源等 * @param attrs XML 布局文件中的 View 组件标签中的属性值 * @param defStyleAttr 默认的 Style 风格 * 当前的应用 Application 或 Activity 设置了风格主题后 , 才生效 * @param defStyleRes style 资源的 id 标识符 , 提供组件的默认值 , * 只有当 defStyleAttr 参数是 0 时 , 或者主题中没有 style 设置 ; * 默认可以设置成 0 ; */ @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP) public LongImageView(Context context, @Nullable AttributeSet attrs, int defStyleAttr, int defStyleRes) { super(context, attrs, defStyleAttr, defStyleRes); }

二、代码示例

---

package kim.hsl.lgl; import android.content.Context; import android.os.Build; import android.util.AttributeSet; import android.view.View; import androidx.annotation.Nullable; import androidx.annotation.RequiresApi; /** * 长图展示自定义 View 组件 * */ public class LongImageView extends View { /** * 代码中创建组件调用该方法 * @param context View 组件运行的上下文对象 , 一般是 Activity , * 可以通过该上下获取当前主题 , 资源等 */ public LongImageView(Context context) { super(context); } /** * 布局文件中使用组件调用该方法 ; * 当 View 组件从 XML 布局文件中构造时 , 调用该方法 * 提供的 AttributeSet 属性在 XML 文件中指定 ; * 该方法使用默认的风格 defStyleAttr = 0 , * 该组件的属性设置只有 Context 中的主题和 XML 中的属性 ; * * @param context View 组件运行的上下文环境 , * 通过该对象可以获取当前主题 , 资源等 * @param attrs XML 布局文件中的 View 组件标签中的属性值 */ public LongImageView(Context context, @Nullable AttributeSet attrs) { super(context, attrs); } /** * 布局文件中加载组件 , 并提供一个主题属性风格 ; * View 组件使用该构造方法 , 从布局中加载时 , 允许使用一个特定风格 ; * 如 : 按钮类的构造函数会传入 defStyleAttr = R.attr.buttonStyle 风格作为参数 ; * * @param context View 组件运行的上下文环境 , * 通过该对象可以获取当前主题 , 资源等 * @param attrs XML 布局文件中的 View 组件标签中的属性值 * @param defStyleAttr 默认的 Style 风格 * 当前的应用 Application 或 Activity 设置了风格主题后 , 才生效 */ public LongImageView(Context context, @Nullable AttributeSet attrs, int defStyleAttr) { super(context, attrs, defStyleAttr); } /** * 布局文件中加载组件 , 并提供一个主题属性属性 , 或风格资源 ; * 该构造方法允许组件在加载时使用自己的风格 ; * * 属性设置优先级 ( 优先级从高到低 ) * 1. 布局文件中的标签属性 AttributeSet * 2. defStyleAttr 指定的默认风格 * 3. defStyleRes 指定的默认风格 * 4. 主题的属性值 * * @param context View 组件运行的上下文环境 , * 通过该对象可以获取当前主题 , 资源等 * @param attrs XML 布局文件中的 View 组件标签中的属性值 * @param defStyleAttr 默认的 Style 风格 * 当前的应用 Application 或 Activity 设置了风格主题后 , 才生效 * @param defStyleRes style 资源的 id 标识符 , 提供组件的默认值 , * 只有当 defStyleAttr 参数是 0 时 , 或者主题中没有 style 设置 ; * 默认可以设置成 0 ; */ @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP) public LongImageView(Context context, @Nullable AttributeSet attrs, int defStyleAttr, int defStyleRes) { super(context, attrs, defStyleAttr, defStyleRes); } }

三、源码及资源下载

---

源码及资源下载地址 :

① GitHub 工程地址 : Long_Graph_Loading

② LongImageView.java 主界面代码地址 : LongImageView.java , 这是上述示自定义组件代码 ;