summaryrefslogtreecommitdiff
path: root/tab.go
blob: a337be7f76077f79612c6c09f54096da427eaef4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
// 12 december 2015

package ui

import (
	"unsafe"
)

// #include "ui.h"
import "C"

// Tab is a Control that holds tabbed pages of Controls. Each tab
// has a label. The user can click on the tabs themselves to switch
// pages.
type Tab struct {
	c	*C.uiControl
	t	*C.uiTab

	children	[]Control
}

// NewTab creates a new Tab.
func NewTab() *Tab {
	t := new(Tab)

	t.t = C.uiNewTab()
	t.c = (*C.uiControl)(unsafe.Pointer(t.t))

	return t
}

// Destroy destroys the Tab. If the Tab has pages,
// Destroy calls Destroy on the pages's Controls as well.
func (t *Tab) Destroy() {
	for len(t.children) != 0 {
		c := t.children[0]
		t.Delete(0)
		c.Destroy()
	}
	C.uiControlDestroy(t.c)
}

// LibuiControl returns the libui uiControl pointer that backs
// the Tab. This is only used by package ui itself and should
// not be called by programs.
func (t *Tab) LibuiControl() uintptr {
	return uintptr(unsafe.Pointer(t.c))
}

// Handle returns the OS-level handle associated with this Tab.
// On Windows this is an HWND of a standard Windows API
// WC_TABCONTROL class (as provided by Common Controls
// version 6). The pages are not children of this window and there
// currently is no way to directly access them.
// On GTK+ this is a pointer to a GtkNotebook.
// On OS X this is a pointer to a NSTabView.
func (t *Tab) Handle() uintptr {
	return uintptr(C.uiControlHandle(t.c))
}

// Show shows the Tab.
func (t *Tab) Show() {
	C.uiControlShow(t.c)
}

// Hide hides the Tab.
func (t *Tab) Hide() {
	C.uiControlHide(t.c)
}

// Enable enables the Tab.
func (t *Tab) Enable() {
	C.uiControlEnable(t.c)
}

// Disable disables the Tab.
func (t *Tab) Disable() {
	C.uiControlDisable(t.c)
}

// Append adds the given page to the end of the Tab.
func (t *Tab) Append(name string, child Control) {
	t.InsertAt(name, len(t.children), child)
}

// InsertAt adds the given page to the Tab such that it is the
// nth page of the Tab (starting at 0).
func (t *Tab) InsertAt(name string, n int, child Control) {
	c := (*C.uiControl)(nil)
	if child != nil {
		c = touiControl(child.LibuiControl())
	}
	cname := C.CString(name)
	// TODO why is this uintmax_t and not intmax_t
	C.uiTabInsertAt(t.t, cname, C.uintmax_t(n), c)
	freestr(cname)
	t.children = append(t.children, child)
}

// Delete deletes the nth page of the Tab.
func (t *Tab) Delete(n int) {
	t.children = append(t.children[:n], t.children[n + 1:]...)
	C.uiTabDelete(t.t, C.uintmax_t(n))
}

// NumPages returns the number of pages in the Tab.
func (t *Tab) NumPages() int {
	return len(t.children)
}

// Margined returns whether page n (starting at 0) of the Tab
// has margins around its child.
func (t *Tab) Margined(n int) bool {
	return tobool(C.uiTabMargined(t.t, C.uintmax_t(n)))
}

// SetMargined controls whether page n (starting at 0) of the Tab
// has margins around its child. The size of the margins are
// determined by the OS and its best practices.
func (t *Tab) SetMargined(n int, margined bool) {
	C.uiTabSetMargined(t.t, C.uintmax_t(n), frombool(margined))
}