• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

haiiliin / abqpy / 6433593370

06 Oct 2023 03:30PM UTC coverage: 73.825% (-9.3%) from 83.134%
6433593370

push

github

web-flow
[feature] Add GUI Toolkit Commands (backport #5260) (#5285)

[feature] Add GUI Toolkit Commands (#5260)

* Markdown

* Delete

* Add AFXApp and AFXBoolKeyword

* Delete

* Update headings

* Create parse.py

* Update parse.py

* Unicode Spaces

* Update .pre-commit-config.yaml

* Update md types

* Update Kernel plug-in registration commands.md

* Generated python stubs

* Add class inheritance

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Revert "Update .pre-commit-config.yaml"

This reverts commit 9d3aef3cc.

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Fix mypy errors

* Delete parse.py

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Fix return types and imports

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Update AFXColumnItems.md

* Update abaqusGui.py

* Add class/global flags

* Delete flags.py

* Fix flags

* Fix

* Skip mypy

* Update abaqusGui.py

* Update constants.py

* Create kernelAccess.py

* Add plugin docs

* Revert changes by docformatter

* Delete markdown files

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
(cherry picked from commit a65ff5df8)

Co-authored-by: Hailin Wang <hailin.wang@connect.polyu.hk>

3661 of 3661 new or added lines in 151 files covered. (100.0%)

24137 of 32695 relevant lines covered (73.82%)

0.74 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

0.0
/src/abaqus/PlugInRegistration/AFXTreeTable.py
1
from __future__ import annotations
×
2

3
from .AFXDataComponent import AFXDataComponent
×
4
from .FXComposite import FXComposite
×
5
from .FXIcon import FXIcon
×
6
from .FXObject import FXObject
×
7
from .FXScrollArea import FXScrollArea
×
8
from .FXTreeItem import FXTreeItem
×
9

10
#: Allow users to resize columns.
11
AFXTREETABLE_COLUMN_RESIZABLE: int = hash("AFXTREETABLE_COLUMN_RESIZABLE")
×
12

13
#: Disallow column selections (selecting a header/footer item in a column selects the whole column).
14
AFXTREETABLE_NO_COLUMN_SELECT: int = hash("AFXTREETABLE_NO_COLUMN_SELECT")
×
15

16
#: Selecting any item in a row selects the whole row.
17
AFXTREETABLE_ROW_MODE: int = hash("AFXTREETABLE_ROW_MODE")
×
18

19
#: Use extended selection mode that allows multiple items to be selected and allows users to drag-select a range of items.
20
AFXTREETABLE_EXTENDED_SELECT: int = hash("AFXTREETABLE_EXTENDED_SELECT")
×
21

22
#: Use single selection mode that allows up to one item to be selected.
23
AFXTREETABLE_SINGLE_SELECT: int = hash("AFXTREETABLE_SINGLE_SELECT")
×
24

25
#: Use browse selection mode that enforces one single item to be selected at all times.
26
AFXTREETABLE_BROWSE_SELECT: int = hash("AFXTREETABLE_BROWSE_SELECT")
×
27

28
#: Show item check boxes.
29
AFXTREETABLE_CHECK_BOXES: int = hash("AFXTREETABLE_CHECK_BOXES")
×
30

31
#: Propagate checked state to children and parents.
32
AFXTREETABLE_PROPAGATE_CHECKS: int = hash("AFXTREETABLE_PROPAGATE_CHECKS")
×
33

34
#: Default table options--use extended selection mode, columns are resizable, and layout fills both X and Y directions.
35
AFXTREETABLE_NORMAL: int = hash("AFXTREETABLE_NORMAL")
×
36

37
#: Do not pre-select any list item.
38
AFXTREETABLE_LIST_PRESELECT_NONE: int = hash("AFXTREETABLE_LIST_PRESELECT_NONE")
×
39

40
#: Normal list.
41
AFXTREETABLE_LIST_NORMAL: int = hash("AFXTREETABLE_LIST_NORMAL")
×
42

43

44
class AFXTreeTable(FXScrollArea, AFXDataComponent):
×
45
    """This class combines a tree widget with a table widget to allow associating a row of data with an item in
46
    a tree."""
47

48
    #: Color item has no As Is and Default in its flyout.
49
    COLOR_INCLUDE_COLOR_ONLY: int = hash("COLOR_INCLUDE_COLOR_ONLY")
×
50

51
    #: Color item has As Is in its flyout.
52
    COLOR_INCLUDE_AS_IS: int = hash("COLOR_INCLUDE_AS_IS")
×
53

54
    #: Color item has Default in its flyout.
55
    COLOR_INCLUDE_DEFAULT: int = hash("COLOR_INCLUDE_DEFAULT")
×
56

57
    #: Color item has both As Is and Default in its flyout. This is the default option.
58
    COLOR_INCLUDE_ALL: int = hash("COLOR_INCLUDE_ALL")
×
59

60
    #: Not yet implemented (Real).
61
    REAL: int = hash("REAL")
×
62

63
    #: Left justified.
64
    LEFT: int = hash("LEFT")
×
65

66
    #: Right justified.
67
    RIGHT: int = hash("RIGHT")
×
68

69
    #: Center justified (horizontal).
70
    CENTER: int = hash("CENTER")
×
71

72
    #: Top justified.
73
    TOP: int = hash("TOP")
×
74

75
    #: Bottom justified.
76
    BOTTOM: int = hash("BOTTOM")
×
77

78
    #: Middle justified (vertical).
79
    MIDDLE: int = hash("MIDDLE")
×
80

81
    #: Item accepts a text string via a text field.
82
    TEXT: int = hash("TEXT")
×
83

84
    #: Item accepts a floating-point number via a text field.
85
    FLOAT: int = hash("FLOAT")
×
86

87
    #: Item accepts an integer via a text field.
88
    INT: int = hash("INT")
×
89

90
    #: Item accepts input from a list.
91
    LIST: int = hash("LIST")
×
92

93
    #: Item is a boolean; displayed as an icon.
94
    BOOL: int = hash("BOOL")
×
95

96
    #: Item displays an icon and does not accept input.
97
    ICON: int = hash("ICON")
×
98

99
    #: Item accepts color selection via a color flyout.
100
    COLOR: int = hash("COLOR")
×
101

102
    #: General.
103
    GENERAL: int = hash("GENERAL")
×
104

105
    #: Scientific.
106
    SCIENTIFIC: int = hash("SCIENTIFIC")
×
107

108
    #: Automatic.
109
    AUTOMATIC: int = hash("AUTOMATIC")
×
110

111
    def __init__(
×
112
        self,
113
        p: FXComposite,
114
        numVisItems: int,
115
        numVisColumns: int,
116
        numColumns: int,
117
        tgt: FXObject | None = None,
118
        sel: int = 0,
119
        opts: int = AFXTREETABLE_NORMAL,
120
        x: int = 0,
121
        y: int = 0,
122
        w: int = 0,
123
        h: int = 0,
124
    ):
125
        """Constructor.
126

127
        Parameters
128
        ----------
129
        p : FXComposite
130
            Parent widget.
131
        numVisItems : int
132
            Number of items to display.
133
        numVisColumns : int
134
            Number of columns in the table to display.
135
        numColumns : int
136
            Number of columns in the table.
137
        tgt : FXObject | None
138
            Message target.
139
        sel : int
140
            Message ID.
141
        opts : int
142
            Options and hints.
143
        x : int
144
            X coordinate of the origin.
145
        y : int
146
            Y coordinate of the origin.
147
        w : int
148
            Width of the table widget.
149
        h : int
150
            Height of the table widget.
151
        """
152

153
    def addItemAfter(self, other: FXTreeItem, item: FXTreeItem, notify: bool = False):
×
154
        """Appends the new tree item after the other tree item.
155

156
        Parameters
157
        ----------
158
        other : FXTreeItem
159

160
        item : FXTreeItem
161

162
        notify : bool
163
        """
164

165
    def addItemBefore(self, other: FXTreeItem, item: FXTreeItem, notify: bool = False):
×
166
        """Prepends the new item prior to the other tree item.
167

168
        Parameters
169
        ----------
170
        other : FXTreeItem
171

172
        item : FXTreeItem
173

174
        notify : bool
175
        """
176

177
    def addItemFirst(self, p: FXTreeItem, item: FXTreeItem, notify: bool = False):
×
178
        """Prepends the new tree item as first child of parent.
179

180
        Parameters
181
        ----------
182
        p : FXTreeItem
183

184
        item : FXTreeItem
185

186
        notify : bool
187
        """
188

189
    def addItemLast(self, p: FXTreeItem, item: FXTreeItem, notify: bool = False):
×
190
        """Appends the new tree item as the last child of the parent.
191

192
        Parameters
193
        ----------
194
        p : FXTreeItem
195

196
        item : FXTreeItem
197

198
        notify : bool
199
        """
200

201
    def addList(self, opts: int = AFXTREETABLE_LIST_NORMAL):
×
202
        """Adds a list to the table and returns the list ID. The list is used by items of type LIST.
203

204
        Parameters
205
        ----------
206
        opts : int
207
            List flag.
208
        """
209

210
    def appendListItem(self, listId: int, text: str, icon: FXIcon | None = None):
×
211
        """Appends an item to the specified table list; returns the index of the new item.
212

213
        Parameters
214
        ----------
215
        listId : int
216
            ID of the list to append to.
217
        text : str
218
            Item's text.
219
        icon : FXIcon | None
220
            Item's icon.
221
        """
222

223
    def beginEdit(self, item: FXTreeItem, column: int):
×
224
        """Sets the specified item in edit mode if the item is editable.
225

226
        Parameters
227
        ----------
228
        item : FXTreeItem
229
            Tree item.
230
        column : int
231
            Column index of item.
232
        """
233

234
    def cancelEdit(self):
×
235
        """Cancels the edit mode."""
236

237
    def clearContents(
×
238
        self,
239
        startItem: FXTreeItem,
240
        startColumn: int,
241
        endItem: FXTreeItem,
242
        endColumn: int,
243
        clearEditableOnly: bool = True,
244
    ):
245
        """Clears the text in the items in the specified range.
246

247
        Parameters
248
        ----------
249
        startItem : FXTreeItem
250
            Tree item in which to start clearing.
251
        startColumn : int
252
            Column in which to start clearing.
253
        endItem : FXTreeItem
254
            Tree item in which to end clearing.
255
        endColumn : int
256
            Column in which to end clearing.
257
        clearEditableOnly : bool
258
            Specify True to clear the text of editable items only.
259
        """
260

261
    def clearItems(self, notify: bool = False):
×
262
        """Removes all tree items and table rows.
263

264
        Parameters
265
        ----------
266
        notify : bool
267
        """
268

269
    def clearListItems(self, listId: int):
×
270
        """Removes all items from the specified table list.
271

272
        Parameters
273
        ----------
274
        listId : int
275
            ID of the list to clear.
276
        """
277

278
    def closeItem(self, item: FXTreeItem, notify: bool = False):
×
279
        """Closes the specified item.
280

281
        Parameters
282
        ----------
283
        item : FXTreeItem
284

285
        notify : bool
286
        """
287

288
    def collapseTree(self, item: FXTreeItem, notify: bool = False):
×
289
        """Collapses the specified item to hide its children.
290

291
        Parameters
292
        ----------
293
        item : FXTreeItem
294

295
        notify : bool
296
        """
297

298
    def deleteColumns(self, startColumn: int, numColumns: int = 1, notify: bool = False):
×
299
        """Deletes columns starting at the specified column.
300

301
        Parameters
302
        ----------
303
        startColumn : int
304
            Starting column.
305
        numColumns : int
306
            Number of columns to delete.
307
        notify : bool
308
            Specify True to notify target of the deletion.
309
        """
310

311
    def deselectItem(self, item: FXTreeItem, column: int, notify: bool = False):
×
312
        """Deselects the specified item.
313

314
        Parameters
315
        ----------
316
        item : FXTreeItem
317
            Tree item.
318
        column : int
319
            Column index of item.
320
        notify : bool
321
        """
322

323
    def deselectRow(self, item: FXTreeItem, notify: bool = False):
×
324
        """Deselects all items in the row.
325

326
        Parameters
327
        ----------
328
        item : FXTreeItem
329
            Tree item.
330
        notify : bool
331
        """
332

333
    def expandTree(self, item: FXTreeItem, notify: bool = False):
×
334
        """Expands the specified item to show its children.
335

336
        Parameters
337
        ----------
338
        item : FXTreeItem
339

340
        notify : bool
341
        """
342

343
    def getColumnWidth(self, column: int):
×
344
        """Returns the width, in pixels, of the specified column.
345

346
        Parameters
347
        ----------
348
        column : int
349
            Column index.
350
        """
351

352
    def getCurrentColumn(self):
×
353
        """Returns the column index of the current item."""
354

355
    def getCurrentItem(self):
×
356
        """Returns the current item, if any."""
357

358
    def getDefaultColumnWidth(self):
×
359
        """Returns the default column width, in pixels, of the table."""
360

361
    def getDefaultHeight(self):
×
362
        """Return default height.
363

364
        Reimplemented from FXScrollArea.
365
        """
366

367
    def getDefaultWidth(self):
×
368
        """Return default width.
369

370
        Reimplemented from FXScrollArea.
371
        """
372

373
    def getFirstItem(self):
×
374
        """Returns the first root tree item."""
375

376
    def getItemBoolValue(self, item: FXTreeItem, column: int):
×
377
        """Returns the value of a table item of type BOOL.
378

379
        Parameters
380
        ----------
381
        item : FXTreeItem
382
            Tree item.
383
        column : int
384
            Column index of table item.
385
        """
386

387
    def getItemCheck(self, item: FXTreeItem):
×
388
        """Returns the item checked state.
389

390
        Parameters
391
        ----------
392
        item : FXTreeItem
393
        """
394

395
    def getItemClosedIcon(self, item: FXTreeItem):
×
396
        """Returns the tree item's closed icon.
397

398
        Parameters
399
        ----------
400
        item : FXTreeItem
401
        """
402

403
    def getItemColor(self, item: FXTreeItem, column: int):
×
404
        """Returns the color of a table item of type COLOR. The color is "As is", "Default", or a color hex
405
        specification in the form of "RRGGBB" (e.g., "#0A1B2C").
406

407
        Parameters
408
        ----------
409
        item : FXTreeItem
410
            Tree item.
411
        column : int
412
            Column index of table item.
413
        """
414

415
    def getItemFloatValue(self, item: FXTreeItem, column: int):
×
416
        """Returns the value of a table item of type FLOAT.
417

418
        Parameters
419
        ----------
420
        item : FXTreeItem
421
            Tree item.
422
        column : int
423
            Column index of table item.
424
        """
425

426
    def getItemFormat(self, item: FXTreeItem, column: int):
×
427
        """Returns the format of a table item of type REAL (see RealFormat).
428

429
        Parameters
430
        ----------
431
        item : FXTreeItem
432
            Tree item.
433
        column : int
434
            Column index of table item.
435
        """
436

437
    def getItemIcon(self, item: FXTreeItem, column: int):
×
438
        """Returns the icon of a table item of type ICON.
439

440
        Parameters
441
        ----------
442
        item : FXTreeItem
443
            Tree item.
444
        column : int
445
            Column index of table item.
446
        """
447

448
    def getItemIntValue(self, item: FXTreeItem, column: int):
×
449
        """Returns the value of a table item of type INT.
450

451
        Parameters
452
        ----------
453
        item : FXTreeItem
454
            Tree item.
455
        column : int
456
            Column index of table item.
457
        """
458

459
    def getItemListId(self, item: FXTreeItem, column: int):
×
460
        """Returns the list ID of a table item of type LIST.
461

462
        Parameters
463
        ----------
464
        item : FXTreeItem
465
            Tree item.
466
        column : int
467
            Column index of table item.
468
        """
469

470
    def getItemListIndex(self, item: FXTreeItem, column: int):
×
471
        """Returns the list index (selection) of a table item of type LIST.
472

473
        Parameters
474
        ----------
475
        item : FXTreeItem
476
            Tree item.
477
        column : int
478
            Column index of table item.
479
        """
480

481
    def getItemNumDigits(self, item: FXTreeItem, column: int):
×
482
        """Returns the number of digits to the left of the decimal point for a table item of type REAL.
483

484
        Parameters
485
        ----------
486
        item : FXTreeItem
487
            Tree item.
488
        column : int
489
            Column index of table item.
490
        """
491

492
    def getItemOpenIcon(self, item: FXTreeItem):
×
493
        """Returns the tree item's open icon.
494

495
        Parameters
496
        ----------
497
        item : FXTreeItem
498
        """
499

500
    def getItemPrecision(self, item: FXTreeItem, column: int):
×
501
        """Returns the precision for a table item of type REAL.
502

503
        Parameters
504
        ----------
505
        item : FXTreeItem
506
            Tree item.
507
        column : int
508
            Column index of table item.
509
        """
510

511
    def getItemText(self, item: FXTreeItem, column: int):
×
512
        """Returns the text of an item of type TEXT.
513

514
        Parameters
515
        ----------
516
        item : FXTreeItem
517
            Tree item.
518
        column : int
519
            Column index of item.
520
        """
521

522
    def getItemType(self, item: FXTreeItem, column: int):
×
523
        """Returns the type of a table item.
524

525
        Parameters
526
        ----------
527
        item : FXTreeItem
528
            Tree item.
529
        column : int
530
            Column index of table item.
531
        """
532

533
    def getItemValue(self, item: FXTreeItem, column: int):
×
534
        """Returns the text-form value of a table item of any type.
535

536
        Parameters
537
        ----------
538
        item : FXTreeItem
539
            Tree item.
540
        column : int
541
            Column index of table item.
542
        """
543

544
    def getLastItem(self):
×
545
        """Returns the last root tree item."""
546

547
    def getListItemIcon(self, listId: int, index: int):
×
548
        """Returns the icon of the item at the specified index of the specified table list.
549

550
        Parameters
551
        ----------
552
        listId : int
553
            ID of the list.
554
        index : int
555
            Index into the list of the item to return.
556
        """
557

558
    def getListItemIndex(self, listId: int, text: str):
×
559
        """Returns the index of the item of the specified table list that has the specified text. Returns -1 if
560
        no such item exists.
561

562
        Parameters
563
        ----------
564
        listId : int
565
            ID of the list.
566
        text : str
567
            Text.
568
        """
569

570
    def getListItemText(self, listId: int, index: int):
×
571
        """Returns the text of the item at the specified index of the specified table list.
572

573
        Parameters
574
        ----------
575
        listId : int
576
            ID of the list.
577
        index : int
578
            Index into the list of the item to return.
579
        """
580

581
    def getNumColumns(self):
×
582
        """Returns the number of columns."""
583

584
    def getNumItems(self):
×
585
        """Returns the number of items."""
586

587
    def getNumListItems(self, listId: int):
×
588
        """Returns the number of items in the specified table list.
589

590
        Parameters
591
        ----------
592
        listId : int
593
            ID of the list.
594
        """
595

596
    def getTableStyle(self):
×
597
        """Returns the options related only to the table."""
598

599
    def getTreeColumn(self):
×
600
        """Returns the column index of the tree."""
601

602
    def getVisibleColumns(self):
×
603
        """Returns the number of visible columns."""
604

605
    def getVisibleItems(self):
×
606
        """Returns the number of visible items."""
607

608
    def insertColumns(self, startColumn: int, numColumns: int = 1, notify: bool = False):
×
609
        """Inserts columns at the specified location.
610

611
        Parameters
612
        ----------
613
        startColumn : int
614
            Starting column.
615
        numColumns : int
616
            Number of columns to insert.
617
        notify : bool
618
            Specify True to notify target of the insertion.
619
        """
620

621
    def isAnyItemInColumnSelected(self, column: int):
×
622
        """Returns True if any item in the column is selected.
623

624
        Parameters
625
        ----------
626
        column : int
627
            Column index.
628
        """
629

630
    def isAnyItemInRowSelected(self, item: FXTreeItem):
×
631
        """Returns True if any item in the row is selected.
632

633
        Parameters
634
        ----------
635
        item : FXTreeItem
636
            Tree item.
637
        """
638

639
    def isColumnSelected(self, column: int):
×
640
        """Returns True if all items in the column are selected.
641

642
        Parameters
643
        ----------
644
        column : int
645
            Column index.
646
        """
647

648
    def isItemBool(self, item: FXTreeItem, column: int):
×
649
        """Returns True if the specified table item is of type BOOL.
650

651
        Parameters
652
        ----------
653
        item : FXTreeItem
654
            Tree item.
655
        column : int
656
            Column index of table item.
657
        """
658

659
    def isItemColor(self, item: FXTreeItem, column: int):
×
660
        """Returns True if the specified table item is of type COLOR.
661

662
        Parameters
663
        ----------
664
        item : FXTreeItem
665
            Tree item.
666
        column : int
667
            Column index of table item.
668
        """
669

670
    def isItemEditable(self, item: FXTreeItem, column: int):
×
671
        """Returns True if the table item is editable.
672

673
        Parameters
674
        ----------
675
        item : FXTreeItem
676
            Tree item.
677
        column : int
678
            Column index of table item.
679
        """
680

681
    def isItemEmpty(self, item: FXTreeItem, column: int):
×
682
        """Returns True if the specified table item does not have a value.
683

684
        Parameters
685
        ----------
686
        item : FXTreeItem
687
            Tree item.
688
        column : int
689
            Column index of table item.
690
        """
691

692
    def isItemExpanded(self, item: FXTreeItem):
×
693
        """Returns True if the tree item is expanded, False otherwise.
694

695
        Parameters
696
        ----------
697
        item : FXTreeItem
698
        """
699

700
    def isItemFloat(self, item: FXTreeItem, column: int):
×
701
        """Returns True if the specified table item is of type FLOAT.
702

703
        Parameters
704
        ----------
705
        item : FXTreeItem
706
            Tree item.
707
        column : int
708
            Column index of table item.
709
        """
710

711
    def isItemIcon(self, item: FXTreeItem, column: int):
×
712
        """Returns True if the specified table item is of type ICON.
713

714
        Parameters
715
        ----------
716
        item : FXTreeItem
717
            Tree item.
718
        column : int
719
            Column index of table item.
720
        """
721

722
    def isItemInt(self, item: FXTreeItem, column: int):
×
723
        """Returns True if the specified table item is of type INT.
724

725
        Parameters
726
        ----------
727
        item : FXTreeItem
728
            Tree item.
729
        column : int
730
            Column index of table item.
731
        """
732

733
    def isItemLeaf(self, item: FXTreeItem):
×
734
        """Returns True if the tree item is a leaf-item (has no children), False otherwise.
735

736
        Parameters
737
        ----------
738
        item : FXTreeItem
739
        """
740

741
    def isItemList(self, item: FXTreeItem, column: int):
×
742
        """Returns True if the specified tabl eitem is of type LIST.
743

744
        Parameters
745
        ----------
746
        item : FXTreeItem
747
            Tree item.
748
        column : int
749
            Column index of table item.
750
        """
751

752
    def isItemOpened(self, item: FXTreeItem):
×
753
        """Returns True if the tree item is opened, False otherwise.
754

755
        Parameters
756
        ----------
757
        item : FXTreeItem
758
        """
759

760
    def isItemSelected(self, item: FXTreeItem, column: int):
×
761
        """Returns True if the specified item is selected.
762

763
        Parameters
764
        ----------
765
        item : FXTreeItem
766
            Tree item.
767
        column : int
768
            Column index of item.
769
        """
770

771
    def isItemText(self, item: FXTreeItem, column: int):
×
772
        """Returns True if the specified table item is of type TEXT.
773

774
        Parameters
775
        ----------
776
        item : FXTreeItem
777
            Tree item.
778
        column : int
779
            Column index of table item.
780
        """
781

782
    def isItemVisible(self, item: FXTreeItem, column: int):
×
783
        """Returns True if the specified item is visible.
784

785
        Parameters
786
        ----------
787
        item : FXTreeItem
788
            Tree item.
789
        column : int
790
            Column index of item.
791
        """
792

793
    def isRowSelected(self, item: FXTreeItem):
×
794
        """Returns True if all items in the row are selected.
795

796
        Parameters
797
        ----------
798
        item : FXTreeItem
799
        """
800

801
    def killSelection(self, notify: bool = False):
×
802
        """Deselects all items.
803

804
        Parameters
805
        ----------
806
        notify : bool
807
        """
808

809
    def makePositionVisible(self, item: FXTreeItem, column: int):
×
810
        """Scrolls to make the specified row, column fully visible.
811

812
        Parameters
813
        ----------
814
        item : FXTreeItem
815
            Tree item.
816
        column : int
817
            Column index of item.
818
        """
819

820
    def makeRowVisible(self, item: FXTreeItem):
×
821
        """Scrolls vertically (only) to make the specified row fully visible.
822

823
        Parameters
824
        ----------
825
        item : FXTreeItem
826
            Tree item.
827
        """
828

829
    def openItem(self, item: FXTreeItem, notify: bool = False):
×
830
        """Opens the specified item.
831

832
        Parameters
833
        ----------
834
        item : FXTreeItem
835

836
        notify : bool
837
        """
838

839
    def removeItem(self, item: FXTreeItem, notify: bool = False):
×
840
        """Removes the specified tree item and corresponding table row.
841

842
        Parameters
843
        ----------
844
        item : FXTreeItem
845

846
        notify : bool
847
        """
848

849
    def removeItems(self, from_: FXTreeItem, to: FXTreeItem, notify: bool = False):
×
850
        """Removes the specified tree items and their corresponding table rows, inclusively.
851

852
        Parameters
853
        ----------
854
        from_ : FXTreeItem
855

856
        to : FXTreeItem
857

858
        notify : bool
859
        """
860

861
    def removeListItem(self, listId: int, index: int):
×
862
        """Removes the item at the specified index from the specified table list; returns the number of items
863
        remaining in list.
864

865
        Parameters
866
        ----------
867
        listId : int
868
            ID of the list to remove from.
869
        index : int
870
            Index of the list item to remove.
871
        """
872

873
    def selectItem(self, item: FXTreeItem, column: int, notify: bool = False):
×
874
        """Selects the specified item.
875

876
        Parameters
877
        ----------
878
        item : FXTreeItem
879
            Tree item.
880
        column : int
881
            Column index of item.
882
        notify : bool
883
        """
884

885
    def selectRow(self, item: FXTreeItem, notify: bool = False):
×
886
        """Selects all items in the row.
887

888
        Parameters
889
        ----------
890
        item : FXTreeItem
891
            Tree item.
892
        notify : bool
893
        """
894

895
    def setColumnBoolIcons(self, column: int, trueIcon: FXIcon | None = None, falseIcon: FXIcon | None = None):
×
896
        """Sets the True and False icons of all existing and future table items in a column of type BOOL.
897
        Specifying -1 for the column will change all columns in the table and set the default for the table.
898

899
        Parameters
900
        ----------
901
        column : int
902
            Table column index.
903
        trueIcon : FXIcon | None
904
            Icon displayed when value is True; 0 = default icon.
905
        falseIcon : FXIcon | None
906
            Icon displayed when value is False; 0 = default icon.
907
        """
908

909
    def setColumnBoolValue(self, column: int, value: bool):
×
910
        """Sets the value of all existing and future table items in a column of type BOOL. Specifying -1 for the
911
        column will change all columns in the table and set the default for the table.
912

913
        Parameters
914
        ----------
915
        column : int
916
            Table column index.
917
        value : bool
918
            Specify True or False.
919
        """
920

921
    def setColumnColor(self, column: int, color: str):
×
922
        """Sets the color of all existing and future table items in a column of type COLOR. The color can be "As
923
        is", "Default", a color hex specification in the form of "RRGGBB" (e.g., "#0A1B2C"), or a pre-defined
924
        color name (e.g., "Red"). Specifying -1 for the column will change all columns in the table and set the
925
        default for the table.
926

927
        Parameters
928
        ----------
929
        column : int
930
            Table column index.
931
        color : str
932
            Color.
933
        """
934

935
    def setColumnColorItemDefault(self, column: int, color: str):
×
936
        """Sets the color of the color item in the flyout menu for all existing and future table items that
937
        display "As is" or "Default" in a column of type COLOR. The color is either a color hex specification in
938
        the form of "RRGGBB" (e.g., "#0A1B2C") or a pre-defined color name (e.g., "Red"). Specifying -1 for the
939
        column will change all columns in the table and set the default for the table.
940

941
        Parameters
942
        ----------
943
        column : int
944
            Table column index.
945
        color : str
946
            Color.
947
        """
948

949
    def setColumnColorOptions(self, column: int, opts: int):
×
950
        """Sets the color flyout options for all existing and future table items in a column of type COLOR.
951
        Specifying -1 for the column will change all columns in the table and set the default for the table.
952

953
        Parameters
954
        ----------
955
        column : int
956
            Table column index.
957
        opts : int
958
            Options (see ColorFlyoutOptions).
959
        """
960

961
    def setColumnEditable(self, column: int, editable: bool):
×
962
        """Sets the editability of all existing and future table items in a column. Specifying -1 for the column
963
        will change all columns in the table and set the default for the table.
964

965
        Parameters
966
        ----------
967
        column : int
968
            Table column index.
969
        editable : bool
970
            Specify True for editable, False for read-only.
971
        """
972

973
    def setColumnFloatValue(self, column: int, value: float):
×
974
        """Sets the value of all existing and future table items in a column of type FLOAT. Specifying -1 for
975
        the column will change all columns in the table and set the default for the table.
976

977
        Parameters
978
        ----------
979
        column : int
980
            Table column index.
981
        value : float
982
            Floating-point value.
983
        """
984

985
    def setColumnFormat(self, column: int, format: int):
×
986
        """Sets the real format for all existing and future table items in a column of type REAL.
987

988
        Parameters
989
        ----------
990
        column : int
991
            Table column index.
992
        format : int
993
            Default format of REAL values in column (see RealFormat).
994
        """
995

996
    def setColumnIcon(self, column: int, icon: FXIcon | None = None):
×
997
        """Sets the icon of all existing and future table items in a column of type ICON. Specifying -1 for the
998
        column will change all columns in the table and set the default for the table.
999

1000
        Parameters
1001
        ----------
1002
        column : int
1003
            Table column index.
1004
        icon : FXIcon | None
1005
            Icon.
1006
        """
1007

1008
    def setColumnIntValue(self, column: int, value: int):
×
1009
        """Sets the value of all existing and future table items in a column of type INT. Specifying -1 for the
1010
        column will change all columns in the table and set the default for the table.
1011

1012
        Parameters
1013
        ----------
1014
        column : int
1015
            Table column index.
1016
        value : int
1017
            Integer value.
1018
        """
1019

1020
    def setColumnJustify(self, column: int, justify: int):
×
1021
        """Sets the justification of all existing and future table items in a column. Specifying -1 for the
1022
        column will change all columns in the table and set the default for the table.
1023

1024
        Parameters
1025
        ----------
1026
        column : int
1027
            Table column index.
1028
        justify : int
1029
            Justification (see ItemJustify).
1030
        """
1031

1032
    def setColumnListId(self, column: int, listId: int):
×
1033
        """Sets the list ID of all existing and future table items in a column of type LIST. Specifying -1 for
1034
        the column will change all columns in the table and set the default for the table.
1035

1036
        Parameters
1037
        ----------
1038
        column : int
1039
            Table column index.
1040
        listId : int
1041
            List ID.
1042
        """
1043

1044
    def setColumnListIndex(self, column: int, index: int):
×
1045
        """Sets the list index (selection) of all existing and future table items in a column of type LIST.
1046
        Specifying -1 for the column will change all columns in the table and set the default for the table.
1047

1048
        Parameters
1049
        ----------
1050
        column : int
1051
            Table column index.
1052
        index : int
1053
            Index of item to be selected.
1054
        """
1055

1056
    def setColumnNumDigits(self, column: int, numDigits: int):
×
1057
        """Sets the number of digits to the left of the decimal point for all existing and future table items in
1058
        a column of type REAL.
1059

1060
        Parameters
1061
        ----------
1062
        column : int
1063
            Table column index.
1064
        numDigits : int
1065
            Default number of digits the left of the decimal point.
1066
        """
1067

1068
    def setColumnPrecision(self, column: int, precision: int):
×
1069
        """Sets the precision for all existing and future table items in a column of type REAL.
1070

1071
        Parameters
1072
        ----------
1073
        column : int
1074
            Table column index.
1075
        precision : int
1076
            Number of digits to the right of the decimal point.
1077
        """
1078

1079
    def setColumnText(self, column: int, text: str):
×
1080
        """Sets the text of all existing and future table items in a column of type TEXT. Specifying -1 for the
1081
        column will change all columns in the table and set the default for the table.
1082

1083
        Parameters
1084
        ----------
1085
        column : int
1086
            Table column index.
1087
        text : str
1088
            Text.
1089
        """
1090

1091
    def setColumnType(self, column: int, type: int):
×
1092
        """Sets the type of a column. Specifying -1 for the table column will change all columns in the table
1093
        and set the default for the table.
1094

1095
        Parameters
1096
        ----------
1097
        column : int
1098
            Table column index.
1099
        type : int
1100
            Type (see Flags for item types).
1101
        """
1102

1103
    def setColumnWidth(self, column: int, width: int):
×
1104
        """Sets the width, in pixels, of the specified column. Specifying -1 for the column will change all non-
1105
        leading and non-trailing columns in the table and set the default for the table. Specify -1 for the
1106
        width will resize each specified column to best fit the width of the title(s) currently shown in its
1107
        leading and trailing items.
1108

1109
        Parameters
1110
        ----------
1111
        column : int
1112
            Column index.
1113
        width : int
1114
            Width in pixels.
1115
        """
1116

1117
    def setColumnWidthInChars(self, column: int, numChars: int):
×
1118
        """Sets the width, in number of characters, of the specified column. Specifying -1 for the column will
1119
        change all non-leading and non-trailing columns in the table and set the default for the table.
1120

1121
        Parameters
1122
        ----------
1123
        column : int
1124
            Column index.
1125
        numChars : int
1126
            Width in number of characters.
1127
        """
1128

1129
    def setCurrentItem(self, item: FXTreeItem, column: int, notify: bool = False):
×
1130
        """Sets the current item.
1131

1132
        Parameters
1133
        ----------
1134
        item : FXTreeItem
1135
            Tree item.
1136
        column : int
1137
            Column index of item.
1138
        notify : bool
1139
        """
1140

1141
    def setDefaultBoolIcons(self, trueIcon: FXIcon | None = None, falseIcon: FXIcon | None = None):
×
1142
        """Sets the default True and False icons for the table (0 = default icon).
1143

1144
        Parameters
1145
        ----------
1146
        trueIcon : FXIcon | None
1147
            Icon displayed when value is True; 0 = default icon.
1148
        falseIcon : FXIcon | None
1149
            Icon displayed when value is False; 0 = default icon.
1150
        """
1151

1152
    def setDefaultBoolValue(self, value: bool):
×
1153
        """Sets the default bool value for the table.
1154

1155
        Parameters
1156
        ----------
1157
        value : bool
1158
            Specify True or False.
1159
        """
1160

1161
    def setDefaultColor(self, color: str):
×
1162
        """Sets the default color for all items of type COLOR in the table. The color can be "As is", "Default",
1163
        a color hex specification in the form of "RRGGBB" (e.g., "#0A1B2C"), or a pre-defined color name (e.g.,
1164
        "Red").
1165

1166
        Parameters
1167
        ----------
1168
        color : str
1169
            Color.
1170
        """
1171

1172
    def setDefaultColumnWidth(self, width: int):
×
1173
        """Sets the default width, in pixels, for all columns.
1174

1175
        Parameters
1176
        ----------
1177
        width : int
1178
            Width in pixels.
1179
        """
1180

1181
    def setDefaultFloatValue(self, value: float):
×
1182
        """Sets the default floating-point value for the table.
1183

1184
        Parameters
1185
        ----------
1186
        value : float
1187
            Floating-point value.
1188
        """
1189

1190
    def setDefaultFormat(self, format: int):
×
1191
        """Sets the default real format for the table.
1192

1193
        Parameters
1194
        ----------
1195
        format : int
1196
            Format flag.
1197
        """
1198

1199
    def setDefaultIntValue(self, value: int):
×
1200
        """Sets the default integer value for the table.
1201

1202
        Parameters
1203
        ----------
1204
        value : int
1205
            Integer value.
1206
        """
1207

1208
    def setDefaultJustify(self, justify: int):
×
1209
        """Sets the default justification for the table.
1210

1211
        Parameters
1212
        ----------
1213
        justify : int
1214
            Justification (see ItemJustify).
1215
        """
1216

1217
    def setDefaultNumDigits(self, numDigits: int):
×
1218
        """Sets the default number of digits to the left of the decimal point for the table.
1219

1220
        Parameters
1221
        ----------
1222
        numDigits : int
1223
            Number of digits.
1224
        """
1225

1226
    def setDefaultPrecision(self, precision: int):
×
1227
        """Sets the precision for the table.
1228

1229
        Parameters
1230
        ----------
1231
        precision : int
1232
            Precision.
1233
        """
1234

1235
    def setDefaultText(self, text: str):
×
1236
        """Sets the default text for the table.
1237

1238
        Parameters
1239
        ----------
1240
        text : str
1241
            Text.
1242
        """
1243

1244
    def setDefaultType(self, type: int):
×
1245
        """Sets the default type for the table.
1246

1247
        Parameters
1248
        ----------
1249
        type : int
1250
            Type (see Flags for item types).
1251
        """
1252

1253
    def setItemBoolIcons(
×
1254
        self, item: FXTreeItem, column: int, trueIcon: FXIcon | None = None, falseIcon: FXIcon | None = None
1255
    ):
1256
        """Sets the True and False icons of a table item of type BOOL.
1257

1258
        Parameters
1259
        ----------
1260
        item : FXTreeItem
1261
            Tree item.
1262
        column : int
1263
            Column index of table item.
1264
        trueIcon : FXIcon | None
1265
            Icon displayed when value is True; 0 = default icon.
1266
        falseIcon : FXIcon | None
1267
            Icon displayed when value is False; 0 = default icon.
1268
        """
1269

1270
    def setItemBoolValue(self, item: FXTreeItem, column: int, value: bool):
×
1271
        """Sets the value of a table item of type BOOL.
1272

1273
        Parameters
1274
        ----------
1275
        item : FXTreeItem
1276
            Tree item.
1277
        column : int
1278
            Column index of table item.
1279
        value : bool
1280
            Specify True or False.
1281
        """
1282

1283
    def setItemCheck(self, item: FXTreeItem, check: int, notify: bool = False):
×
1284
        """Sets the item checked state. Valid states are True, False and MAYBE. Returns True if the check value
1285
        has changed, False otherwise.
1286

1287
        Parameters
1288
        ----------
1289
        item : FXTreeItem
1290

1291
        check : int
1292

1293
        notify : bool
1294
        """
1295

1296
    def setItemClosedIcon(self, item: FXTreeItem, icon: FXIcon):
×
1297
        """Changes the tree item's closed icon.
1298

1299
        Parameters
1300
        ----------
1301
        item : FXTreeItem
1302

1303
        icon : FXIcon
1304
        """
1305

1306
    def setItemColor(self, item: FXTreeItem, column: int, color: str):
×
1307
        """Sets the color of a table item of type COLOR. The color can be "As is", "Default", a color hex
1308
        specification in the form of "RRGGBB" (e.g., "#0A1B2C"), or a pre-defined color name (e.g., "Red").
1309

1310
        Parameters
1311
        ----------
1312
        item : FXTreeItem
1313
            Tree item.
1314
        column : int
1315
            Column index of table item.
1316
        color : str
1317
            Color.
1318
        """
1319

1320
    def setItemEditable(self, item: FXTreeItem, column: int, editable: bool):
×
1321
        """Sets the editability of a table item.
1322

1323
        Parameters
1324
        ----------
1325
        item : FXTreeItem
1326
            Tree item.
1327
        column : int
1328
            Column index of table item.
1329
        editable : bool
1330
            Specify True for editable, False for read-only.
1331
        """
1332

1333
    def setItemFloatValue(self, item: FXTreeItem, column: int, value: float):
×
1334
        """Sets the value of a table item of type FLOAT.
1335

1336
        Parameters
1337
        ----------
1338
        item : FXTreeItem
1339
            Tree item.
1340
        column : int
1341
            Column index of table item.
1342
        value : float
1343
            Floating-point value.
1344
        """
1345

1346
    def setItemFormat(self, item: FXTreeItem, column: int, format: int):
×
1347
        """Sets the format for a table item of type REAL (see RealFormat).
1348

1349
        Parameters
1350
        ----------
1351
        item : FXTreeItem
1352
            Tree item.
1353
        column : int
1354
            Table column index of item.
1355
        format : int
1356
            Format of table item (see RealFormat).
1357
        """
1358

1359
    def setItemIcon(self, item: FXTreeItem, column: int, icon: FXIcon | None = None):
×
1360
        """Sets the icon of a table item of type ICON.
1361

1362
        Parameters
1363
        ----------
1364
        item : FXTreeItem
1365
            Tree item.
1366
        column : int
1367
            Column index of table item.
1368
        icon : FXIcon | None
1369
            Icon.
1370
        """
1371

1372
    def setItemIntValue(self, item: FXTreeItem, column: int, value: int):
×
1373
        """Sets the value of a table item of type INT.
1374

1375
        Parameters
1376
        ----------
1377
        item : FXTreeItem
1378
            Tree item.
1379
        column : int
1380
            Column index of table item.
1381
        value : int
1382
            Integer value.
1383
        """
1384

1385
    def setItemJustify(self, item: FXTreeItem, column: int, justify: int):
×
1386
        """Sets the justification of an item.
1387

1388
        Parameters
1389
        ----------
1390
        item : FXTreeItem
1391
            Tree item.
1392
        column : int
1393
            Column index of table item.
1394
        justify : int
1395
            Justification (see ItemJustify).
1396
        """
1397

1398
    def setItemListId(self, item: FXTreeItem, column: int, listId: int):
×
1399
        """Sets the list ID of a table item of type LIST.
1400

1401
        Parameters
1402
        ----------
1403
        item : FXTreeItem
1404
            Tree item.
1405
        column : int
1406
            Column index of table item.
1407
        listId : int
1408
            List ID.
1409
        """
1410

1411
    def setItemListIndex(self, item: FXTreeItem, column: int, index: int):
×
1412
        """Sets the list index (selection) of a table item of type LIST.
1413

1414
        Parameters
1415
        ----------
1416
        item : FXTreeItem
1417
            Tree item.
1418
        column : int
1419
            Column index of table item.
1420
        index : int
1421
            Index of item to be selected.
1422
        """
1423

1424
    def setItemNumDigits(self, item: FXTreeItem, column: int, numDigits: int):
×
1425
        """Sets the number of digits to the left of the decimal point for a table item of type REAL.
1426

1427
        Parameters
1428
        ----------
1429
        item : FXTreeItem
1430
            Tree item.
1431
        column : int
1432
            Column index of table item.
1433
        numDigits : int
1434
            Number of digits.
1435
        """
1436

1437
    def setItemOpenIcon(self, item: FXTreeItem, icon: FXIcon):
×
1438
        """Sets the tree item's open icon.
1439

1440
        Parameters
1441
        ----------
1442
        item : FXTreeItem
1443

1444
        icon : FXIcon
1445
        """
1446

1447
    def setItemPrecision(self, item: FXTreeItem, column: int, precision: int):
×
1448
        """Sets the precision for a table item of type REAL.
1449

1450
        Parameters
1451
        ----------
1452
        item : FXTreeItem
1453
            Tree item.
1454
        column : int
1455
            Column index of table item.
1456
        precision : int
1457
            Number of digits to the right of the decimal point.
1458
        """
1459

1460
    def setItemText(self, item: FXTreeItem, column: int, text: str):
×
1461
        """Sets the text of an item of type TEXT.
1462

1463
        Parameters
1464
        ----------
1465
        item : FXTreeItem
1466
            Tree item.
1467
        column : int
1468
            Column index of item.
1469
        text : str
1470
            Text.
1471
        """
1472

1473
    def setItemType(self, item: FXTreeItem, column: int, type: int):
×
1474
        """Sets the type of a table item.
1475

1476
        Parameters
1477
        ----------
1478
        item : FXTreeItem
1479
            Tree item.
1480
        column : int
1481
            Column index of table item.
1482
        type : int
1483
            Type (see Flags for item types).
1484
        """
1485

1486
    def setItemValue(self, item: FXTreeItem, column: int, valueText: str):
×
1487
        """Sets the value of a table item of any type that can interpret a text string for its value. Returns
1488
        True if the value of the specified item is set successfully.
1489

1490
        Parameters
1491
        ----------
1492
        item : FXTreeItem
1493
            Tree item.
1494
        column : int
1495
            Column index of table item.
1496
        valueText : str
1497
            Text-form value of table item.
1498
        """
1499

1500
    def setLeadingRowLabels(self, str: str):
×
1501
        """Set the labels of the leading row. Note: this API must be used to set the header row labels,
1502
        otherwise labels will be overwritten by auto-numbering.
1503

1504
        Parameters
1505
        ----------
1506
        str : str
1507
            Tab "t" delimited list, can also contain newline characters indicating that label contains multiple lines of text (e.g. "Young'snModulustPoisson'snRatio").
1508
        """
1509

1510
    def setListMaxVisible(self, maxVisible: int):
×
1511
        """Sets the maximum number of visible items for all table lists.
1512

1513
        Parameters
1514
        ----------
1515
        maxVisible : int
1516
            Maximum number of visible items.
1517
        """
1518

1519
    def setTableStyle(self, style: int):
×
1520
        """Sets the table options.
1521

1522
        Parameters
1523
        ----------
1524
        style : int
1525
            Style flag (see Flags for AFX table options).
1526
        """
1527

1528
    def setVisibleColumns(self, visibleColumns: int):
×
1529
        """Sets the number of visible columns.
1530

1531
        Parameters
1532
        ----------
1533
        visibleColumns : int
1534
            Number of visible columns.
1535
        """
1536

1537
    def setVisibleItems(self, visibleItems: int):
×
1538
        """Sets the number of visible items.
1539

1540
        Parameters
1541
        ----------
1542
        visibleItems : int
1543
            Number of visible items.
1544
        """
1545

1546
    def shadeReadOnlyItems(self, shadeItems: bool):
×
1547
        """Makes the table to use a different, typically shaded, background color for read-only items if True is
1548
        passed to the method. The table would use the same regular background color for both editable and read-
1549
        only items if False is passed to the method.
1550

1551
        Parameters
1552
        ----------
1553
        shadeItems : bool
1554
            Specify True to use a different background color for read-only items.
1555
        """
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc