Tk Library Source Code

Check-in [c05bfeb47a]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment: * CHANGES.txt: Updated to reflect the changes. * doc/tablelistWidget.html:
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: c05bfeb47a253341f29ca6fc63b63b7fbf7c6b9d
User & Date: csaba 2016-08-09 20:56:42
Context
2016-08-09
20:57
* scripts/tablelistBind.tcl: Added the "-autofinishediting" option; * scripts/tablelistConfig.tcl: adapted the implementation of the * scripts/tablelistEdit.tcl: "delete" subcommand to the changed text * scripts/tablelistWidget.tcl: widget behavior in Tk 8.6.5. * CHANGES.txt: Updated to reflect the changes. * doc/tablelistWidget.html: check-in: 2d65a1c4cf user: csaba tags: trunk
20:56
* CHANGES.txt: Updated to reflect the changes. * doc/tablelistWidget.html: check-in: c05bfeb47a user: csaba tags: trunk
20:55
* CHANGES.txt: Updated to reflect the changes. * doc/tablelistWidget.html: check-in: 20861e8214 user: csaba tags: trunk
Changes
Hide Diffs Unified Diffs Ignore Whitespace Patch

Changes to modules/tablelist/doc/tablelistWidget.html.

95
96
97
98
99
100
101



102
103
104
105
106
107
108
    <dd><code><b><a href="#arrowstyle">-arrowstyle</a></b>
    <b>flat5x3</b>|<b>flat5x4</b>|<b>flat6x4</b>|<b>flat7x4</b>|<b>flat7x5</b>|<b>flat7x7</b>|<br>
    &nbsp;<b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;flat8x4</b>|<b>flat8x5</b>|<b>flat9x5</b>|<b>flat9x6</b>|<b>flat11x6</b>|<b>flat15x8</b>|<br>
    &nbsp;<b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;flatAngle7x4</b>|<b>flatAngle7x5</b>|<b>flatAngle9x5</b>|<b>flatAngle9x6</b>|<br>
    &nbsp;<b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;flatAngle9x7</b>|<b>flatAngle10x6</b>|<b>flatAngle10x7</b>|<b>flatAngle11x6</b>|<br>
    &nbsp;<b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;flatAngle15x8</b>|<b>photo7x4</b>|<b>photo7x7</b>|<b>photo9x5</b>|<b>photo11x6</b>|<br>
    &nbsp;<b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;photo15x8</b>|<b>sunken8x7</b>|<b>sunken10x9</b>|<b>sunken12x11</b></code></dd>




    <dd><code><b><a href="#autoscan">-autoscan</a></b>
    <i>boolean</i></code></dd>

    <dd><code><b><a href="#collapsecommand">-collapsecommand</a></b>
    <i>command</i></code></dd>








>
>
>







95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
    <dd><code><b><a href="#arrowstyle">-arrowstyle</a></b>
    <b>flat5x3</b>|<b>flat5x4</b>|<b>flat6x4</b>|<b>flat7x4</b>|<b>flat7x5</b>|<b>flat7x7</b>|<br>
    &nbsp;<b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;flat8x4</b>|<b>flat8x5</b>|<b>flat9x5</b>|<b>flat9x6</b>|<b>flat11x6</b>|<b>flat15x8</b>|<br>
    &nbsp;<b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;flatAngle7x4</b>|<b>flatAngle7x5</b>|<b>flatAngle9x5</b>|<b>flatAngle9x6</b>|<br>
    &nbsp;<b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;flatAngle9x7</b>|<b>flatAngle10x6</b>|<b>flatAngle10x7</b>|<b>flatAngle11x6</b>|<br>
    &nbsp;<b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;flatAngle15x8</b>|<b>photo7x4</b>|<b>photo7x7</b>|<b>photo9x5</b>|<b>photo11x6</b>|<br>
    &nbsp;<b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;photo15x8</b>|<b>sunken8x7</b>|<b>sunken10x9</b>|<b>sunken12x11</b></code></dd>

    <dd><code><b><a href="#autofinishediting">-autofinishediting</a></b>
    <i>boolean</i></code></dd>

    <dd><code><b><a href="#autoscan">-autoscan</a></b>
    <i>boolean</i></code></dd>

    <dd><code><b><a href="#collapsecommand">-collapsecommand</a></b>
    <i>command</i></code></dd>

1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490































