tree-view.d.ts 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452
  1. /*!
  2. * devextreme-angular
  3. * Version: 19.1.16
  4. * Build date: Tue Oct 18 2022
  5. *
  6. * Copyright (c) 2012 - 2022 Developer Express Inc. ALL RIGHTS RESERVED
  7. *
  8. * This software may be modified and distributed under the terms
  9. * of the MIT license. See the LICENSE file in the root of the project for details.
  10. *
  11. * https://github.com/DevExpress/devextreme-angular
  12. */
  13. import { TransferState } from '@angular/platform-browser';
  14. import { ElementRef, NgZone, OnDestroy, EventEmitter, OnChanges, DoCheck, SimpleChanges, QueryList } from '@angular/core';
  15. import DevExpress from 'devextreme/bundles/dx.all';
  16. import DxTreeView from 'devextreme/ui/tree_view';
  17. import { DxComponent } from '../core/component';
  18. import { DxTemplateHost } from '../core/template-host';
  19. import { NestedOptionHost } from '../core/nested-option';
  20. import { WatcherHelper } from '../core/watcher-helper';
  21. import { IterableDifferHelper } from '../core/iterable-differ-helper';
  22. import { DxiItemComponent } from './nested/item-dxi';
  23. /**
  24. * The TreeView widget is a tree-like representation of textual data.
  25. */
  26. export declare class DxTreeViewComponent extends DxComponent implements OnDestroy, OnChanges, DoCheck {
  27. private _watcherHelper;
  28. private _idh;
  29. instance: DxTreeView;
  30. /**
  31. * Specifies the shortcut key that sets focus on the widget.
  32. */
  33. accessKey: string;
  34. /**
  35. * Specifies whether or not the widget changes its state when interacting with a user.
  36. */
  37. activeStateEnabled: boolean;
  38. /**
  39. * Specifies whether or not to animate item collapsing and expanding.
  40. */
  41. animationEnabled: boolean;
  42. /**
  43. * Allows you to load nodes on demand.
  44. */
  45. createChildren: Function;
  46. /**
  47. * Binds the widget to data.
  48. */
  49. dataSource: DevExpress.data.DataSource | DevExpress.data.DataSourceOptions | string | Array<string | DevExpress.ui.CollectionWidgetItem>;
  50. /**
  51. * Notifies the widget of the used data structure.
  52. */
  53. dataStructure: string;
  54. /**
  55. * Specifies whether the widget responds to user interaction.
  56. */
  57. disabled: boolean;
  58. /**
  59. * Specifies the name of the data source item field whose value defines whether or not the corresponding widget item is disabled.
  60. */
  61. disabledExpr: Function | string;
  62. /**
  63. * Specifies the data field whose values should be displayed.
  64. */
  65. displayExpr: Function | string;
  66. /**
  67. * Specifies the attributes to be attached to the widget's root element.
  68. */
  69. elementAttr: any;
  70. /**
  71. * Specifies whether or not a user can expand all tree view items by the "*" hot key.
  72. */
  73. expandAllEnabled: boolean;
  74. /**
  75. * Specifies which data source field specifies whether an item is expanded.
  76. */
  77. expandedExpr: Function | string;
  78. /**
  79. * Specifies the event on which to expand/collapse a node.
  80. */
  81. expandEvent: string;
  82. /**
  83. * Specifies whether or not all parent nodes of an initially expanded node are displayed expanded.
  84. */
  85. expandNodesRecursive: boolean;
  86. /**
  87. * Specifies whether the widget can be focused using keyboard navigation.
  88. */
  89. focusStateEnabled: boolean;
  90. /**
  91. * Specifies the name of the data source item field whose value defines whether or not the corresponding node includes child nodes.
  92. */
  93. hasItemsExpr: Function | string;
  94. /**
  95. * Specifies the widget's height.
  96. */
  97. height: number | Function | string;
  98. /**
  99. * Specifies text for a hint that appears when a user pauses on the widget.
  100. */
  101. hint: string;
  102. /**
  103. * Specifies whether the widget changes its state when a user pauses on it.
  104. */
  105. hoverStateEnabled: boolean;
  106. /**
  107. * The time period in milliseconds before the onItemHold event is raised.
  108. */
  109. itemHoldTimeout: number;
  110. /**
  111. * An array of items displayed by the widget.
  112. */
  113. items: Array<DevExpress.ui.dxTreeViewItem>;
  114. /**
  115. * Specifies which data field contains nested items.
  116. */
  117. itemsExpr: Function | string;
  118. /**
  119. * Specifies a custom template for items.
  120. */
  121. itemTemplate: any;
  122. /**
  123. * Specifies which data field provides keys for TreeView items.
  124. */
  125. keyExpr: Function | string;
  126. /**
  127. * The text or HTML markup displayed by the widget if the item collection is empty.
  128. */
  129. noDataText: string;
  130. /**
  131. * Specifies the name of the data source item field for holding the parent key of the corresponding node.
  132. */
  133. parentIdExpr: Function | string;
  134. /**
  135. * Specifies the parent ID value of the root item.
  136. */
  137. rootValue: any;
  138. /**
  139. * Switches the widget to a right-to-left representation.
  140. */
  141. rtlEnabled: boolean;
  142. /**
  143. * A string value specifying available scrolling directions.
  144. */
  145. scrollDirection: string;
  146. /**
  147. * Configures the search panel.
  148. */
  149. searchEditorOptions: DevExpress.ui.dxTextBoxOptions;
  150. /**
  151. * Specifies whether the search panel is visible.
  152. */
  153. searchEnabled: boolean;
  154. /**
  155. * Specifies a data object's field name or an expression whose value is compared to the search string.
  156. */
  157. searchExpr: Function | Array<Function>;
  158. /**
  159. * Specifies a comparison operation used to search widget items.
  160. */
  161. searchMode: string;
  162. /**
  163. * Specifies a delay in milliseconds between when a user finishes typing, and the search is executed.
  164. */
  165. searchTimeout: number;
  166. /**
  167. * Specifies the current search string.
  168. */
  169. searchValue: string;
  170. /**
  171. * Specifies the text displayed at the "Select All" check box.
  172. */
  173. selectAllText: string;
  174. /**
  175. * Specifies whether or not an item becomes selected if a user clicks it.
  176. */
  177. selectByClick: boolean;
  178. /**
  179. * Specifies the name of the data source item field whose value defines whether or not the corresponding widget items is selected.
  180. */
  181. selectedExpr: Function | string;
  182. /**
  183. * Specifies item selection mode.
  184. */
  185. selectionMode: string;
  186. /**
  187. * Specifies whether or not to select nodes recursively.
  188. */
  189. selectNodesRecursive: boolean;
  190. /**
  191. * Specifies the current check boxes display mode.
  192. */
  193. showCheckBoxesMode: string;
  194. /**
  195. * Specifies the number of the element when the Tab key is used for navigating.
  196. */
  197. tabIndex: number;
  198. /**
  199. * Enables the virtual mode in which nodes are loaded on demand. Use it to enhance the performance on large datasets.
  200. */
  201. virtualModeEnabled: boolean;
  202. /**
  203. * Specifies whether the widget is visible.
  204. */
  205. visible: boolean;
  206. /**
  207. * Specifies the widget's width.
  208. */
  209. width: number | Function | string;
  210. /**
  211. * A function that is executed when the widget's content is ready and each time the content is changed.
  212. */
  213. onContentReady: EventEmitter<any>;
  214. /**
  215. * A function that is executed before the widget is disposed of.
  216. */
  217. onDisposing: EventEmitter<any>;
  218. /**
  219. * A function used in JavaScript frameworks to save the widget instance.
  220. */
  221. onInitialized: EventEmitter<any>;
  222. /**
  223. * A function that is executed when a collection item is clicked or tapped.
  224. */
  225. onItemClick: EventEmitter<any>;
  226. /**
  227. * A function that is executed when a tree view item is collapsed.
  228. */
  229. onItemCollapsed: EventEmitter<any>;
  230. /**
  231. * A function that is executed when a collection item is right-clicked or pressed.
  232. */
  233. onItemContextMenu: EventEmitter<any>;
  234. /**
  235. * A function that is executed when a tree view item is expanded.
  236. */
  237. onItemExpanded: EventEmitter<any>;
  238. /**
  239. * A function that is executed when a collection item has been held for a specified period.
  240. */
  241. onItemHold: EventEmitter<any>;
  242. /**
  243. * A function that is executed after a collection item is rendered.
  244. */
  245. onItemRendered: EventEmitter<any>;
  246. /**
  247. * A function that is executed when a tree view item is selected or selection is canceled.
  248. */
  249. onItemSelectionChanged: EventEmitter<any>;
  250. /**
  251. * A function that is executed after a widget option is changed.
  252. */
  253. onOptionChanged: EventEmitter<any>;
  254. /**
  255. * A function that is executed when the "Select All" check box value is changed. Applies only if showCheckBoxesMode is "selectAll" and selectionMode is "multiple".
  256. */
  257. onSelectAllValueChanged: EventEmitter<any>;
  258. /**
  259. * A function that is executed when a tree view item is selected or selection is canceled.
  260. */
  261. onSelectionChanged: EventEmitter<any>;
  262. /**
  263. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  264. */
  265. accessKeyChange: EventEmitter<string>;
  266. /**
  267. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  268. */
  269. activeStateEnabledChange: EventEmitter<boolean>;
  270. /**
  271. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  272. */
  273. animationEnabledChange: EventEmitter<boolean>;
  274. /**
  275. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  276. */
  277. createChildrenChange: EventEmitter<Function>;
  278. /**
  279. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  280. */
  281. dataSourceChange: EventEmitter<DevExpress.data.DataSource | DevExpress.data.DataSourceOptions | string | Array<string | DevExpress.ui.CollectionWidgetItem>>;
  282. /**
  283. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  284. */
  285. dataStructureChange: EventEmitter<string>;
  286. /**
  287. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  288. */
  289. disabledChange: EventEmitter<boolean>;
  290. /**
  291. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  292. */
  293. disabledExprChange: EventEmitter<Function | string>;
  294. /**
  295. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  296. */
  297. displayExprChange: EventEmitter<Function | string>;
  298. /**
  299. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  300. */
  301. elementAttrChange: EventEmitter<any>;
  302. /**
  303. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  304. */
  305. expandAllEnabledChange: EventEmitter<boolean>;
  306. /**
  307. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  308. */
  309. expandedExprChange: EventEmitter<Function | string>;
  310. /**
  311. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  312. */
  313. expandEventChange: EventEmitter<string>;
  314. /**
  315. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  316. */
  317. expandNodesRecursiveChange: EventEmitter<boolean>;
  318. /**
  319. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  320. */
  321. focusStateEnabledChange: EventEmitter<boolean>;
  322. /**
  323. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  324. */
  325. hasItemsExprChange: EventEmitter<Function | string>;
  326. /**
  327. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  328. */
  329. heightChange: EventEmitter<number | Function | string>;
  330. /**
  331. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  332. */
  333. hintChange: EventEmitter<string>;
  334. /**
  335. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  336. */
  337. hoverStateEnabledChange: EventEmitter<boolean>;
  338. /**
  339. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  340. */
  341. itemHoldTimeoutChange: EventEmitter<number>;
  342. /**
  343. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  344. */
  345. itemsChange: EventEmitter<Array<DevExpress.ui.dxTreeViewItem>>;
  346. /**
  347. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  348. */
  349. itemsExprChange: EventEmitter<Function | string>;
  350. /**
  351. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  352. */
  353. itemTemplateChange: EventEmitter<any>;
  354. /**
  355. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  356. */
  357. keyExprChange: EventEmitter<Function | string>;
  358. /**
  359. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  360. */
  361. noDataTextChange: EventEmitter<string>;
  362. /**
  363. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  364. */
  365. parentIdExprChange: EventEmitter<Function | string>;
  366. /**
  367. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  368. */
  369. rootValueChange: EventEmitter<any>;
  370. /**
  371. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  372. */
  373. rtlEnabledChange: EventEmitter<boolean>;
  374. /**
  375. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  376. */
  377. scrollDirectionChange: EventEmitter<string>;
  378. /**
  379. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  380. */
  381. searchEditorOptionsChange: EventEmitter<DevExpress.ui.dxTextBoxOptions>;
  382. /**
  383. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  384. */
  385. searchEnabledChange: EventEmitter<boolean>;
  386. /**
  387. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  388. */
  389. searchExprChange: EventEmitter<Function | Array<Function>>;
  390. /**
  391. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  392. */
  393. searchModeChange: EventEmitter<string>;
  394. /**
  395. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  396. */
  397. searchTimeoutChange: EventEmitter<number>;
  398. /**
  399. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  400. */
  401. searchValueChange: EventEmitter<string>;
  402. /**
  403. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  404. */
  405. selectAllTextChange: EventEmitter<string>;
  406. /**
  407. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  408. */
  409. selectByClickChange: EventEmitter<boolean>;
  410. /**
  411. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  412. */
  413. selectedExprChange: EventEmitter<Function | string>;
  414. /**
  415. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  416. */
  417. selectionModeChange: EventEmitter<string>;
  418. /**
  419. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  420. */
  421. selectNodesRecursiveChange: EventEmitter<boolean>;
  422. /**
  423. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  424. */
  425. showCheckBoxesModeChange: EventEmitter<string>;
  426. /**
  427. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  428. */
  429. tabIndexChange: EventEmitter<number>;
  430. /**
  431. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  432. */
  433. virtualModeEnabledChange: EventEmitter<boolean>;
  434. /**
  435. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  436. */
  437. visibleChange: EventEmitter<boolean>;
  438. /**
  439. * This member supports the internal infrastructure and is not intended to be used directly from your code.
  440. */
  441. widthChange: EventEmitter<number | Function | string>;
  442. itemsChildren: QueryList<DxiItemComponent>;
  443. constructor(elementRef: ElementRef, ngZone: NgZone, templateHost: DxTemplateHost, _watcherHelper: WatcherHelper, _idh: IterableDifferHelper, optionHost: NestedOptionHost, transferState: TransferState, platformId: any);
  444. protected _createInstance(element: any, options: any): DxTreeView;
  445. ngOnDestroy(): void;
  446. ngOnChanges(changes: SimpleChanges): void;
  447. setupChanges(prop: string, changes: SimpleChanges): void;
  448. ngDoCheck(): void;
  449. _setOption(name: string, value: any): void;
  450. }
  451. export declare class DxTreeViewModule {
  452. }