Interface: Image

Defined in: types/desktop-engine.d.ts:876

Image view component

Extends

• ComponentBase<ImageEventMap>

Properties

children

readonly children: AnyComponent[];

Defined in: types/desktop-engine.d.ts:597

Array of child components (each read returns a new array)

Inherited from

ComponentBase.children

---

height

readonly height: number;

Defined in: types/desktop-engine.d.ts:595

Height after layout (reading triggers layout first)

Inherited from

ComponentBase.height

---

identifier

readonly identifier: string;

Defined in: types/desktop-engine.d.ts:588

Unique identifier of the native component (a pointer string)

Inherited from

ComponentBase.identifier

---

onclick

onclick: 
  | EventHandler<Image, ClickPayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:608

click callback

Inherited from

ComponentBase.onclick

---

ondbclick

ondbclick: 
  | EventHandler<Image, ClickPayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:610

dbclick (double-click) callback

Inherited from

ComponentBase.ondbclick

---

onerror

onerror: 
  | EventHandler<Image, ErrorPayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:891

Called when a src can't be shown: a file that can't be read, a URL the image doesn't load (data: URLs, a path out of the package) or an http(s) URL without the "network" permission. A src replaced before it loaded calls neither callback.

---

onframechange

onframechange: 
  | EventHandler<Image, FrameChangePayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:606

framechange callback

Inherited from

ComponentBase.onframechange

---

onload

onload: 
  | EventHandler<Image, void>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:885

Called when the image of a src has loaded, once for each src set (the same one again too); changing position or size doesn't load it again

---

onmousedown

onmousedown: 
  | EventHandler<Image, MousePayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:612

mousedown callback

Inherited from

ComponentBase.onmousedown

---

onmouseenter

onmouseenter: 
  | EventHandler<Image, MousePayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:616

mouseenter callback

Inherited from

ComponentBase.onmouseenter

---

onmouseleave

onmouseleave: 
  | EventHandler<Image, MousePayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:618

mouseleave callback

Inherited from

ComponentBase.onmouseleave

---

onmousemove

onmousemove: 
  | EventHandler<Image, MousePayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:620

mousemove callback, also while a press that began on the component is dragged, unless the press moves the window (see Window.dragRegion)

Inherited from

ComponentBase.onmousemove

---

onmouseup

onmouseup: 
  | EventHandler<Image, MousePayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:614

mouseup callback

Inherited from

ComponentBase.onmouseup

---

onwheel

onwheel: 
  | EventHandler<Image, WheelPayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:622

wheel callback

Inherited from

ComponentBase.onwheel

---

position

position: ImagePosition;

Defined in: types/desktop-engine.d.ts:882

Alignment

---

size

size: ImageSize;

Defined in: types/desktop-engine.d.ts:880

Scaling mode

---

src

src: string | null;

Defined in: types/desktop-engine.d.ts:878

Image source (returns the value as it was set)

---

width

readonly width: number;

Defined in: types/desktop-engine.d.ts:593

Width after layout (reading triggers layout first)

Inherited from

ComponentBase.width

Accessors

style

Get Signature

get style(): ComponentStyle;

Defined in: types/desktop-engine.d.ts:590

Reading returns the style object; assigning an object replaces the whole style

Returns

ComponentStyle

Set Signature

set style(value): void;

Defined in: types/desktop-engine.d.ts:591

Parameters

Parameter	Type
value	StyleProperties

Returns

void

Inherited from

ComponentBase.style

Methods

addEventListener()

addEventListener<K>(type, listener): void;

Defined in: types/desktop-engine.d.ts:128

Adds an event listener; type may be given with or without the on prefix

Type Parameters

Type Parameter
K extends | "error" | "framechange" | "click" | "dbclick" | "mousedown" | "mouseup" | "mouseenter" | "mouseleave" | "mousemove" | "wheel" | "load"

Parameters

Parameter	Type
type	K | `on${K}`
listener	EventHandler<Image, ImageEventMap[K]>

Returns

void

Inherited from

ComponentBase.addEventListener

---

appendChild()

appendChild(child, index?): void;

Defined in: types/desktop-engine.d.ts:599

Adds a child component at index (0 to the number of children); omit it or pass -1 to append at the end. Throws a RangeError for other indexes; a Window can't be a child

Parameters

Parameter	Type
child	AnyComponent
index?	number

Returns

void

Inherited from

ComponentBase.appendChild

---

destroy()

destroy(): void;

Defined in: types/desktop-engine.d.ts:132

Clears all event listeners and on callbacks so the object can be garbage-collected; components also process their children recursively

Returns

void

Inherited from

ComponentBase.destroy

---

offclick()

offclick(): void;

Defined in: types/desktop-engine.d.ts:626

Removes the onclick callback

Returns

void

Inherited from

ComponentBase.offclick

---

offdbclick()

offdbclick(): void;

Defined in: types/desktop-engine.d.ts:628

Removes the ondbclick callback

Returns

void

Inherited from

ComponentBase.offdbclick

---

offerror()

offerror(): void;

Defined in: types/desktop-engine.d.ts:895

Removes the onerror callback

Returns

void

---

offframechange()

offframechange(): void;

Defined in: types/desktop-engine.d.ts:624

Removes the onframechange callback

Returns

void

Inherited from

ComponentBase.offframechange

---

offload()

offload(): void;

Defined in: types/desktop-engine.d.ts:893

Removes the onload callback

Returns

void

---

offmousedown()

offmousedown(): void;

Defined in: types/desktop-engine.d.ts:630

Removes the onmousedown callback

Returns

void

Inherited from

ComponentBase.offmousedown

---

offmouseenter()

offmouseenter(): void;

Defined in: types/desktop-engine.d.ts:634

Removes the onmouseenter callback

Returns

void

Inherited from

ComponentBase.offmouseenter

---

offmouseleave()

offmouseleave(): void;

Defined in: types/desktop-engine.d.ts:636

Removes the onmouseleave callback

Returns

void

Inherited from

ComponentBase.offmouseleave

---

offmousemove()

offmousemove(): void;

Defined in: types/desktop-engine.d.ts:638

Removes the onmousemove callback

Returns

void

Inherited from

ComponentBase.offmousemove

---

offmouseup()

offmouseup(): void;

Defined in: types/desktop-engine.d.ts:632

Removes the onmouseup callback

Returns

void

Inherited from

ComponentBase.offmouseup

---

offwheel()

offwheel(): void;

Defined in: types/desktop-engine.d.ts:640

Removes the onwheel callback

Returns

void

Inherited from

ComponentBase.offwheel

---

remove()

remove(): void;

Defined in: types/desktop-engine.d.ts:603

Removes this component from its parent

Returns

void

Inherited from

ComponentBase.remove

---

removeChild()

removeChild(child): void;

Defined in: types/desktop-engine.d.ts:601

Removes a child component; throws if it isn't a child of this component

Parameters

Parameter	Type
child	AnyComponent

Returns

void

Inherited from

ComponentBase.removeChild

---

removeEventListener()

removeEventListener<K>(type, listener): void;

Defined in: types/desktop-engine.d.ts:130

Removes the given event listener

Type Parameters

Type Parameter
K extends | "error" | "framechange" | "click" | "dbclick" | "mousedown" | "mouseup" | "mouseenter" | "mouseleave" | "mousemove" | "wheel" | "load"

Parameters

Parameter	Type
type	K | `on${K}`
listener	EventHandler<Image, ImageEventMap[K]>

Returns

void

Inherited from

ComponentBase.removeEventListener