InputText: Add a way to reset input text state.

[kudaba]

In response to #2881, I added an internal flag to trigger a text input box to reinitialize to it's current value. This resets any selection and undo state but adds opportunity for new interaction opportunities.

[ocornut]

It's hard to decide what's the desired behavior here, the PR is too specific to your exact need (reset undo stack, reset cursor position, select all, with widget still holding the active id) so I'll need to think about it a little further but basically I am lacking enough use case to take a suitable decision.

[kudaba]

I realized I never added a link to the use case: https://gist.github.com/kudaba/01337c088a0bcef0c2e22a4e846f729c

Unfortunately the mouse drag drop part is using private utilities, but applying changes using the mouse wheel has the same issue of requiring this flag to make the input text box refresh its value.

[JPGygax68]

I also need a way to reset a text field after the call to InputText(...).

My use case is a bit peculiar, but I think not really unique: I need to change the content of the input field when Backspace is pressed in a specific situation. That part is easy to do using the CallbackAlways flag and the provided ImGuiInputTextCallbackData pointer. But there is a twist: I also need to modify another part of the UI, which at that point has already been committed to the draw list. This causes a very, very annoying flicker in the UI, as inconsistent data is being displayed for one frame.

I tried hard to work around the problem, and I see a way in this particular situation - setting a flag that will trigger the update during the next time the "always" callback gets called. (I haven't done this yet, but I'm fairly sure it will work.)

But this is a bit cumbersome. What I really need is a way to feed new content to the input field either before or after it is being committed to the draw list - after would be better, since else I would again need to define a flag.

So I think the easiest and most versatile way to solve this would be to add a function that gives access to the InputText state after it has just been drawn. Combined with IsItemActive(), this would allow users to react to keyboard input after the text field has been drawn.

[JPGygax68]

@ocornut EDIT 2020-04-05: Problem solved at last. I've deleted the original text of the comment and replaced it with the following working solution.

Two situations need to be covered:

1. changing the content of InputText when it's active
2. changing the content when it's not active

I have to repeat here that neither of these would present a real challenge if it wasn't for the fact that, in my case, I cannot directly change the content of the field from inside the callback - which would be quite easy - because it would cause a flicker: for a single frame, the input field and the text items on the same line just before it, and thus already drawn would conflict and display a wrong combination of data (a chain of folder names belonging to the same path).

So, I came up with the following solution:

1. define a std::<optional>::std::string that can be set anywhere - either in "outside" code or from inside the InputText callback - to trigger a reload of the input buffer in the next frame
2. prepend the ImGui::InputText() call with a block of code that will execute if the input field is not active, checking the optional and, if set, copy its value into the input buffer
3. add a similar check in the ImGuiInputTextFlags_CallbackAlways handler, which will do the same thing for when the input field is active, this time using the methods and fields of the ImGuiInputTextCallbackData struct.

Here is the most relevant code snippet:

if (new_foldername.has_value() && ImGui::GetActiveID() != ImGui::GetID("###FolderName")) {
    strcpy_s(folder_buffer, new_foldername.value().c_str());
    new_foldername.reset();
}
auto flags = ImGuiInputTextFlags_CallbackAlways | ImGuiInputTextFlags_EnterReturnsTrue |
    ImGuiInputTextFlags_CallbackCompletion | ImGuiInputTextFlags_CallbackCharFilter |
    ImGuiInputTextFlags_CallbackHistory;
