https://github.com/AHK-just-me/Class_LV_InCellEdit

AHK class supporting in-cell editing for ListView controls
https://github.com/AHK-just-me/Class_LV_InCellEdit

Last synced: about 2 months ago
JSON representation

AHK class supporting in-cell editing for ListView controls

• Host: GitHub
• URL: https://github.com/AHK-just-me/Class_LV_InCellEdit
• Owner: AHK-just-me
• Created: 2013-12-20T07:38:31.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2015-12-15T07:42:35.000Z (almost 9 years ago)
• Last Synced: 2024-05-19T05:25:41.412Z (4 months ago)
• Language: AutoHotkey
• Size: 29.3 KB
• Stars: 15
• Watchers: 7
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-AutoHotkey - LV_InCellEdit - by just Me - In-cell editing for ListView controls. Forum thread: [link](http://https://autohotkey.com/boards/viewtopic.php?f=6&t=1076) (Libraries / <a name="libraries-gui"></a>GUI)

README

        
# Class_LV_InCellEdit #

AHK class providing in-cell editing for ListView controls in AHK GUIs.

The class provides methods to restrict editing to certain columns, to directly start editing of a specified cell,

and to deactivate/activate the built-in message handler for `WM_NOTIFY` messages (see below).

The message handler for `WM_NOTIFY` messages will be activated for the specified ListView whenever a new instance is

created. As long as the message handler is activated a double-click on any cell will show an Edit control within this

cell allowing to edit the current content. The default behavior for editing the first column by two subsequent single

clicks is disabled. You have to press "Esc" to cancel editing, otherwise the content of the Edit will be stored in

the current cell. ListViews must have the `-ReadOnly` option to be editable.

While editing, "Esc", "Tab", "Shift+Tab", "Down", and "Up" keys are registered as hotkeys. "Esc" will cancel editing

without changing the value of the current cell. All other hotkeys will store the content of the edit in the current

cell and continue editing for the next (Tab), previous (Shift+Tab), upper (Up), or lower (Down) cell. You cannot use

the keys for other purposes while editing.

All changes are stored in `MyInstance.Changed`. You may track the changes by triggering `(A_GuiEvent == "F")` in the

ListView's gLabel and checking `MyInstance["Changed"]` as shown in the sample scipt. If "True", `MyInstance.Changed`

contains an array of objects with keys "Row" (row number), "Col" (column number), and "Txt" (new content).

'Changed' is one of the two keys intended to be accessed directly from outside the class.

If you want to temporarily disable in-cell editing call `MyInstance.OnMessage(False)`. This must be done also before

you try to destroy the instance. To enable it again, call `MyInstance.OnMessage()``.

To avoid the loss of Gui events and messages the message handler might need to be `Critical`. This can be

achieved by setting the instance property 'Critical' to the required value (e.g. `MyInstance.Critical := 100`).

New instances default to `Critical, Off`. Though sometimes needed, ListViews or the whole Gui may become

unresponsive under certain circumstances if `Critical` is set and the ListView has a g-label.