A control implementing the UI

Introduced properties

type NATIVE: JavaObject

app :: Control :: NATIVE

Type of native
type NATIVE: NSObject

app :: Control :: NATIVE

Type of the native implementation of this control
type NATIVE: GtkWidget

app :: Control :: NATIVE

Type of native
init defaultinit(parent: nullable CompositeControl)

app :: Control :: defaultinit

abstract fun native: NATIVE

app :: Control :: native

The Android element used to implement self
abstract fun native: NATIVE

app :: Control :: native

The GTK element used to implement self
abstract fun native: NATIVE

app :: Control :: native

Native implementation of this control
fun parent: nullable CompositeControl

app :: Control :: parent

Direct parent Control in the control tree
fun parent=(parent: nullable CompositeControl)

app :: Control :: parent=

Direct parent Control in the control tree

Redefined properties

redef type SELF: Control

app $ Control :: SELF

Type of this instance, automatically specialized in every class
redef fun finalize

linux :: ui $ Control :: finalize

Liberate any resources held by self before the memory holding self is freed
redef fun notify_observers(event: AppEvent)

app $ Control :: notify_observers

Also notify the parents (both direct and indirect)

All properties

fun !=(other: nullable Object): Bool

core :: Object :: !=

Have self and other different values?
fun ==(other: nullable Object): Bool

core :: Object :: ==

Have self and other the same value?
type CLASS: Class[SELF]

core :: Object :: CLASS

The type of the class of self.
type NATIVE: NSObject

app :: Control :: NATIVE

Type of the native implementation of this control
type NATIVE: GtkWidget

app :: Control :: NATIVE

Type of native
type NATIVE: JavaObject

app :: Control :: NATIVE

Type of native
type SELF: Object

core :: Object :: SELF

Type of this instance, automatically specialized in every class
protected fun class_factory(name: String): CLASS

core :: Object :: class_factory

Implementation used by get_class to create the specific class.
fun class_name: String

core :: Object :: class_name

The class name of the object.
init defaultinit(parent: nullable CompositeControl)

app :: Control :: defaultinit

fun finalize

core :: Finalizable :: finalize

Liberate any resources held by self before the memory holding self is freed
fun get_class: CLASS

core :: Object :: get_class

The meta-object representing the dynamic type of self.
fun hash: Int

core :: Object :: hash

The hash code of the object.
init init

core :: Object :: init

fun inspect: String

core :: Object :: inspect

Developer readable representation of self.
protected fun inspect_head: String

core :: Object :: inspect_head

Return "CLASSNAME:#OBJECTID".
intern fun is_same_instance(other: nullable Object): Bool

core :: Object :: is_same_instance

Return true if self and other are the same instance (i.e. same identity).
fun is_same_serialized(other: nullable Object): Bool

core :: Object :: is_same_serialized

Is self the same as other in a serialization context?
intern fun is_same_type(other: Object): Bool

core :: Object :: is_same_type

Return true if self and other have the same dynamic type.
abstract fun native: NATIVE

app :: Control :: native

The Android element used to implement self
abstract fun native: NATIVE

app :: Control :: native

The GTK element used to implement self
abstract fun native: NATIVE

app :: Control :: native

Native implementation of this control
fun notify_observers(event: AppEvent)

app :: AppComponent :: notify_observers

Propagate event to all observers by calling AppObserver::on_event
intern fun object_id: Int

core :: Object :: object_id

An internal hash code for the object based on its identity.
fun observers: HashSet[AppObserver]

app :: AppComponent :: observers

All AppObserver notified of events raised by self
protected fun observers=(observers: HashSet[AppObserver])

app :: AppComponent :: observers=

All AppObserver notified of events raised by self
fun on_create

app :: AppComponent :: on_create

The application is being created
fun on_destroy

app :: AppComponent :: on_destroy

The application is being destroyed
fun on_event(event: AppEvent)

app :: AppObserver :: on_event

Notification of event raised by sender
fun on_pause

app :: AppComponent :: on_pause

The application leaves the active state but is still partially visible
fun on_restart

app :: AppComponent :: on_restart

The application returns to a visible state from a previous on_stop
fun on_restore_state

app :: AppComponent :: on_restore_state

The application is launching, restore its state from a previous on_save_state
fun on_resume

app :: AppComponent :: on_resume

The application enters the active state, it is in the foreground and interactive
fun on_save_state

app :: AppComponent :: on_save_state

The application may be destroyed soon, save its state for a future on_restore_state
fun on_start

app :: AppComponent :: on_start

The application is starting or restarting, it is visible to the user
fun on_stop

app :: AppComponent :: on_stop

The application is completely hidden from the user
fun output

core :: Object :: output

Display self on stdout (debug only).
intern fun output_class_name

core :: Object :: output_class_name

Display class name on stdout (debug only).
fun parent: nullable CompositeControl

app :: Control :: parent

Direct parent Control in the control tree
fun parent=(parent: nullable CompositeControl)

app :: Control :: parent=

Direct parent Control in the control tree
fun serialization_hash: Int

core :: Object :: serialization_hash

