How to select or highlight a FListView item?

[grrussel]

Feature Request

I have a FListView, where I would like to automatically select (or highlight) a row other than the first.
I cannot find an API to do this in the current Final Cut.

Your desired solution

I would like to be able to issue an API call "listview.setSelectedRow(123)" and have the row be highlighted/selected and visible.

Alternatives you have considered

I could format the window contents as a Text View, but then I would lose the column hiding abilities of the List View.

Additional context

[gansm]

Hi grrussel, the FListView organizes all FListViewItems into a tree structure with branches that can be expanded or collapsed. You need to use the FListViewIterator to navigate to a specific position.

Would it be helpful if stepForward() and stepBackward() were public?

final/widget/flistview.h

    ...
    auto expandSubtree() -> bool;
    auto collapseSubtree() -> bool;
    void setRelativePosition (int);
  public:  // Please add this line
    void stepForward();
    void stepBackward();
    void stepForward (int);
    void stepBackward (int);
  private:  // and this line
    void scrollToX (int);
    void scrollToY (int);
    void scrollTo (const FPoint&);
    void scrollTo (int, int);
    ...

Test code:

#include <final/final.h>

using namespace finalcut;

class ListDialogWidget : public FDialog
{
  public:
    explicit ListDialogWidget (FWidget* parent = nullptr)
      : FDialog{parent}
    {
      initListView();
      populateListView();
      addTimer (1000);  // 1-second timer
    }

    void onTimer (finalcut::FTimerEvent*)
    {
      listview.stepForward();
      listview.redraw();
    }

  private:
    void initLayout()
    {
      setText ("Disassembly");
      setGeometry (FPoint{5, 5}, FSize{70, 20});
      listview.setGeometry(FPoint{2, 1}, FSize{66, 17});
      FDialog::initLayout();
    }

    void initListView()
    {
      listview.addColumn ("Address", 14);
      listview.addColumn ("Bytes", 11);
      listview.addColumn ("Instruction", 27);
      listview.addColumn ("Group", 25);
    }

    void populateListView()
    {
      struct Item
      {
        const char* address;
        const char* bytes;
        const char* instruction;
        const char* group;
      };

      auto data = std::initializer_list<Item> \
      {
        {"0x55555506f0:", "0xd8ffff97", "bl #0xf60", "Call, Jump, PC-Relative"},
        {"0x55555506f4:", "0x20008052", "mov w0, #1", ""},
        {"0x55555506f8:", "0x60c20039", "strb w0, [x19, #0x30]", ""},
        {"0x55555506fc:", "0xf3eb40f9", "ldr x19, [sp, #0x10]", ""},
        {"0x5555550700:", "0xfd7bc2a8", "ldp x29, x30, [sp], #0x20", ""},
        {"0x5555550704:", "0xc0035fd6", "ret", "Return"},
        {"0x5555550708:", "0x1f2003d5", "nop", ""},
        {"0x555555070c:", "0x1f2003d5", "nop", ""},
        {"0x5555550710:", "0xdcffff17", "b #0xf90", "Jump, PC-Relative Branch"},
        {"0x5555550714:", "0xff4300d1", "sub sp, sp, #0x10", ""},
        {"0x5555550718:", "0xff0f00b9", "str wzr, [sp, #0xc]", ""},
        {"0x555555071c:", "0x08809752", "mov w8, #0xbc00", ""},
        {"0x5555550720:", "0xe8170079", "strh w8, [sp, #0xa]", ""},
        {"0x5555550724:", "0xe017407d", "ldr h0, [sp, #0xa]", ""},
        {"0x5555550728:", "0x0040e21e", "fcvt s0, h0", "FP/AdvSIMD"}
      };

      for (auto data_line : data)
      {
        FStringList line ( &data_line.address
                         , &data_line.group + 1 );
        listview.insert(line);
      }
    }

    // Data members
    FListView listview{this};
};

int main (int argc, char* argv[])
{
  FApplication app(argc, argv);
  ListDialogWidget dialog(&app);
  FWidget::setMainWidget(&dialog);
  dialog.show();
  return app.exec();
}

[grrussel]

Yes, thank you!

That works nicely to set the highlight line

[gansm]

Perfect! I plan to publish a new commit in the next few days after I make some control methods in FListView public.

I'll update you here when it is ready.

[gansm]

With this commit (4ee0809), you can now call the methods firstPos(), lastPos(), stepForward(), stepBackward(), stepForward(int), and stepBackward(int) directly in FListView without making any changes to the header file.