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
use crate::co;
use crate::decl::*;
use crate::gui::*;
use crate::msg::*;
use crate::prelude::*;
/// A single item of a [`Tab`](crate::gui::Tab) control.
///
/// **Note:** Each object keeps the zero-based index of an item. If new items
/// are added/removed from the tab control, the object may then point to a
/// different item.
///
/// You cannot directly instantiate this object, it is created internally by the
/// control.
#[derive(Clone, Copy)]
pub struct TabItem<'a> {
owner: &'a Tab,
index: u32,
}
impl<'a> TabItem<'a> {
#[must_use]
pub(in crate::gui) const fn new(owner: &'a Tab, index: u32) -> Self {
Self { owner, index }
}
/// Returns the zero-based index of the item.
#[must_use]
pub const fn index(&self) -> u32 {
self.index
}
/// Deletes the item by sending a
/// [`tcm::DeleteItem`](crate::msg::tcm::DeleteItem) message.
///
/// # Safety
///
/// If you delete a tab automatically created, which has a container window
/// attached to it, the rendering will be out-of-order.
pub unsafe fn delete(&self) {
unsafe {
self.owner
.hwnd()
.SendMessage(tcm::DeleteItem { index: self.index })
}
.unwrap();
}
/// Retrieves the user-defined value by sending an
/// [`tcm::GetItem`](crate::msg::tcm::GetItem) message.
#[must_use]
pub fn lparam(&self) -> SysResult<isize> {
let mut tci = TCITEM::default();
tci.mask = co::TCIF::PARAM;
unsafe {
self.owner
.hwnd()
.SendMessage(tcm::GetItem { index: self.index, item: &mut tci })?;
}
Ok(tci.lParam)
}
/// Sets the user-defined value by sending an
/// [`lvm::SetItem`](crate::msg::lvm::SetItem) message.
///
/// Returns the same item, so further operations can be chained.
pub fn set_lparam(&self, lparam: isize) -> SysResult<Self> {
let mut tci = TCITEM::default();
tci.mask = co::TCIF::PARAM;
tci.lParam = lparam;
unsafe {
self.owner
.hwnd()
.SendMessage(tcm::SetItem { index: self.index, item: &mut tci })?;
}
Ok(*self)
}
/// Sets the text by sending a
/// [`tcm:SetItem`](crate::msg::tcm::SetItem) message.
///
/// Returns the same item, so further operations can be chained.
pub fn set_text(&self, text: &str) -> SysResult<Self> {
let mut wtext = WString::from_str(text);
let mut tci = TCITEM::default();
tci.mask = co::TCIF::TEXT;
tci.set_pszText(Some(&mut wtext));
unsafe {
self.owner
.hwnd()
.SendMessage(tcm::SetItem { index: self.index, item: &mut tci })?;
}
Ok(*self)
}
/// Retrieves the text by sending a
/// [`tcm:GetItem`](crate::msg::tcm::GetItem) message.
#[must_use]
pub fn text(&self) -> SysResult<String> {
let mut buf = WString::new_alloc_buf(64); // arbitrary
let mut tci = TCITEM::default();
tci.mask = co::TCIF::TEXT;
tci.set_pszText(Some(&mut buf));
unsafe {
self.owner
.hwnd()
.SendMessage(tcm::GetItem { index: self.index, item: &mut tci })?;
}
Ok(buf.to_string())
}
}