Hash value use for serialization
abstract fun signal(sender: GtkWidget, user_data: nullable Object)

gtk :: GtkCallable :: signal

return true to stop event processing, false to let it propagate
intern fun sys: Sys

core :: Object :: sys

Return the global sys object, the only instance of the Sys class.
abstract fun to_jvalue(env: JniEnv): JValue

core :: Object :: to_jvalue

fun to_s: String

core :: Object :: to_s

User readable representation of self.
package_diagram app::Control Control app::AppComponent AppComponent app::Control->app::AppComponent gtk::GtkCallable GtkCallable app::Control->gtk::GtkCallable core::Finalizable Finalizable app::Control->core::Finalizable app::AppObserver AppObserver app::AppComponent->app::AppObserver core::Object Object gtk::GtkCallable->core::Object core::Finalizable->core::Object ...app::AppObserver ... ...app::AppObserver->app::AppObserver ...core::Object ... ...core::Object->core::Object app::CompositeControl CompositeControl app::CompositeControl->app::Control app::View View app::View->app::Control app::Window Window app::Window->app::CompositeControl app::Layout Layout app::Layout->app::CompositeControl app::Layout->app::View app::ListLayout ListLayout app::ListLayout->app::CompositeControl app::ListLayout->app::View ios::TableView TableView ios::TableView->app::CompositeControl app::Window... ... app::Window...->app::Window app::Layout... ... app::Layout...->app::Layout app::ListLayout... ... app::ListLayout...->app::ListLayout ios::TableView... ... ios::TableView...->ios::TableView app::TextView TextView app::TextView->app::View app::TextView... ... app::TextView...->app::TextView

Ancestors

interface AppObserver

app :: AppObserver

Observer of AppEvents raised by AppComponents
interface Object

core :: Object

The root of the class hierarchy.

Parents

abstract class AppComponent

app :: AppComponent

An element of an application that is notified of the application life cycle
class Finalizable

core :: Finalizable

An object needing finalization
interface GtkCallable

gtk :: GtkCallable

Children

class CompositeControl

app :: CompositeControl

A Control grouping other controls
abstract class View

app :: View

A visible Control

Descendants

class BackButton

linux :: BackButton

Button to go back between windows
class Button

app :: Button

A pressable button, raises ButtonPressEvent
class CheckBox

app :: CheckBox

Toggle control between two states, also displays a label
class HorizontalLayout

app :: HorizontalLayout

An horizontal linear organization
class HttpRequestClientWindow

app :: HttpRequestClientWindow

Simple window with a label and a button
class Label

app :: Label

A simple text label
abstract class Layout

app :: Layout

A layout to visually organize Controls
class ListLayout

app :: ListLayout

Scrollable list of views in a simple list
class SecondWindow

app :: SecondWindow

Another window with a small VerticalLayout
class TableView

ios :: TableView

iOS specific layout using a UITableView, works only with simple children views
class TextInput

app :: TextInput

A control for the user to enter custom text
abstract class TextView

app :: TextView

A control displaying some text
class UiExampleWindow

app :: UiExampleWindow

Window showing off some the available controls
class VerticalLayout

app :: VerticalLayout

A vertical linear organization
class Window

app :: Window

A window, root of the Control tree

Class definitions

app $ Control
# A control implementing the UI
class Control
	super AppComponent

	# Direct parent `Control` in the control tree
	#
	# The parents (direct and indirect) receive all events from `self`,
	# like the `observers`.
	#
	# If `null` then `self` is at the root of the tree, or not yet attached.
	var parent: nullable CompositeControl = null is private writable(set_parent)

	# Direct parent `Control` in the control tree
	#
	# The parents (direct and indirect) receive all events from `self`,
	# like the `observers`.
	#
	# Setting `parent` calls `remove` on the old parent and `add` on the new one.
	fun parent=(parent: nullable CompositeControl)
	is autoinit	do
		var old_parent = self.parent
		if old_parent != null and old_parent != parent then
			old_parent.remove self
		end

		if parent != null then parent.add self

		set_parent parent
	end

	# Also notify the parents (both direct and indirect)
	redef fun notify_observers(event)
	do
		super

		var p = parent
		while p != null do
			p.on_event event
			p = p.parent
		end
	end
end
lib/app/ui.nit:127,1--168,3

ios :: ui $ Control
redef class Control

	# Native implementation of this control
	fun native: NATIVE is abstract

	# Type of the `native` implementation of this control
	type NATIVE: NSObject
end
lib/ios/ui/ui.nit:168,1--175,3

linux :: ui $ Control
redef class Control
	super GtkCallable
	super Finalizable

	# The GTK element used to implement `self`
	fun native: NATIVE is abstract

	# Type of `native`
	type NATIVE: GtkWidget

	redef fun finalize
	do
		var native = native
		if not native.address_is_null then native.destroy
	end
end
lib/linux/ui.nit:101,1--116,3

android :: ui $ Control
redef class Control
	# The Android element used to implement `self`
	fun native: NATIVE is abstract

	# Type of `native`
	type NATIVE: JavaObject
end
lib/android/ui/ui.nit:35,1--41,3