kicad/common/dialogs/eda_reorderable_list_dialog.cpp

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2022 KiCad Developers, see AUTHORS.txt for contributors.
 *
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the
 * Free Software Foundation, either version 3 of the License, or (at your
 * option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#include <algorithm>
#include <bitmaps.h>
#include <string_utils.h>
#include <dialogs/eda_reorderable_list_dialog.h>


static int DEFAULT_SINGLE_COL_WIDTH = 260;


EDA_REORDERABLE_LIST_DIALOG::EDA_REORDERABLE_LIST_DIALOG( wxWindow* aParent, const wxString& aTitle,
                                                          const std::vector<wxString>& aAllItems,
                                                          const std::vector<wxString>& aEnabledItems ) :
        EDA_REORDERABLE_LIST_DIALOG_BASE( aParent, wxID_ANY, aTitle ),
        m_availableItems( aAllItems ),
        m_enabledItems( aEnabledItems ),
        m_selectedAvailable( 0 ),
        m_selectedEnabled( 0 )
{
    m_btnUp->SetBitmap( KiBitmap( BITMAPS::small_up ) );
    m_btnDown->SetBitmap( KiBitmap( BITMAPS::small_down ) );

    // DIALOG_SHIM needs a unique hash_key because classname is not sufficient
    // because so many dialogs share this same class, with different numbers of
    // columns, different column names, and column widths.
    m_hash_key = TO_UTF8( aTitle );

    m_availableListBox->InsertColumn( 0, wxEmptyString, wxLIST_FORMAT_LEFT,
                                      DEFAULT_SINGLE_COL_WIDTH );
    m_enabledListBox->InsertColumn( 0, wxEmptyString, wxLIST_FORMAT_LEFT,
                                    DEFAULT_SINGLE_COL_WIDTH );

    updateItems();

    SetupStandardButtons();

    // this line fixes an issue on Linux Ubuntu using Unity (dialog not shown),
    // and works fine on all systems
    GetSizer()->Fit(  this );

    Centre();
}


void EDA_REORDERABLE_LIST_DIALOG::updateItems()
{
    m_availableListBox->DeleteAllItems();
    m_enabledListBox->DeleteAllItems();

    std::set<wxString> enabledSet;

    for( size_t idx = 0; idx < m_enabledItems.size(); ++idx )
    {
        wxListItem info;
        info.m_itemId = idx;
        info.m_col    = 0;
        info.m_text   = m_enabledItems[idx];
        info.m_width  = DEFAULT_SINGLE_COL_WIDTH;
        info.m_mask   = wxLIST_MASK_TEXT | wxLIST_MASK_WIDTH;

        m_enabledListBox->InsertItem( info );

        if( m_selectedEnabled == static_cast<long>( idx ) )
            m_enabledListBox->SetItemState( idx, wxLIST_STATE_SELECTED, wxLIST_STATE_SELECTED );

        enabledSet.insert( m_enabledItems[idx] );
    }

    m_availableItems.erase( std::remove_if( m_availableItems.begin(), m_availableItems.end(),
                                            [&]( const wxString& aItem ) -> bool
                                            {
                                                return enabledSet.count( aItem );
                                            } ),
                            m_availableItems.end() );

    for( size_t idx = 0; idx < m_availableItems.size(); ++idx )
    {
        wxListItem info;
        info.m_itemId = idx;
        info.m_col    = 0;
        info.m_text   = m_availableItems[idx];
        info.m_width  = DEFAULT_SINGLE_COL_WIDTH;
        info.m_mask   = wxLIST_MASK_TEXT | wxLIST_MASK_WIDTH;

        m_availableListBox->InsertItem( info );

        if( m_selectedAvailable == static_cast<long>( idx ) )
            m_availableListBox->SetItemState( idx, wxLIST_STATE_SELECTED, wxLIST_STATE_SELECTED );
    }

    if( !m_availableItems.empty() )
        m_availableListBox->EnsureVisible( m_selectedAvailable );

    if( !m_enabledItems.empty() )
        m_enabledListBox->EnsureVisible( m_selectedEnabled );

    m_btnAdd->Enable( !m_availableItems.empty() );
    m_btnRemove->Enable( !m_enabledItems.empty() );
}


void EDA_REORDERABLE_LIST_DIALOG::onAddItem( wxCommandEvent& aEvent )
{
    wxListItem info;

    if( !getSelectedItem( m_availableListBox, info ) )
        return;

    m_availableItems.erase( m_availableItems.begin() + info.m_itemId );
    m_availableListBox->DeleteItem( m_selectedAvailable );

    long pos = std::min( m_selectedEnabled + 1, static_cast<long>( m_enabledItems.size() ) );

    info.m_itemId = pos;
    info.m_mask   = wxLIST_MASK_TEXT;

    m_enabledItems.insert( m_enabledItems.begin() + pos, info.m_text );
    m_enabledListBox->InsertItem( info );

    updateButtons();
}


void EDA_REORDERABLE_LIST_DIALOG::onRemoveItem( wxCommandEvent& aEvent )
{
    wxListItem info;

    if( !getSelectedItem( m_enabledListBox, info ) || info.m_itemId == 0 )
        return;

    m_enabledItems.erase( m_enabledItems.begin() + info.m_itemId );
    m_enabledListBox->DeleteItem( m_selectedEnabled );

    m_selectedEnabled = std::min( m_selectedEnabled,
                                  static_cast<long>( m_enabledItems.size() - 1 ) );

    m_enabledListBox->SetItemState( m_selectedEnabled, wxLIST_STATE_SELECTED,
                                    wxLIST_STATE_SELECTED );

    long pos = std::max( long( 0 ), m_selectedAvailable );
    info.m_itemId = pos;

    m_availableItems.insert( m_availableItems.begin() + pos, info.m_text );
    m_availableListBox->InsertItem( info );

    updateButtons();
}


void EDA_REORDERABLE_LIST_DIALOG::onMoveUp( wxCommandEvent& aEvent )
{
    wxListItem info;

    if( !getSelectedItem( m_enabledListBox, info ) || info.m_itemId == 0 )
        return;

    auto current = m_enabledItems.begin() + info.m_itemId;
    auto prev    = m_enabledItems.begin() + info.m_itemId - 1;

    std::iter_swap( current, prev );

    m_selectedEnabled--;

    updateButtons();
    updateItems();
}


void EDA_REORDERABLE_LIST_DIALOG::onMoveDown( wxCommandEvent& aEvent )
{
    wxListItem info;

    if( !getSelectedItem( m_enabledListBox, info )
        || info.m_itemId == static_cast<long>( m_enabledItems.size() ) - 1 )
    {
        return;
    }

    auto current = m_enabledItems.begin() + info.m_itemId;
    auto prev    = m_enabledItems.begin() + info.m_itemId + 1;

    std::iter_swap( current, prev );

    m_selectedEnabled++;

    updateButtons();
    updateItems();
}


bool EDA_REORDERABLE_LIST_DIALOG::getSelectedItem( wxListCtrl* aList, wxListItem& aInfo )
{
    long item = aList->GetNextItem( -1, wxLIST_NEXT_ALL, wxLIST_STATE_SELECTED );

    if( item < 0 )
        return false;

    aInfo.m_mask   = wxLIST_MASK_DATA | wxLIST_MASK_STATE | wxLIST_MASK_TEXT;
    aInfo.m_itemId = item;
    aInfo.m_col    = 0;

    if( !aList->GetItem( aInfo ) )
        return false;

    return true;
}


void EDA_REORDERABLE_LIST_DIALOG::onEnabledListItemSelected( wxListEvent& event )
{
    wxListItem info;

    if( !getSelectedItem( m_enabledListBox, info ) )
    {
        m_selectedEnabled = -1;
        return;
    }

    m_selectedEnabled = info.m_itemId;
    updateButtons();
}


void EDA_REORDERABLE_LIST_DIALOG::onAvailableListItemSelected( wxListEvent& event )
{
    wxListItem info;

    if( !getSelectedItem( m_availableListBox, info ) )
    {
        m_selectedAvailable = -1;
        return;
    }

    m_selectedAvailable = info.m_itemId;
    updateButtons();
}


void EDA_REORDERABLE_LIST_DIALOG::updateButtons()
{
    m_btnUp->Enable( !m_enabledItems.empty() && m_selectedEnabled > 0 );
    m_btnDown->Enable( !m_enabledItems.empty() && m_selectedEnabled > 0 &&
                       m_selectedEnabled < static_cast<int>( m_enabledItems.size() ) - 1 );
    m_btnAdd->Enable( !m_availableItems.empty() && m_selectedAvailable >= 0 );
    m_btnRemove->Enable( !m_enabledItems.empty() && m_selectedEnabled > 0 );
}