Module Tk

module Tk: sig .. end

Basic functions and types for LablTk

Initialization and termination

val openTk : ?display:string -> ?clas:string -> unit -> Widget.toplevel Widget.widget

Initialize LablTk and open a toplevel window. display is described according to the X11 conventions. clas is used for the X11 resource mechanism.

val mainLoop : unit -> unit

Start the main event loop

val closeTk : unit -> unit

Quit the main loop and close all open windows.

val destroy : 'a Widget.widget -> unit

Destroy an individual widget.

Application wide commands

val update : unit -> unit

Synchronize display with internal state.

val appname_get : unit -> string

val appname_set : string -> unit

Get or set the application name.

Dimensions

type units = [ `Cm of float | `In of float | `Mm of float | `Pix of int | `Pt of float ]

val pixels : units -> int

Converts various on-screen units to pixels, respective to the default display. Available units are pixels, centimeters, inches, millimeters and points

Widget layout commands

type anchor = [ `Center | `E | `N | `Ne | `Nw | `S | `Se | `Sw | `W ]

type fillMode = [ `Both | `None | `X | `Y ]

type side = [ `Bottom | `Left | `Right | `Top ]

val pack : ?after:'a Widget.widget ->
       ?anchor:anchor ->
       ?before:'b Widget.widget ->
       ?expand:bool ->
       ?fill:fillMode ->
       ?inside:'c Widget.widget ->
       ?ipadx:int ->
       ?ipady:int ->
       ?padx:int -> ?pady:int -> ?side:side -> 'd Widget.widget list -> unit

Pack a widget inside its parent, using the standard layout engine.

val grid : ?column:int ->
       ?columnspan:int ->
       ?inside:'a Widget.widget ->
       ?ipadx:int ->
       ?ipady:int ->
       ?padx:int ->
       ?pady:int ->
       ?row:int -> ?rowspan:int -> ?sticky:string -> 'b Widget.widget list -> unit

Pack a widget inside its parent, using the grid layout engine.

type borderMode = [ `Ignore | `Inside | `Outside ]

val place : ?anchor:anchor ->
       ?bordermode:borderMode ->
       ?height:int ->
       ?inside:'a Widget.widget ->
       ?relheight:float ->
       ?relwidth:float ->
       ?relx:float ->
       ?rely:float -> ?width:int -> ?x:int -> ?y:int -> 'b Widget.widget -> unit

Pack a widget inside its parent, at absolute coordinates.

val raise_window : ?above:'a Widget.widget -> 'b Widget.widget -> unit

val lower_window : ?below:'a Widget.widget -> 'b Widget.widget -> unit

Raise or lower the window associated to a widget.

Event handling

type modifier = [ `Alt
       | `Button1
       | `Button2
       | `Button3
       | `Button4
       | `Button5
       | `Control
       | `Double
       | `Lock
       | `Meta
       | `Mod1
       | `Mod2
       | `Mod3
       | `Mod4
       | `Mod5
       | `Shift
       | `Triple ]

type event = [ `ButtonPress
       | `ButtonPressDetail of int
       | `ButtonRelease
       | `ButtonReleaseDetail of int
       | `Circulate
       | `ColorMap
       | `Configure
       | `Destroy
       | `Enter
       | `Expose
       | `FocusIn
       | `FocusOut
       | `Gravity
       | `KeyPress
       | `KeyPressDetail of string
       | `KeyRelease
       | `KeyReleaseDetail of string
       | `Leave
       | `Map
       | `Modified of modifier list * event
       | `Motion
       | `Property
       | `Reparent
       | `Unmap
       | `Visibility ]

An event can be either a basic X event, or modified by a key or mouse modifier.

type eventInfo = {

	`mutable ev_Above :int;`
	`mutable ev_ButtonNumber :int;`
	`mutable ev_Count :int;`
	`mutable ev_Detail :string;`
	`mutable ev_Focus :bool;`
	`mutable ev_Height :int;`
	`mutable ev_KeyCode :int;`
	`mutable ev_Mode :string;`
	`mutable ev_OverrideRedirect :bool;`
	`mutable ev_Place :string;`
	`mutable ev_State :string;`
	`mutable ev_Time :int;`
	`mutable ev_Width :int;`
	`mutable ev_MouseX :int;`
	`mutable ev_MouseY :int;`
	`mutable ev_Char :string;`
	`mutable ev_BorderWidth :int;`
	`mutable ev_SendEvent :bool;`
	`mutable ev_KeySymString :string;`
	`mutable ev_KeySymInt :int;`
	`mutable ev_RootWindow :int;`
	`mutable ev_SubWindow :int;`
	`mutable ev_Type :int;`
	`mutable ev_Widget :Widget.any Widget.widget;`
	`mutable ev_RootX :int;`
	`mutable ev_RootY :int;`

}
Event related information accessible in callbacks.

type eventField = [ `Above
       | `BorderWidth
       | `ButtonNumber
       | `Char
       | `Count
       | `Detail
       | `Focus
       | `Height
       | `KeyCode
       | `KeySymInt
       | `KeySymString
       | `Mode
       | `MouseX
       | `MouseY
       | `OverrideRedirect
       | `Place
       | `RootWindow
       | `RootX
       | `RootY
       | `SendEvent
       | `State
       | `SubWindow
       | `Time
       | `Type
       | `Widget
       | `Width ]

In order to access the above event information, one has to pass a list of required event fields to the bind function.

val bind : events:event list ->
       ?extend:bool ->
       ?breakable:bool ->
       ?fields:eventField list ->
       ?action:(eventInfo -> unit) -> 'a Widget.widget -> unit

Bind a succession of events on a widget to an action. If extend is true then then binding is added after existing ones, otherwise it replaces them. breakable should be true when break is to be called inside the action. action is called with the fields required set in an eventInfo structure. Other fields should not be accessed. If action is omitted then existing bindings are removed.

val bind_class : events:event list ->
       ?extend:bool ->
       ?breakable:bool ->
       ?fields:eventField list ->
       ?action:(eventInfo -> unit) -> ?on:'a Widget.widget -> string -> unit

Same thing for all widgets of a given class. If a widget is given with label ~on:, the binding will be removed as soon as it is destroyed.

val bind_tag : events:event list ->
       ?extend:bool ->
       ?breakable:bool ->
       ?fields:eventField list ->
       ?action:(eventInfo -> unit) -> ?on:'a Widget.widget -> string -> unit

Same thing for all widgets having a given tag

val break : unit -> unit

Used inside a bound action, do not call other actions after this one. This is only possible if this action was bound with ~breakable:true.