1491
1492
1493
1494
1495
1496
1497

        <p><img src="arrowStyles.png" alt="Arrow Styles" width="436" height=
        "174"></p>

        <p>While the sort arrows of the styles <code><b>flat*</b></code> and
        <code><b>sunken*</b></code> are created from bitmaps, the arrow styles
        <code><b>photo7x4</b></code>, <code><b>photo9x5</b></code>,
	<code><b>photo11x6</b></code>, and <code><b>photo15x8</b></code> use
	GIF images that look very close to the native sort arrows on Windows
	Vista, 7, and 8.&nbsp; When using one of these styles, the <code><b><a
	href="#arrowcolor">-arrowcolor</a></b></code> and <code><b><a href=
        "#arrowdisabledcolor">-arrowdisabledcolor</a></b></code> options have
        no effect.</p>
        
        <p>On Windows Vista, 7, 8, and 10, the sort arrows are shown
        horizontally centered in the header labels, just below their top
        edges:<p>

        <p><img src="arrowStyles_vista.png" alt="Arrow Styles Vista" width=
        "638" height= "123"></p>

        <p>The arrow style <code><b>photo7x7</b></code> uses PNG images that
	look and behave very close to the native sort arrows on Mac OS X Aqua
	versions earlier than 10.10 (Yosemite).&nbsp; This arrow style is only
	supported if the Tk version is either 8.6 (with built-in PNG support),
	or 8.5 and the <code><b>img::png</b></code> package can be loaded into
	the interpreter.&nbsp; When supported, <code><b>photo7x7</b></code>
	will be the default value of the <code><b>-arrowstyle</b></code> option
	in Tablelist_tile with the <code><b>aqua</b></code> theme for Mac OS X
        versions earlier than 10.10 (otherwise <code><b>flat7x7</b></code> will
        be used as default for these earlier OS X versions).&nbsp; When using
        this arrow style, the <code><b><a href=
        "#arrowcolor">-arrowcolor</a></b></code> and <code><b><a href=
        "#arrowdisabledcolor">-arrowdisabledcolor</a></b></code> options have
        no effect, but, due to the transparency information contained in the
        PNG images, the arrows will automatically adapt their color to the
        various states of the header labels, just like the native sort
        arrows.</p>
      </blockquote>
    </dd>
































    <dd id="autoscan">
      <table border="0" cellpadding="0" cellspacing="0">
        <tr>
          <td>Command-Line Name:&nbsp;</td>

          <td><code><b>-autoscan</b></code></td>







|
|
|
|











|
|
|
|
|
|
|











>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>







1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531

        <p><img src="arrowStyles.png" alt="Arrow Styles" width="436" height=
        "174"></p>

        <p>While the sort arrows of the styles <code><b>flat*</b></code> and
        <code><b>sunken*</b></code> are created from bitmaps, the arrow styles
        <code><b>photo7x4</b></code>, <code><b>photo9x5</b></code>,
        <code><b>photo11x6</b></code>, and <code><b>photo15x8</b></code> use
        GIF images that look very close to the native sort arrows on Windows
        Vista, 7, and 8.&nbsp; When using one of these styles, the <code><b><a
        href="#arrowcolor">-arrowcolor</a></b></code> and <code><b><a href=
        "#arrowdisabledcolor">-arrowdisabledcolor</a></b></code> options have
        no effect.</p>
        
        <p>On Windows Vista, 7, 8, and 10, the sort arrows are shown
        horizontally centered in the header labels, just below their top
        edges:<p>

        <p><img src="arrowStyles_vista.png" alt="Arrow Styles Vista" width=
        "638" height= "123"></p>

        <p>The arrow style <code><b>photo7x7</b></code> uses PNG images that
        look and behave very close to the native sort arrows on Mac OS X Aqua
        versions earlier than 10.10 (Yosemite).&nbsp; This arrow style is only
        supported if the Tk version is either 8.6 (with built-in PNG support),
        or 8.5 and the <code><b>img::png</b></code> package can be loaded into
        the interpreter.&nbsp; When supported, <code><b>photo7x7</b></code>
        will be the default value of the <code><b>-arrowstyle</b></code> option
        in Tablelist_tile with the <code><b>aqua</b></code> theme for Mac OS X
        versions earlier than 10.10 (otherwise <code><b>flat7x7</b></code> will
        be used as default for these earlier OS X versions).&nbsp; When using
        this arrow style, the <code><b><a href=
        "#arrowcolor">-arrowcolor</a></b></code> and <code><b><a href=
        "#arrowdisabledcolor">-arrowdisabledcolor</a></b></code> options have
        no effect, but, due to the transparency information contained in the
        PNG images, the arrows will automatically adapt their color to the
        various states of the header labels, just like the native sort
        arrows.</p>
      </blockquote>
    </dd>

    <dd id="autofinishediting">
      <table border="0" cellpadding="0" cellspacing="0">
        <tr>
          <td>Command-Line Name:&nbsp;</td>

          <td><code><b>-autofinishediting</b></code></td>
        </tr>

        <tr>
          <td>Database Name:</td>

          <td><code><b>&nbsp;autoFinishEditing</b></code></td>
        </tr>

        <tr>
          <td>Database Class:</td>

          <td><code><b>&nbsp;AutoFinishEditing</b></code></td>
        </tr>
      </table>

      <blockquote>
        <p>Specifies a boolean value that controls whether the interactive cell
        editing with the aid of a tile combobox, BWidget ComboBox, Iwidgets
        combobox, Oakley combobox, Tk core menubutton, or tile menubutton
        widget will be finished automatically by selecting an entry of the
        combobox or of the menu associated with the menubutton.&nbsp; The
        default value is <code>0</code>.</p>
      </blockquote>
    </dd>

    <dd id="autoscan">
      <table border="0" cellpadding="0" cellspacing="0">
        <tr>
          <td>Command-Line Name:&nbsp;</td>

          <td><code><b>-autoscan</b></code></td>
