gui_tree_grid_types.h

Go to the documentation of this file.

#pragma once
 
#include <gui_core/gui_id.h>
#include <gui_core/style/gui_style_text.h>          // IconID
 
#include <gui_controls/gui_widget_state_types.h>     // MultiSelectState, ItemDragDropConfig, DoubleClickTracker
 
#include <string>
#include <vector>
 
// TreeView / ListView / GridView data + construction state.
 
namespace tachyon
{
 
    // ---- Transient tree/list construction state (valid between Begin/End) ----
    //
    // Valid only between Begin*/End* (reset in End*). Event handlers run at end of frame,
    // so they must capture the user-owned pointers instead of reading m_treeState.
    //
    struct TreeViewState {
        tachyon::ID   containerID = tachyon::ID::Invalid();
        int       nextItemIndex = 0;
        int       totalItemCount = 0;
        int       depth = 0;                        
        int*      selectedIndex = nullptr;          
        tachyon::ID*  selectedID = nullptr;             
        MultiSelectState* multiSelect = nullptr;    
        ItemDragDropConfig* dragDrop = nullptr;     
    };
 
    // ---- GridView: icon grid ----
    //
    // Like TreeViewState: valid only between BeginGridView/EndGridView; handlers must
    // capture user-owned pointers.
    //
    struct GridViewState {
        tachyon::ID containerID = tachyon::ID::Invalid();
        int     nextItemIndex = 0;
        int*    selectedIndex = nullptr;
        MultiSelectState* multiSelect = nullptr;
        ItemDragDropConfig* dragDrop = nullptr;
        DoubleClickTracker* clickTracker = nullptr;
        tachyon::ID*            pendingRenameClick = nullptr;   
    };
 
    // ---- GridView rename lookup ----
    // Filled by GridViewItem for items with a renameBuffer; read by end-of-frame rename handlers.
    struct GridItemRenameInfo { std::string* renameBuf = nullptr; std::string renameSeed; };
 
    // ---- TreeView (flat-data, virtualized) -----------------------------
    // Caller-owned flat rows shown through a VirtualTable. Call RebuildTreeViewIndex after
    // structural changes. Selection, scroll and drag-drop live on the TableState; a row ID
    // maps to its flat index via visibleIdx[rowID.value.subRangeParts.index].
    struct TreeViewRow
    {
        tachyon::ID      id           = tachyon::ID::Invalid();
        std::string  name;                     
        int          depth        = 0;         
        bool         isOpen       = false;     
        IconID       icon         = IconID::Invalid;
        std::string* renameBuffer = nullptr;   
 
        // Derived by RebuildTreeViewIndex

        int          skipCount        = 0;
        uint32_t     ancestorLineMask = 0;
        bool         isLastSibling    = true;  
 
        bool HasChildren() const { return skipCount > 0; }
    };
 
    // ---- Virtualized GridView ----
    //
    // Like BeginGridView, but only visible rows are emitted. Column count and visible rows
    // come from last frame's viewport (one-frame settle on first show / resize).
    struct GridViewVirtualState
    {
        int32_t lastViewportW = 0;   
        int32_t lastViewportH = 0;   
        int32_t cellStretchedW = 0;

        struct Internal
        {
            // Slow-re-click rename state
            DoubleClickTracker itemClickTracker;
            tachyon::ID     pendingRenameClick = tachyon::ID::Invalid();
            tachyon::ID     itemsRangeID       = tachyon::ID::Invalid();
            // Layout for keyboard navigation, which runs after layout
            int32_t            cols      = 1;
            int32_t            rowStride = 1;
            int32_t            cellH     = 1;
        } internal;  
    };

}