Android_ViewStub

public final class ViewStub extends View

  • java.lang.Object
    • android.view.View
      • android.view.ViewStub

类摘要:

ViewStub 是一个隐藏的,不占用内存空间的视图对象,它可以在运行时延迟加载布局资源文件。当 ViewStub 可见,或者调用 inflate()函数时,才会加载这个布局资源文件。该
ViewStub 在加载视图时在父容器中替换它本身。因此,ViewStub 会一直存在于视图中,直到调用 setVisibility(int) 或者 inflate()为止。ViewStub 的布局参数会随着加载的视图

数一同被添加到 ViewStub 父容器。

同样,你也可以通过使用 inflatedId 属性来定义或重命名要加载的视图对象的 Id 值。

例如:

    <ViewStub
        android:id="@+id/stub"
        android:layout_width="100dp"
        android:layout_height="100dp"
        android:inflatedId="@+id/subTree"
        android:layout="@layout/mySubTree" />


通过"stud"id 可以找到被定义的 ViewStub 对象。加载布局资源文件"mySubTree "后,ViewStub 对象从其父容器中移除。可以通过 id"subTree"找到由布局资源"mySubTree"创建的View。这个视图对象最后被指定为宽 100dip,高 100dip。执行加载布局资源文件的推荐方式

如下:
ViewStub stub = findViewById(R.id.stub);
View inflated = stub.inflate();

当 inflate()被调用, 这个 ViewStub 被加载的视图替代并且返回这个视图对象。这使得应用程序不需要额外执行 findViewById()来获取加载视图的引用。

这个类大概意思是用 ViewStub 类和在 XML 文件里面指定的布局资源文件关联起来,让布局资源文件在需要使用的时候再加载上去。主要作用是性能优化,什么时候用什么时候加载,不用在开始启动的时候一次加载,既可以加快程序的启动速度,又可以节省内存资源

嵌套类

接口ViewStub.OnInflateListener

一个用于接收 ViewStub 已经成功加载布局资源文件的通知的监听器。

XML 属性


属性名称 相关方法 描述
android:inflatedId setInflatedId(int) 覆盖待加载视图的 id 值。
android:layout setLayoutResource(int) 要引用的布局资源文件 id

构造函数

ViewStub(Context context, int layoutResource)

创建一个与指定的布局资源文件关联的 ViewStub 对象。

参数layoutResource 要加载的布局资源文件的 id 值。

公共方法

public void draw (Canvas canvas)

参数canvas 这个画布传到那个已渲染的视图对象。

手动在指定的画布绘制这个视图(及所有其子视图)。这个视图必须在调用这个函数之前做好了整体布局。

当要自己实现一个视图时,不要重载这个方法;相反,你应该重载onDraw(Canvas)方法。

主要用于自定义的视图组件的方法

public int getInflatedId ()
返回加载的布局资源文件的 ID,如果加载的布局资源文件的 id是 NO_ID,那么这个加载的 View 将保留它原来的 id 值。

相关 XML 属性:android:inflatedId

返回值:一个正整数来标识这个要加载的视图或者 NO_ID 将保持加载视图原来的 id。

参见setInflatedId(int)

public int getLayoutResource ()

返回加载的布局资源文件的 id 值

相关 XML 属性:android:layout

返回值:加载到视图对象的布局资源文件 id 值。

参见

  • setLayoutResource(int)
  • setVisibility(int)
  • inflate()
public View inflate ()
加载 getLayoutResource()方法标识的布局资源,并通过 加载布局资源替换父容器中它自己

返回值:这个已加载的布局资源文件.

public void setInflatedId (int inflatedId)

参数inflatedId: 一个正整数来标识这个加载视图或者 NO_ID 将保持加载视图原来的 id。

设置加载视图的 ID。如果这个 id 为 NO_ID,这个加载视图保持它原来的 id 不变。

相关 XML 属性:android:inflatedId

参见getInflatedId()

public void setLayoutResource (int layoutResource)

参数layoutResource: 一个有效的布局资源文件 id 值(不等于 0)。

设置待加载的布局资源文件,当 ViewStub 被设置为 visible 或 invisible 或调用 inflate()时使用。这个在加载布局资源文件时创建的视图用来 在父容器中替换它自己

相关 XML 属性:android:layout

参见

  • getLayoutResource()
  • setVisibility(int)
  • inflate()
public void setOnInflateListener (ViewStub.OnInflateListener inflateListener)
参数inflateListener: 该 OnInflateListener 在成功加载后得到事件通知。

设置成功加载布局资源文件后事件通知的监听器

参见ViewStub.OnInflateListener

public void setVisibility (int visibility)

参数visibility 设置为 VISIBLE(显示), INVISIBLE(隐藏), 或 GONE(完全隐藏,不暂用布局位置)

当可见性设置为 VISIBLE 或 INVISIBLE,inflate()将被调用,并且加载视图资源在父容器中

替换 ViewStub。

参见inflate()

受保护方法

protected void dispatchDraw (Canvas canvas)

调用这个函数去绘制这个控件的子视图。可以通过派生类重写在绘制子类之前获取控制(但是是在他自己的视图已经被绘制完之后)

参数canvas 这个画布传到那个已渲染的视图对象。

protected void onMeasure (int widthMeasureSpec, int heightMeasureSpec)

参数

  • widthMeasureSpec 由于父类有横向空间要求,参见 View.MeasureSpec。
  • heightMeasureSpec 由于父类有纵向空间要求,参见 View.MeasureSpec。

测量这个视图以确定其内容的高度和宽度。通过 measure(int, int)来调用这个方法,并且应该由子类重写以提高内容测量的效率和精确度。

约定:当该方法被重写时,你必须调用 setMeasuredDimension(int, int)来存储已测量视图的高度和宽度。否则将通过 measure(int, int)抛出一个 IllegalStateException 异常

调用父类的 onMeasure(int, int)方法是一个有效的办法。父类的实现是以背景大小为默认大小,除非 MeasureSpec(测量细则)允许更大的背景。 为了更好测量内容子类应该重写 onMeasure(int, int)。

如果这个方法被重写,子类有责任确保测量它的高度和宽度至少是视图的最小宽度和高度(getSuggestedMinimumHeight()和 getSuggestedMinimumWidth())。

你可能感兴趣的:(ViewStub)