if (ImGui::InputText("###FolderName", folder_buffer, IM_ARRAYSIZE(folder_buffer), flags, [](ImGuiInputTextCallbackData* data) {
    auto that = static_cast<FileDialog*>(data->UserData);
    // TODO: protect against being used when path is completely empty -> crashes
    if (data->EventFlag == ImGuiInputTextFlags_CallbackAlways) {
        if (that->new_foldername.has_value() ) {
            data->DeleteChars(0, data->BufTextLen);
            data->InsertChars(0, that->new_foldername.value().c_str());
            data->CursorPos = that->new_foldername.value().size();
            data->SelectionStart = data->SelectionEnd = 0;
            data->BufDirty = true;
            that->new_foldername.reset();
        }
        if (ImGui::IsKeyPressed(ImGui::GetKeyIndex(ImGuiKey_Backspace)) && strlen(that->folder_buffer) == 0) {
            if (that->selected_folder) {
                auto parent = that->selected_folder->parent;
                auto& path = that->selected_folder->dir_entry.path();
                that->new_foldername = parent ? path.filename().string() : path.string();
                that->selectFolder(parent);
            }
        }
        return 0;
    }
    ...
}

[ocornut]

@JPGygax68 I am really confused by the complexity of your two posts above. AFAIK the flag as proposed by @kudaba would exactly solve your problem as you can set the reinit/reload frame whenever works for you.

I see the desire for the behavior requested in this PR, and want to add it, but my issue boils down to that comment:

It's hard to decide what's the desired behavior here, the PR is too specific to your exact need (reset undo stack, reset cursor position, select all, with widget still holding the active id)

People may want to reload buffer but not select all etc. It's trivial to express those variations in user code but a single flag can't express them.

[JPGygax68]

@ocornut I'm not at all saying that @kudaba's solution wouldn't work for me - it's just that I wanted to use the original, unpatched code at the time.

[kudaba]

FYI, I found one issue when trying to implement an auto complete system where it would keep the cursor position when reinitializing. I'm trying to push an updated version but sourcetree is fighting me atm.

in the else block of if (recycle_state) (imgui_widgets.cpp(~3981). it should have the following:

            // when (re)initializing we send the cursor to the end so typing will be at the right spot. Any options that will cause a select all will overwrite this anyway
            state->Stb.cursor = state->CurLenW;

            if (!is_multiline && (focus_requested_by_code || (reinitialize && (flags & ImGuiInputTextFlags_AutoSelectAll))))
                select_all = true;

I saw you mention this in some issues so I wanted to make sure to get this modification in before you accept the changes.

Auto Complete system for reference: https://gist.github.com/kudaba/af24f859f46ca339a5dedba9074f4dee

[kudaba]

Managed to get my local state working and updated the PR with the latest version

[ocornut]

I would like to find a solution - or even workaround for imgui_internal.h, but your last change pinpoint at exactly what the problem is that I pointed by my first answer.

// when (re)initializing we send the cursor to the end so typing will be at the right spot.

This is absolutely arbitrary to your specific use case.
Some people will need to keep cursor position and/or selection etc.
At which point the solution is either to provide wider access to the state, either design flags carrying more semantic (even if they are temporary or internal).

[kudaba]

Updated to an enum so users can control the selection behavior.

[ocornut]

I have merged this now - better late than never :)
It's not exactly your PR but closely based on same logic, except I replaced the enum with entry points and specifying cursor positions. You can find it as 06ce312.

This has been a very frequently mentioned issue, so even though I am hoping InputText V2 won't need this, this is a good workaround. My apologies for not looking into this earlier!

Typical usage:

if (ImGuiInputTextState* input_state = ImGui::GetInputTextState(ImGui::GetID("input"))
    input_state->ReloadUserBufAndSelectAll();
ImGui::InputText("input", ....);

Or

ImGui::InputText("input", ...);
if (ImGuiInputTextState* input_state =  ImGui::GetInputTextState(ImGui::GetItemID()))
    input_state->ReloadUserBufAndSelectAll();

[ocornut]

I have amended this with 1e8fc01 + 7d67623 (fix) to make the ReloadUserBufXXX() not affect the InitialTextA[] buffer which is solely used for Reverting when pressing Escape. In other word, when the user presses Escape it always revert to initial value regardless of ReloadUserBufXXX calls. We may make this optional.

[ocornut]

Pushed 324d4bb, calling ReloadUserBufXXXX now doesn't clear undo-stack so you can Ctrl+Z back your way to previous state.