6007
6008
6009
6010
6011
6012
6013
6014





6015
6016
6017
6018
6019
6020
6021
    programmatically.&nbsp; Normal termination is also triggered by clicking
    with the left mouse button anywhere in the tablelist's body, outside the
    cell just being edited, or moving into another editable cell by using
    keyboard navigation.&nbsp; If the editing was started with the left mouse
    button, the edit window is a Tk or tile checkbutton, and the value of the
    <code><b><a href="#instanttoggle">-instanttoggle</a></b></code> option is
    true, then the normal termination of the editing will take place
    automatically, without any user interaction.</dd>






    <dd class="tm">When normal termination of the editing process occurs, the
    Tcl command associated with the tablelist widget compares the edit window's
    final contents to its original one.&nbsp; If they are equal then the
    embedded widget is destroyed and the cell's original value is
    restored.&nbsp; If the two strings are different and the value of the
    <code><b><a href="#editendcommand">-editendcommand</a></b></code>







|
>
>
>
>
>







6041
6042
6043
6044
6045
6046
6047
6048
6049
6050
6051
6052
6053
6054
6055
6056
6057
6058
6059
6060
    programmatically.&nbsp; Normal termination is also triggered by clicking
    with the left mouse button anywhere in the tablelist's body, outside the
    cell just being edited, or moving into another editable cell by using
    keyboard navigation.&nbsp; If the editing was started with the left mouse
    button, the edit window is a Tk or tile checkbutton, and the value of the
    <code><b><a href="#instanttoggle">-instanttoggle</a></b></code> option is
    true, then the normal termination of the editing will take place
    automatically, without any user interaction.&nbsp; Similarly, if the edit
    window is one of the four combobox widgets supported by Tablelist or a
    menubutton widget, and the value of the <code><b><a href=
    "#autofinishediting">-autofinishediting</a></b></code> option is true, then
    selecting a combobox or menu entry will auomatically terminate the editing
    session.</dd>

    <dd class="tm">When normal termination of the editing process occurs, the
    Tcl command associated with the tablelist widget compares the edit window's
    final contents to its original one.&nbsp; If they are equal then the
    embedded widget is destroyed and the cell's original value is
    restored.&nbsp; If the two strings are different and the value of the
    <code><b><a href="#editendcommand">-editendcommand</a></b></code>
7762
7763
7764
7765
7766
7767
7768
7769





7770
7771
7772
7773
7774
7775
7776
        editing a cell, or by clicking with the left mouse button anywhere in
        the tablelist's body, outside the cell just being edited, or moving
        into another editable cell by using keyboard navigation.&nbsp; If the
        editing was started with the left mouse button, the edit window is a Tk
        or tile checkbutton, and the value of the <code><b><a href=
        "#instanttoggle">-instanttoggle</a></b></code> option is true, then
        this subcommand will be invoked automatically, without any user
        interaction.</dd>






        <dd class="tm"><b>REMARK:</b>&nbsp; There are also situations where an
        <i>explicit</i> invocation of this subcommand is needed, in order to
        make sure that the cell just being edited gets updated with the text
        entered by the user.&nbsp; For example, if a tablelist widget is part
        of a dialog used for editing some data, then the command associated
        with the button designed to accept the data should call this







|
>
>
>
>
>







7801
7802
7803
7804
7805
7806
7807
7808
7809
7810
7811
7812
7813
7814
7815
7816
7817
7818
7819
7820
        editing a cell, or by clicking with the left mouse button anywhere in
        the tablelist's body, outside the cell just being edited, or moving
        into another editable cell by using keyboard navigation.&nbsp; If the
        editing was started with the left mouse button, the edit window is a Tk
        or tile checkbutton, and the value of the <code><b><a href=
        "#instanttoggle">-instanttoggle</a></b></code> option is true, then
        this subcommand will be invoked automatically, without any user
        interaction.&nbsp; Similarly, if the edit window is one of the four
        combobox widgets supported by Tablelist or a menubutton widget, and the
        value of the <code><b><a href=
        "#autofinishediting">-autofinishediting</a></b></code> option is true,
        then selecting a combobox or menu entry will auomatically invoke this
        subcommand and thus termate the editing session.</dd>

        <dd class="tm"><b>REMARK:</b>&nbsp; There are also situations where an
        <i>explicit</i> invocation of this subcommand is needed, in order to
        make sure that the cell just being edited gets updated with the text
        entered by the user.&nbsp; For example, if a tablelist widget is part
        of a dialog used for editing some data, then the command associated
        with the button designed to accept the data should call this