Egret Engine R - v6.0.0
    Preparing search index...

    Image 控件允许您在运行时显示 JPEG、PNG 等图片文件文件。Image 继承至 Bitmap,因此您可以直接对其 bitmapData 属性, 赋值从外部加载得到的位图数据以显示对应图片。同时,Image 还提供了更加方便的 source 属性,source 属性可以接受一个网络图片url作为值, 赋值为url后,它内部会自动去加载并显示图片。并且您同样也可以直接把 BitmapData 对象赋值给 source 属性以显示图片。

    Event.COMPLETE 当图片加载完成后调度

    Egret 2.4

    eui 1.0

    Web

    extension/eui/components/ImageExample.ts

    zh_CN

    Hierarchy

    • Bitmap
      • Image

    Implements

    Index
    • 构造函数。

      Parameters

      • Optionalsource: any

        用于位图填充的源。可以是一个字符串或者 Texture 对象

      Returns Image

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    includeInLayout: boolean

    UIComponent#includeInLayout

    Egret 2.4

    eui 1.0

    Web

    left: any

    UIComponent#left

    Egret 2.4

    eui 1.0

    Web

    right: any

    UIComponent#right

    Egret 2.4

    eui 1.0

    Web

    top: any

    UIComponent#top

    Egret 2.4

    eui 1.0

    Web

    bottom: any

    UIComponent#bottom

    Egret 2.4

    eui 1.0

    Web

    horizontalCenter: any

    UIComponent#horizontalCenter

    Egret 2.4

    eui 1.0

    Web

    verticalCenter: any

    UIComponent#verticalCenter

    Egret 2.4

    eui 1.0

    Web

    percentWidth: number

    UIComponent#percentWidth

    Egret 2.4

    eui 1.0

    Web

    percentHeight: number

    UIComponent#percentHeight

    Egret 2.4

    eui 1.0

    Web

    explicitWidth: number

    UIComponent#explicitWidth

    Egret 2.4

    eui 1.0

    Web

    explicitHeight: number

    UIComponent#explicitHeight

    Egret 2.4

    eui 1.0

    Web

    minWidth: number

    UIComponent#minWidth

    Egret 2.4

    eui 1.0

    Web

    maxWidth: number

    UIComponent#maxWidth

    Egret 2.4

    eui 1.0

    Web

    minHeight: number

    UIComponent#minHeight

    Egret 2.4

    eui 1.0

    Web

    maxHeight: number

    UIComponent#maxHeight

    Egret 2.4

    eui 1.0

    Web

    • get scale9Grid(): Rectangle

      矩形区域,它定义素材对象的九个缩放区域。 注意:此属性仅在fillModeBitmapFillMode.SCALE时有效。

      Returns Rectangle

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • set scale9Grid(value: Rectangle): void

      Parameters

      • value: Rectangle

      Returns void

    • get fillMode(): string

      确定位图填充尺寸的方式。

      设置为 BitmapFillMode.CLIP时,位图将在边缘处被截断。

      设置为 BitmapFillMode.REPEAT时,位图将重复以填充区域。

      设置为 BitmapFillMode.SCALE时,位图将拉伸以填充区域。

      Returns string

      <code>BitmapFillMode.SCALE</code>
      

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • set fillMode(value: string): void

      Parameters

      • value: string

      Returns void

    • Parameters

      • unscaledWidth: number
      • unscaledHeight: number

      Returns void

      UIComponent#updateDisplayList

      Egret 2.4

      eui 1.0

      Web

    • 标记提交过需要延迟应用的属性,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。

      这是一个很有用的机制,可将组件更改延迟到稍后屏幕更新时进行处理,从而消除了重复的工作。

      例如,要更改文本颜色和大小,如果在更改颜色后立即进行更新,然后在设置大小后再更新大小,就有些浪费。 同时更改两个属性后再使用新的大小和颜色一次性呈示文本,效率会更高。

      很少调用 Invalidation 方法。通常,在组件上设置属性会自动调用合适的 invalidation 方法。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 通常,子类应覆盖 commitProperties() 方法,而不是覆盖此方法。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 标记提交过需要验证组件尺寸,以便在稍后屏幕更新期间调用该组件的 measure() 方法。

      Invalidation 是一个很有用的机制,可将组件更改延迟到稍后屏幕更新时进行处理,从而消除了重复的工作。

      例如,要更改文本和字体大小,如果在更改文本后立即进行更新,然后在设置大小后再更新大小,就有些浪费。 更改两个属性后再使用新的大小一次性呈示文本,效率会更高。

      很少调用 Invalidation 方法。通常,在组件上设置属性会自动调用合适的 invalidation 方法。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 验证组件的尺寸。

      Parameters

      • Optionalrecursive: boolean

        如果为 true,则调用对象子项的此方法。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 标记需要验证显示列表,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。

      Invalidation 是一个很有用的机制,可将组件更改延迟到稍后屏幕更新时进行处理,从而消除了重复的工作。

      例如,要更改宽度和高度,如果在更改宽度后立即更新组件,然后在设置新高度后再次更新组件,就有些浪费。 更改两个属性后再使用新的大小一次性呈示组件,效率会更高。

      很少调用 Invalidation 方法。通常,在组件上设置属性会自动调用合适的 invalidation 方法。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 验证并更新此对象的属性和布局,如果需要的话重绘对象。

      通常只有当脚本执行完毕后,才会处理要求进行大量计算的处理属性。

      例如,对 width 属性的设置可能会延迟,因为此设置需要重新计算这些对象的子项或父项的宽度。 如果脚本多次设置了 width 属性,则延迟处理可防止进行多次处理。此方法允许您手动覆盖此行为。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 设置元素的布局大小。这是元素在屏幕上进行绘制时所用的大小。

      如果 width 和/或 height 参数尚未指定 (NaN)),则 EUI 会将该元素的布局大小设置为首选宽度和/或首选高度。

      请注意,调用 setLayoutBoundSize() 方法会影响布局位置,因此请在调用 setLayoutBoundSize() 之后再调用 setLayoutBoundPosition()。

      Parameters

      • layoutWidth: number

        元素的布局宽度。

      • layoutHeight: number

        元素的布局高度。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 设置元素在屏幕上进行绘制时所用的布局坐标。

      请注意,调用 setLayoutBoundSize() 方法会影响布局位置,因此请在调用 setLayoutBoundSize() 之后再调用 setLayoutBoundPosition()。

      Parameters

      • x: number

        边框左上角的 X 坐标。

      • y: number

        边框左上角的 Y 坐标。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 组件的布局尺寸,常用于父级的updateDisplayList()方法中。

      按照:布局尺寸>外部显式设置尺寸>测量尺寸 的优先级顺序返回尺寸。

      注意此方法返回值已经包含scale和rotation。

      Parameters

      • bounds: Rectangle

        可以放置结果的Rectangle实例。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 获取组件的首选尺寸,常用于父级的measure()方法中。

      按照:外部显式设置尺寸>测量尺寸 的优先级顺序返回尺寸。

      注意此方法返回值已经包含scale和rotation。

      Parameters

      • bounds: Rectangle

        可以放置结果的Rectangle实例。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN