426 lines
8.6 KiB
Markdown
426 lines
8.6 KiB
Markdown
---
|
||
id: "qtreewidgetitem"
|
||
title: "QTreeWidgetItem"
|
||
sidebar_label: "QTreeWidgetItem"
|
||
---
|
||
|
||
> Creates an item for QTreeWidget.
|
||
|
||
**This class is a JS wrapper around Qt's [QTreeWidgetItem class](https://doc.qt.io/qt-5/qtreewidgetitem.html)**
|
||
|
||
### Example
|
||
|
||
```javascript
|
||
|
||
const { QMainWindow, QTreeWidgetItem, QTreeWidget } = require("@nodegui/nodegui");
|
||
|
||
const win = new QMainWindow();
|
||
const tree = new QTreeWidget();
|
||
|
||
const item1 = new QTreeWidgetItem();
|
||
item1.setText(0, `item-1`);
|
||
const item2 = new QTreeWidgetItem();
|
||
item2.setText(0, `item-2`);
|
||
const item3 = new QTreeWidgetItem();
|
||
item3.setText(0, `item-3`);
|
||
|
||
tree.addTopLevelItem(item1);
|
||
tree.addTopLevelItem(item2);
|
||
tree.addTopLevelItem(item3);
|
||
|
||
// Add children to item1
|
||
const c1item1 = new QTreeWidgetItem(item1);
|
||
c1item1.setText(0, `c1item1`);
|
||
const c1item2 = new QTreeWidgetItem(item1);
|
||
c1item2.setText(0, `c1item1`);
|
||
|
||
win.setCentralWidget(tree);
|
||
win.show();
|
||
(global as any).win = win;
|
||
|
||
```
|
||
|
||
## Hierarchy
|
||
|
||
* [Component](component.md)
|
||
|
||
↳ **QTreeWidgetItem**
|
||
|
||
## Index
|
||
|
||
### Constructors
|
||
|
||
* [constructor](qtreewidgetitem.md#constructor)
|
||
|
||
### Properties
|
||
|
||
* [items](qtreewidgetitem.md#items)
|
||
* [native](qtreewidgetitem.md#native)
|
||
* [nodeChildren](qtreewidgetitem.md#nodechildren)
|
||
* [nodeParent](qtreewidgetitem.md#optional-nodeparent)
|
||
|
||
### Methods
|
||
|
||
* [addChild](qtreewidgetitem.md#addchild)
|
||
* [child](qtreewidgetitem.md#child)
|
||
* [childCount](qtreewidgetitem.md#childcount)
|
||
* [data](qtreewidgetitem.md#data)
|
||
* [flags](qtreewidgetitem.md#flags)
|
||
* [icon](qtreewidgetitem.md#icon)
|
||
* [isHidden](qtreewidgetitem.md#ishidden)
|
||
* [parent](qtreewidgetitem.md#parent)
|
||
* [setCheckState](qtreewidgetitem.md#setcheckstate)
|
||
* [setData](qtreewidgetitem.md#setdata)
|
||
* [setExpanded](qtreewidgetitem.md#setexpanded)
|
||
* [setFlags](qtreewidgetitem.md#setflags)
|
||
* [setHidden](qtreewidgetitem.md#sethidden)
|
||
* [setIcon](qtreewidgetitem.md#seticon)
|
||
* [setNodeParent](qtreewidgetitem.md#setnodeparent)
|
||
* [setSelected](qtreewidgetitem.md#setselected)
|
||
* [setText](qtreewidgetitem.md#settext)
|
||
* [text](qtreewidgetitem.md#text)
|
||
|
||
## Constructors
|
||
|
||
### constructor
|
||
|
||
\+ **new QTreeWidgetItem**(): *[QTreeWidgetItem](qtreewidgetitem.md)*
|
||
|
||
*Overrides [Component](component.md).[constructor](component.md#constructor)*
|
||
|
||
**Returns:** *[QTreeWidgetItem](qtreewidgetitem.md)*
|
||
|
||
\+ **new QTreeWidgetItem**(`parent`: [QTreeWidgetItem](qtreewidgetitem.md), `strings?`: string[]): *[QTreeWidgetItem](qtreewidgetitem.md)*
|
||
|
||
*Overrides [Component](component.md).[constructor](component.md#constructor)*
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type |
|
||
------ | ------ |
|
||
`parent` | [QTreeWidgetItem](qtreewidgetitem.md) |
|
||
`strings?` | string[] |
|
||
|
||
**Returns:** *[QTreeWidgetItem](qtreewidgetitem.md)*
|
||
|
||
\+ **new QTreeWidgetItem**(`parent`: [QTreeWidget](qtreewidget.md), `strings?`: string[]): *[QTreeWidgetItem](qtreewidgetitem.md)*
|
||
|
||
*Overrides [Component](component.md).[constructor](component.md#constructor)*
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type |
|
||
------ | ------ |
|
||
`parent` | [QTreeWidget](qtreewidget.md) |
|
||
`strings?` | string[] |
|
||
|
||
**Returns:** *[QTreeWidgetItem](qtreewidgetitem.md)*
|
||
|
||
\+ **new QTreeWidgetItem**(`native`: [NativeElement](../globals.md#nativeelement)): *[QTreeWidgetItem](qtreewidgetitem.md)*
|
||
|
||
*Overrides [Component](component.md).[constructor](component.md#constructor)*
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type |
|
||
------ | ------ |
|
||
`native` | [NativeElement](../globals.md#nativeelement) |
|
||
|
||
**Returns:** *[QTreeWidgetItem](qtreewidgetitem.md)*
|
||
|
||
\+ **new QTreeWidgetItem**(`strings`: string[]): *[QTreeWidgetItem](qtreewidgetitem.md)*
|
||
|
||
*Overrides [Component](component.md).[constructor](component.md#constructor)*
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type |
|
||
------ | ------ |
|
||
`strings` | string[] |
|
||
|
||
**Returns:** *[QTreeWidgetItem](qtreewidgetitem.md)*
|
||
|
||
## Properties
|
||
|
||
### items
|
||
|
||
• **items**: *Set‹[NativeElement](../globals.md#nativeelement) | [Component](component.md)›*
|
||
|
||
___
|
||
|
||
### native
|
||
|
||
• **native**: *[NativeElement](../globals.md#nativeelement)*
|
||
|
||
*Overrides [Component](component.md).[native](component.md#abstract-native)*
|
||
|
||
___
|
||
|
||
### nodeChildren
|
||
|
||
• **nodeChildren**: *Set‹[Component](component.md)›*
|
||
|
||
*Inherited from [Component](component.md).[nodeChildren](component.md#nodechildren)*
|
||
|
||
___
|
||
|
||
### `Optional` nodeParent
|
||
|
||
• **nodeParent**? : *[Component](component.md)*
|
||
|
||
*Inherited from [Component](component.md).[nodeParent](component.md#optional-nodeparent)*
|
||
|
||
## Methods
|
||
|
||
### addChild
|
||
|
||
▸ **addChild**(`childItem`: [QTreeWidgetItem](qtreewidgetitem.md)): *void*
|
||
|
||
Adds the specified child to this QTreeWidgetItem.
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type | Description |
|
||
------ | ------ | ------ |
|
||
`childItem` | [QTreeWidgetItem](qtreewidgetitem.md) | The child to add. |
|
||
|
||
**Returns:** *void*
|
||
|
||
___
|
||
|
||
### child
|
||
|
||
▸ **child**(`index`: number): *[QTreeWidgetItem](qtreewidgetitem.md) | undefined*
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type |
|
||
------ | ------ |
|
||
`index` | number |
|
||
|
||
**Returns:** *[QTreeWidgetItem](qtreewidgetitem.md) | undefined*
|
||
|
||
___
|
||
|
||
### childCount
|
||
|
||
▸ **childCount**(): *number*
|
||
|
||
**Returns:** *number*
|
||
|
||
___
|
||
|
||
### data
|
||
|
||
▸ **data**(`column`: number, `role`: [ItemDataRole](../enums/itemdatarole.md)): *[QVariant](qvariant.md)*
|
||
|
||
Returns the value for the item's column and role.
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type | Description |
|
||
------ | ------ | ------ |
|
||
`column` | number | The column. |
|
||
`role` | [ItemDataRole](../enums/itemdatarole.md) | The role. |
|
||
|
||
**Returns:** *[QVariant](qvariant.md)*
|
||
|
||
___
|
||
|
||
### flags
|
||
|
||
▸ **flags**(): *[ItemFlag](../enums/itemflag.md)*
|
||
|
||
Returns the flags used to describe the item. These determine whether the item can be checked, edited, and selected.
|
||
|
||
**Returns:** *[ItemFlag](../enums/itemflag.md)*
|
||
|
||
___
|
||
|
||
### icon
|
||
|
||
▸ **icon**(`column`: number): *[QIcon](qicon.md)*
|
||
|
||
Returns the icon object for the item.
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type |
|
||
------ | ------ |
|
||
`column` | number |
|
||
|
||
**Returns:** *[QIcon](qicon.md)*
|
||
|
||
___
|
||
|
||
### isHidden
|
||
|
||
▸ **isHidden**(): *boolean*
|
||
|
||
**Returns:** *boolean*
|
||
|
||
___
|
||
|
||
### parent
|
||
|
||
▸ **parent**(): *[QTreeWidgetItem](qtreewidgetitem.md) | undefined*
|
||
|
||
**Returns:** *[QTreeWidgetItem](qtreewidgetitem.md) | undefined*
|
||
|
||
___
|
||
|
||
### setCheckState
|
||
|
||
▸ **setCheckState**(`column`: number, `state`: [CheckState](../enums/checkstate.md)): *void*
|
||
|
||
Sets the item in the given column check state to be state.
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type | Description |
|
||
------ | ------ | ------ |
|
||
`column` | number | The column. |
|
||
`state` | [CheckState](../enums/checkstate.md) | The check state. |
|
||
|
||
**Returns:** *void*
|
||
|
||
___
|
||
|
||
### setData
|
||
|
||
▸ **setData**(`column`: number, `role`: [ItemDataRole](../enums/itemdatarole.md), `value`: [QVariantType](../globals.md#qvarianttype)): *void*
|
||
|
||
Sets the value for the item's column and role to the given value.
|
||
The role describes the type of data specified by value, and is defined by the ItemDataRole enum.
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type | Description |
|
||
------ | ------ | ------ |
|
||
`column` | number | The column. |
|
||
`role` | [ItemDataRole](../enums/itemdatarole.md) | The role. |
|
||
`value` | [QVariantType](../globals.md#qvarianttype) | The value. |
|
||
|
||
**Returns:** *void*
|
||
|
||
___
|
||
|
||
### setExpanded
|
||
|
||
▸ **setExpanded**(`expanded`: boolean): *void*
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type |
|
||
------ | ------ |
|
||
`expanded` | boolean |
|
||
|
||
**Returns:** *void*
|
||
|
||
___
|
||
|
||
### setFlags
|
||
|
||
▸ **setFlags**(`flags`: [ItemFlag](../enums/itemflag.md)): *void*
|
||
|
||
Sets the flags for the item to the given flags. These determine whether the item can be selected or modified.
|
||
This is often used to disable an item.
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type | Description |
|
||
------ | ------ | ------ |
|
||
`flags` | [ItemFlag](../enums/itemflag.md) | The flags. |
|
||
|
||
**Returns:** *void*
|
||
|
||
___
|
||
|
||
### setHidden
|
||
|
||
▸ **setHidden**(`hide`: boolean): *void*
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type |
|
||
------ | ------ |
|
||
`hide` | boolean |
|
||
|
||
**Returns:** *void*
|
||
|
||
___
|
||
|
||
### setIcon
|
||
|
||
▸ **setIcon**(`column`: number, `icon`: [QIcon](qicon.md)): *void*
|
||
|
||
Sets the icon for the item.
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type | Description |
|
||
------ | ------ | ------ |
|
||
`column` | number | - |
|
||
`icon` | [QIcon](qicon.md) | The icon object |
|
||
|
||
**Returns:** *void*
|
||
|
||
___
|
||
|
||
### setNodeParent
|
||
|
||
▸ **setNodeParent**(`parent?`: [Component](component.md)): *void*
|
||
|
||
*Inherited from [Component](component.md).[setNodeParent](component.md#setnodeparent)*
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type |
|
||
------ | ------ |
|
||
`parent?` | [Component](component.md) |
|
||
|
||
**Returns:** *void*
|
||
|
||
___
|
||
|
||
### setSelected
|
||
|
||
▸ **setSelected**(`selected`: boolean): *void*
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type |
|
||
------ | ------ |
|
||
`selected` | boolean |
|
||
|
||
**Returns:** *void*
|
||
|
||
___
|
||
|
||
### setText
|
||
|
||
▸ **setText**(`column`: number, `text`: string): *void*
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type |
|
||
------ | ------ |
|
||
`column` | number |
|
||
`text` | string |
|
||
|
||
**Returns:** *void*
|
||
|
||
___
|
||
|
||
### text
|
||
|
||
▸ **text**(`column`: number): *string*
|
||
|
||
**Parameters:**
|
||
|
||
Name | Type |
|
||
------ | ------ |
|
||
`column` | number |
|
||
|
||
**Returns:** *string*
|