properties_panel.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KICAD, a free EDA CAD application.
 *
 * Copyright (C) 2020-2023 CERN
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 * @author Maciej Suminski <[email protected]>
 *
 * 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 <https://www.gnu.org/licenses/>.
 */
 
#include "properties_panel.h"
#include <bitmaps.h>
#include <tool/selection.h>
#include <eda_base_frame.h>
#include <eda_item.h>
#include <i18n_utility.h>
#include <import_export.h>
#include <pgm_base.h>
#include <properties/pg_cell_renderer.h>
#include <properties/property.h>
#include <properties/property_mgr.h>
#include <widgets/bitmap_button.h>
 
#include <algorithm>
#include <iterator>
#include <set>
 
#include <wx/clipbrd.h>
#include <wx/dataobj.h>
#include <wx/settings.h>
#include <wx/stattext.h>
#include <wx/propgrid/advprops.h>
#include <wx/menu.h>
#include <wx/utils.h>
 
 
// This is provided by wx >3.3.0
#if !wxCHECK_VERSION( 3, 3, 0 )
extern APIIMPORT wxPGGlobalVarsClass* wxPGGlobalVars;
#endif
 
 
class PROPERTIES_PANEL_GRID : public wxPropertyGrid
{
public:
    PROPERTIES_PANEL_GRID( wxWindow* aParent ) :
            wxPropertyGrid( aParent, wxID_ANY, wxDefaultPosition, wxDefaultSize, wxPG_DEFAULT_STYLE | wxPG_TOOLTIPS )
    {
    }
 
    void ScrollWindow( int aDx, int aDy, const wxRect* aRect = nullptr ) override
    {
        wxPropertyGrid::ScrollWindow( aDx, aDy, aRect );
 
        if( PROPERTIES_PANEL* panel = static_cast<PROPERTIES_PANEL*>( GetParent() ) )
            panel->positionCategoryButtons();
    }

    bool IsProcessingWxPGEvent() const { return m_processedEvent != nullptr; }
 
#if wxUSE_STATUSBAR
    wxStatusBar* GetStatusBar() override { return nullptr; }
#endif
};
 
 
PROPERTIES_PANEL::PROPERTIES_PANEL( wxWindow* aParent, EDA_BASE_FRAME* aFrame ) :
        wxPanel( aParent ),
        m_SuppressGridChangeEvents( 0 ),
        m_frame( aFrame ),
        m_splitter_key_proportion( -1 )
{
    wxBoxSizer* mainSizer = new wxBoxSizer( wxVERTICAL );
 
#if !wxCHECK_VERSION( 3, 3, 0 )
    // on some platforms wxPGGlobalVars is initialized automatically,
    // but others need an explicit init
    if( !wxPGGlobalVars )
        wxPGInitResourceModule();
#endif
 
    // See https://gitlab.com/kicad/code/kicad/-/issues/12297
    // and https://github.com/wxWidgets/wxWidgets/issues/11787
    if( wxPGGlobalVars->m_mapEditorClasses.empty() )
    {
        wxPGEditor_TextCtrl = nullptr;
        wxPGEditor_Choice = nullptr;
        wxPGEditor_ComboBox = nullptr;
        wxPGEditor_TextCtrlAndButton = nullptr;
        wxPGEditor_CheckBox = nullptr;
        wxPGEditor_ChoiceAndButton = nullptr;
        wxPGEditor_SpinCtrl = nullptr;
        wxPGEditor_DatePickerCtrl = nullptr;
    }
 
    if( !Pgm().m_PropertyGridInitialized )
    {
        delete wxPGGlobalVars->m_defaultRenderer;
        wxPGGlobalVars->m_defaultRenderer = new PG_CELL_RENDERER();
        Pgm().m_PropertyGridInitialized = true;
    }
 
    m_caption = new wxStaticText( this, wxID_ANY, _( "No objects selected" ) );
    mainSizer->Add( m_caption, 0, wxALL | wxEXPAND, 5 );
 
    m_grid = new PROPERTIES_PANEL_GRID( this );
    m_grid->SetUnspecifiedValueAppearance( wxPGCell( wxT( "<...>" ) ) );
 
#if wxCHECK_VERSION( 3, 3, 0 )
    m_grid->SetValidationFailureBehavior( wxPGVFBFlags::MarkCell );
#else
    m_grid->SetValidationFailureBehavior( wxPG_VFB_MARK_CELL );
#endif
 
#if wxCHECK_VERSION( 3, 3, 0 )
    m_grid->AddActionTrigger( wxPGKeyboardAction::NextProperty, WXK_RETURN );
    m_grid->AddActionTrigger( wxPGKeyboardAction::NextProperty, WXK_NUMPAD_ENTER );
    m_grid->AddActionTrigger( wxPGKeyboardAction::NextProperty, WXK_DOWN );
    m_grid->AddActionTrigger( wxPGKeyboardAction::PrevProperty, WXK_UP );
    m_grid->AddActionTrigger( wxPGKeyboardAction::Edit, WXK_SPACE );
#else
    m_grid->AddActionTrigger( wxPG_ACTION_NEXT_PROPERTY, WXK_RETURN );
    m_grid->AddActionTrigger( wxPG_ACTION_NEXT_PROPERTY, WXK_NUMPAD_ENTER );
    m_grid->AddActionTrigger( wxPG_ACTION_NEXT_PROPERTY, WXK_DOWN );
    m_grid->AddActionTrigger( wxPG_ACTION_PREV_PROPERTY, WXK_UP );
    m_grid->AddActionTrigger( wxPG_ACTION_EDIT, WXK_SPACE );
#endif
 
    m_grid->DedicateKey( WXK_RETURN );
    m_grid->DedicateKey( WXK_NUMPAD_ENTER );
    m_grid->DedicateKey( WXK_DOWN );
    m_grid->DedicateKey( WXK_UP );
    mainSizer->Add( m_grid, 1, wxEXPAND, 5 );
 
    m_grid->SetCellDisabledTextColour( wxSystemSettings::GetColour( wxSYS_COLOUR_GRAYTEXT ) );
 
#ifdef __WXGTK__
    // Needed for dark mode, on wx 3.0 at least.
    m_grid->SetCaptionTextColour( wxSystemSettings::GetColour( wxSYS_COLOUR_CAPTIONTEXT ) );
#endif
 
    SetFont( KIUI::GetDockedPaneFont( this ) );
 
    SetSizer( mainSizer );
    Layout();
 
    m_grid->CenterSplitter();
 
    // Actual edits are allowed or vetoed per-property based on whether or not it's
    // something where the label/key should be editable (user fields, custom properties, ...)
    m_grid->MakeColumnEditable( 0 );
 
    Bind( wxEVT_PG_ITEM_EXPANDED,
          [&]( wxPropertyGridEvent& )
          {
              positionCategoryButtons();
          } );
 
    Bind( wxEVT_PG_ITEM_COLLAPSED,
          [&]( wxPropertyGridEvent& )
          {
              positionCategoryButtons();
          } );
 
    Bind( wxEVT_PG_LABEL_EDIT_BEGIN, &PROPERTIES_PANEL::onLabelEditBegin, this );
    Bind( wxEVT_PG_LABEL_EDIT_ENDING, &PROPERTIES_PANEL::onLabelEditEnding, this );
    Bind( wxEVT_PG_RIGHT_CLICK, &PROPERTIES_PANEL::onRightClick, this );
 
    Connect( wxEVT_CHAR_HOOK, wxKeyEventHandler( PROPERTIES_PANEL::onCharHook ), nullptr, this );
    Connect( wxEVT_PG_CHANGED, wxPropertyGridEventHandler( PROPERTIES_PANEL::valueChanged ), nullptr, this );
    Connect( wxEVT_PG_CHANGING, wxPropertyGridEventHandler( PROPERTIES_PANEL::valueChanging ), nullptr, this );
    Connect( wxEVT_SHOW, wxShowEventHandler( PROPERTIES_PANEL::onShow ), nullptr, this );
 
    Bind( wxEVT_PG_COL_END_DRAG,
          [&]( wxPropertyGridEvent& )
          {
              m_splitter_key_proportion = static_cast<float>( m_grid->GetSplitterPosition() ) / m_grid->GetSize().x;
              positionCategoryButtons();
          } );
 
    Bind( wxEVT_SIZE,
          [&]( wxSizeEvent& aEvent )
          {
              CallAfter( [this]()
                         {
                            RecalculateSplitterPos();
                            positionCategoryButtons();
                         } );
              aEvent.Skip();
          } );
 
    m_frame->Bind( EDA_LANG_CHANGED, &PROPERTIES_PANEL::OnLanguageChanged, this );
}
 
 
PROPERTIES_PANEL::~PROPERTIES_PANEL()
{
    m_frame->Unbind( EDA_LANG_CHANGED, &PROPERTIES_PANEL::OnLanguageChanged, this );
}
 
 
void PROPERTIES_PANEL::OnLanguageChanged( wxCommandEvent& aEvent )
{
    if( m_grid->IsEditorFocused() )
        m_grid->CommitChangesFromEditor();
 
    m_grid->Clear();
    m_displayed.clear();    // no ownership of pointers
 
    UpdateData();
 
    aEvent.Skip();
}
 
 
SUPPRESS_GRID_CHANGED_EVENTS::SUPPRESS_GRID_CHANGED_EVENTS( PROPERTIES_PANEL* aPanel ) :
            m_panel( aPanel )
{
    m_panel->m_SuppressGridChangeEvents++;
}
 
 
SUPPRESS_GRID_CHANGED_EVENTS::~SUPPRESS_GRID_CHANGED_EVENTS()
{
    m_panel->m_SuppressGridChangeEvents--;
}
 
 
void PROPERTIES_PANEL::rebuildProperties( const SELECTION& aSelection )
{
    SUPPRESS_GRID_CHANGED_EVENTS raii( this );
 
    // wxPG defers property deletion while one of its events is being processed
    // (m_processedEvent != nullptr), and wxPropertyGridPageState::DoClear() then
    // leaves the old rows in place; re-appending the new set on top of them
    // duplicates every row.  This happens when e.g. the context menu (opened from
    // a grid right-click) removes a property.  Re-run once the event has unwound.
    if( static_cast<PROPERTIES_PANEL_GRID*>( m_grid )->IsProcessingWxPGEvent() )
    {
        hideCategoryButtons();
        CallAfter( [this, aSelection]()
                   {
                       rebuildProperties( aSelection );
                   } );
        return;
    }
 
    auto reset =
            [&]()
            {
                if( m_grid->IsEditorFocused() )
                    m_grid->CommitChangesFromEditor();
 
                m_grid->Clear();
                m_displayed.clear();
            };
 
    if( aSelection.Empty() )
    {
        m_caption->SetLabel( _( "No objects selected" ) );
        hideCategoryButtons();
        reset();
        return;
    }
    else if( aSelection.Size() == 1 )
    {
        m_caption->SetLabel( aSelection.Front()->GetFriendlyName() );
    }
    else
    {
        m_caption->SetLabel( wxString::Format( _( "%d objects selected" ), aSelection.Size() ) );
    }
 
    // Get all the selected types
    std::set<TYPE_ID> types;
 
    for( EDA_ITEM* item : aSelection )
        types.insert( TYPE_HASH( *item ) );
 
    wxCHECK( !types.empty(), /* void */ );  // already guarded above, but Coverity doesn't know that
 
    PROPERTY_MANAGER&                  propMgr = PROPERTY_MANAGER::Instance();
    std::map<wxString, PROPERTY_BASE*> commonProps;
    const std::vector<PROPERTY_BASE*>& allProperties = propMgr.GetProperties( *types.begin() );
 
    for( PROPERTY_BASE* property : allProperties )
        commonProps.emplace( property->Name(), property );
 
    std::map<wxString, int> displayOrder;
    for( const auto& entry : propMgr.GetDisplayOrder( *types.begin() ) )
        displayOrder.emplace( entry.first->Name(), entry.second );
 
    std::vector<wxString> groupDisplayOrder = propMgr.GetGroupDisplayOrder( *types.begin() );
    std::set<wxString>    groups( groupDisplayOrder.begin(), groupDisplayOrder.end() );
 
    // Get all possible properties
    for( auto itType = std::next( types.begin() ); itType != types.end(); ++itType )
    {
        TYPE_ID type = *itType;
 
        for( const wxString& group : propMgr.GetGroupDisplayOrder( type ) )
        {
            if( !groups.count( group ) )
            {
                groupDisplayOrder.emplace_back( group );
                groups.insert( group );
            }
        }
 
        for( auto it = commonProps.begin(); it != commonProps.end(); )
        {
            if( PROPERTY_BASE* prop = propMgr.GetProperty( type, it->first ) )
            {
                // A dummy property won't have the enum values, etc., so replace them with a "real" property
                if( it->second->IgnoreValue() )
                    it->second = prop;
 
                ++it;
            }
            else
            {
                it = commonProps.erase( it );
            }
        }
    }
 
    for( const EDA_ITEM* item : aSelection )
    {
        for( PROPERTY_BASE* prop : item->GetDynamicProperties() )
        {
            bool commonToAll = true;
 
            for( const EDA_ITEM* other : aSelection )
            {
                std::vector<PROPERTY_BASE*> otherProps = other->GetDynamicProperties();
 
                if( std::ranges::none_of( otherProps,
                                          [&]( PROPERTY_BASE* p )
                                          {
                                              return p->Name() == prop->Name();
                                          } ) )
                {
                    commonToAll = false;
                    break;
                }
            }
 
            if( !commonToAll || commonProps.contains( prop->Name() ) )
                continue;
 
            commonProps.emplace( prop->Name(), prop );
 
            auto maxOrderIt = std::ranges::max_element( displayOrder,
                                                        []( const auto& aL, const auto& aR )
                                                        {
                                                            return aL.second < aR.second;
                                                        } );
            int  nextOrder = maxOrderIt == displayOrder.end() ? 0 : maxOrderIt->second + 1;
            displayOrder.emplace( prop->Name(), nextOrder );
 
            if( const wxString& dynGroup = prop->Group(); !dynGroup.IsEmpty() && !groups.contains( dynGroup ) )
            {
                groupDisplayOrder.emplace_back( dynGroup );
                groups.insert( dynGroup );
            }
        }
    }
 
    // Always show the Custom Properties group, even when it has no members, because it has the
    // clearest path to add a custom property (the custom "+" button)
    if( !groups.contains( _HKI( "Custom Properties" ) ) )
    {
        groupDisplayOrder.emplace_back( _HKI( "Custom Properties" ) );
        groups.insert( _HKI( "Custom Properties" ) );
    }
 
    // Show category groups that have an action button if they are forced
    // (e.g. we show "add custom property" even when no custom properties exist)
    for( const CATEGORY_BUTTON& entry : m_categoryButtons )
    {
        if( !entry.forceCategory || groups.contains( entry.groupKey ) )
            continue;
 
        if( entry.enableFunc && !entry.enableFunc() )
            continue;
 
        groupDisplayOrder.emplace_back( entry.groupKey );
        groups.insert( entry.groupKey );
    }
 
    bool isLibraryEditor = m_frame->IsType( FRAME_FOOTPRINT_EDITOR )
                        || m_frame->IsType( FRAME_SCH_SYMBOL_EDITOR );
 
    bool isDesignEditor = m_frame->IsType( FRAME_PCB_EDITOR )
                       || m_frame->IsType( FRAME_SCH );
 
    std::set<wxString> availableProps;
 
    // Find a set of properties that is common to all selected items
    for( auto& [name, property] : commonProps )
    {
        if( property->IsHiddenFromPropertiesManager() )
            continue;
 
        if( isLibraryEditor && property->IsHiddenFromLibraryEditors() )
            continue;
 
        if( isDesignEditor && property->IsHiddenFromDesignEditors() )
            continue;
 
        wxVariant   dummy;
        wxPGChoices choices;
        bool        writable;
 
        if( extractValueAndWritability( aSelection, name, dummy, writable, choices ) )
            availableProps.insert( name );
    }
 
    bool               writeable = true;
    std::set<wxString> existingProps;
 
    for( wxPropertyGridIterator it = m_grid->GetIterator(); !it.AtEnd(); it.Next() )
    {
        wxPGProperty* pgProp = it.GetProperty();
        wxString      name   = pgProp->GetName();
 
        // Store the existing name before checking available properties so we can
        // remove the properties when they are no longer available
        existingProps.insert( name );
 
        if( !availableProps.count( name ) )
            continue;
 
        wxVariant   commonVal;
        wxPGChoices choices;
 
        extractValueAndWritability( aSelection, name, commonVal, writeable, choices );
 
        if( choices.GetCount() > 0 )
            pgProp->SetChoices( choices );
 
        pgProp->SetValue( commonVal );
        pgProp->ChangeFlag( wxPG_PROP_READONLY, !writeable );
    }
 
    if( !existingProps.empty() && existingProps == availableProps )
        return;
 
    // Some difference exists:  start from scratch
    reset();
 
    std::map<wxPGProperty*, int>                   pgPropOrders;
    std::map<wxString, std::vector<wxPGProperty*>> pgPropGroups;
 
    for( const wxString& name : availableProps )
    {
        PROPERTY_BASE* property = commonProps[name];
        wxPGProperty*  pgProp   = createPGProperty( property );
        wxVariant      commonVal;
        wxPGChoices    choices;
 
        if( !extractValueAndWritability( aSelection, name, commonVal, writeable, choices ) )
            continue;
 
        if( pgProp )
        {
            if( choices.GetCount() )
                pgProp->SetChoices( choices );
 
            pgProp->SetValue( commonVal );
            pgProp->ChangeFlag( wxPG_PROP_READONLY, !writeable );
            m_displayed.push_back( property );
 
            wxASSERT( displayOrder.count( name ) );
            pgPropOrders[pgProp] = displayOrder[name];
            pgPropGroups[property->Group()].emplace_back( pgProp );
        }
    }
 
    const wxString unspecifiedGroupCaption = _( "Basic Properties" );
 
    for( const wxString& groupName : groupDisplayOrder )
    {
        if( groupName != _HKI( "Custom Properties" ) && !pgPropGroups.contains( groupName ) )
            continue;
 
        std::vector<wxPGProperty*> properties;
 
        if( pgPropGroups.contains( groupName ) )
            properties = pgPropGroups[groupName];
 
        wxString groupCaption = wxGetTranslation( groupName );
 
        auto groupItem = new wxPropertyCategory( groupName.IsEmpty() ? unspecifiedGroupCaption
                                                                     : groupCaption );
 
        m_grid->Append( groupItem );
 
        std::sort( properties.begin(), properties.end(),
                   [&]( wxPGProperty*& aFirst, wxPGProperty*& aSecond )
                   {
                       return pgPropOrders[aFirst] < pgPropOrders[aSecond];
                   } );
 
        for( wxPGProperty* property : properties )
            m_grid->Append( property );
    }
 
    RecalculateSplitterPos();
    updateCategoryButtons();
}
 
 
bool PROPERTIES_PANEL::getItemValue( EDA_ITEM* aItem, PROPERTY_BASE* aProperty, wxVariant& aValue )
{
    const wxAny& any = aItem->Get( aProperty );
    bool converted = false;
 
    if( aProperty->HasChoices() )
    {
        // handle enums as ints, since there are no default conversion functions for wxAny
        int tmp;
        converted = any.GetAs<int>( &tmp );
 
        if( converted )
            aValue = wxVariant( tmp );
    }
 
    if( !converted )                // all other types
        converted = any.GetAs( &aValue );
 
    if( !converted )
    {
        wxString propName = aProperty->Name();
        propName.Replace( ' ', '_' );
        wxFAIL_MSG( wxString::Format( wxS( "Could not convert wxAny to wxVariant for %s::%s" ),
                                      aItem->GetClass(),
                                      propName ) );
    }
 
    return converted;
}
 
 
bool PROPERTIES_PANEL::extractValueAndWritability( const SELECTION& aSelection, const wxString& aPropName,
                                                   wxVariant& aValue, bool& aWritable, wxPGChoices& aChoices )
{
    PROPERTY_MANAGER& propMgr = PROPERTY_MANAGER::Instance();
    bool              different = false;
    bool              first = true;
 
    aWritable = true;
 
    for( EDA_ITEM* item : aSelection )
    {
        PROPERTY_BASE* property = propMgr.GetProperty( item, aPropName );
 
        if( !property )
            return false;
 
        if( !propMgr.IsAvailableFor( TYPE_HASH( *item ), property, item ) )
            return false;
 
        if( property->IsHiddenFromPropertiesManager() )
            return false;
 
        wxPGChoices choices = property->GetChoices( item );
 
        if( first )
        {
            aChoices = choices;
            first = false;
        }
        else
        {
            wxArrayString labels = choices.GetLabels();
            wxArrayInt    values = choices.GetValuesForStrings( labels );
 
            if( labels != aChoices.GetLabels() || values != aChoices.GetValuesForStrings( labels ) )
                return false;
        }
 
        // If read-only for any of the selection, read-only for the whole selection.
        if( !propMgr.IsWriteableFor( TYPE_HASH( *item ), property, item ) )
            aWritable = false;
 
        wxVariant value;
 
        if( getItemValue( item, property, value ) )
        {
            if( property->IgnoreValue() )
                continue;
 
            // Null value indicates different property values between items
            if( !different && !aValue.IsNull() && value != aValue )
            {
                different = true;
                aValue.MakeNull();
            }
            else if( !different )
            {
                aValue = value;
            }
        }
        else
        {
            // getItemValue returned false -- not available for this item
            return false;
        }
    }
 
    return true;
}
 
 
void PROPERTIES_PANEL::onShow( wxShowEvent& aEvent )
{
    if( aEvent.IsShown() )
        UpdateData();
 
    aEvent.Skip();
}
 
 
void PROPERTIES_PANEL::onLabelEditBegin( wxPropertyGridEvent& aEvent )
{
    wxPGProperty* pgProp = aEvent.GetProperty();
 
    if( !pgProp || !isKeyEditable( pgProp ) )
    {
        aEvent.Veto();
        return;
    }
 
    // Remember the original label so an invalid rename can be undone.
    m_editingOriginalLabel = pgProp->GetLabel();
}
 
 
void PROPERTIES_PANEL::onLabelEditEnding( wxPropertyGridEvent& aEvent )
{
    wxPGProperty* pgProp = aEvent.GetProperty();
 
    if( !pgProp || !isKeyEditable( pgProp ) )
        return;
 
    const wxString oldName = pgProp->GetBaseName();
 
    wxTextCtrl* labelEditor = m_grid->GetLabelEditor();
    wxString    newName;
 
    if( labelEditor )
        newName = labelEditor->GetValue();
 
    if( !m_pendingNewKey.IsEmpty() && oldName == m_pendingNewKey )
    {
        const wxString pendingKey = m_pendingNewKey;
 
        m_pendingNewKey.Clear();
 
        if( m_resolvingPendingKey )
        {
            if( newName.IsEmpty() || isKeyNameInUse( newName ) )
                onNewItemLeftBlank( pendingKey );
            else
                onKeyRenamed( oldName, newName );
        }
        else if( newName.IsEmpty() || isKeyNameInUse( newName ) )
        {
            CallAfter(
                    [this, pendingKey]()
                    {
                        onNewItemLeftBlank( pendingKey );
                    } );
        }
        else
        {
            CallAfter(
                    [this, oldName, newName]()
                    {
                        onKeyRenamed( oldName, newName );
                    } );
        }
 
        return;
    }
 
    if( newName == oldName )
        return;
 
    if( newName.IsEmpty() || isKeyNameInUse( newName ) )
    {
        const wxString originalLabel = m_editingOriginalLabel;
 
        CallAfter(
                [this, oldName, originalLabel, newName]()
                {
                    for( wxPropertyGridIterator it = m_grid->GetIterator(); !it.AtEnd(); it.Next() )
                    {
                        wxPGProperty* p = it.GetProperty();
 
                        if( p->GetBaseName() == oldName && p->GetLabel() == newName )
                        {
                            p->SetLabel( originalLabel );
                            m_grid->Refresh();
                            break;
                        }
                    }
                } );
 
        return;
    }
 
    CallAfter(
            [this, oldName, newName]()
            {
                onKeyRenamed( oldName, newName );
            } );
}
 
 
void PROPERTIES_PANEL::onRightClick( wxPropertyGridEvent& aEvent )
{
    wxPGProperty* pgProp = aEvent.GetProperty();
 
    if( !pgProp )
        return;
 
    m_contextMenuPropertyName = pgProp->GetBaseName();
 
    wxMenu* menu = new wxMenu;
 
    if( !buildContextMenu( *menu, pgProp ) )
    {
        delete menu;
        return;
    }
 
    // Defer showing the menu until the property event has finished
    const wxPoint pos = ScreenToClient( wxGetMousePosition() );
    CallAfter( [this, menu, pos]()
               {
                   PopupMenu( menu, pos );
                   delete menu;
               } );
}
 
 
void PROPERTIES_PANEL::settlePendingLabelEdit()
{
    if( !m_grid->GetLabelEditor() )
    {
        m_pendingNewKey.Clear();
        return;
    }
 
    const wxString newName = m_grid->GetLabelEditor()->GetValue();
    const wxString pendingKey = m_pendingNewKey;
 
    m_resolvingPendingKey = true;
    m_grid->EndLabelEdit( true );
    m_resolvingPendingKey = false;
 
    if( pendingKey.IsEmpty() )
        return;
 
    if( newName.IsEmpty() || isKeyNameInUse( newName ) )
        onNewItemLeftBlank( pendingKey );
    else if( newName != pendingKey )
        onKeyRenamed( pendingKey, newName );
}
 
 
void PROPERTIES_PANEL::beginLabelEdit( const wxString& aKey, bool aStartBlank )
{
    for( wxPropertyGridIterator it = m_grid->GetIterator(); !it.AtEnd(); it.Next() )
    {
        wxPGProperty* p = it.GetProperty();
 
        if( !p->IsCategory() && p->GetBaseName() == aKey )
        {
            m_grid->SelectProperty( p );
            m_grid->BeginLabelEdit( 0 );
 
            if( aStartBlank && m_grid->GetLabelEditor() )
                m_grid->GetLabelEditor()->SetValue( wxEmptyString );
 
            break;
        }
    }
}
 
 
 
 
void PROPERTIES_PANEL::onCharHook( wxKeyEvent& aEvent )
{
    if( aEvent.GetKeyCode() == WXK_TAB
        && ( aEvent.GetModifiers() == wxMOD_NONE || aEvent.GetModifiers() == wxMOD_SHIFT ) )
    {
        // wxPropertyGrid hard-codes Tab to focus the current editor and then navigate out of
        // the grid, so it never steps between properties.  Intercept Tab here to commit any
        // pending edit and move selection to the next (or previous, with Shift) editable
        // property, wrapping around at the ends.
        m_grid->CommitChangesFromEditor();
 
        const bool forward = !aEvent.ShiftDown();
 
        auto isTabStop =
                []( wxPGProperty* aProp )
                {
                    return aProp && !aProp->IsCategory() && aProp->IsVisible() && aProp->IsEnabled()
                           && !aProp->HasFlag( wxPG_PROP_READONLY ) && aProp->GetEditorClass();
                };
 
        auto findTarget =
                [&]( wxPropertyGridIterator aIt )
                {
                    while( !aIt.AtEnd() )
                    {
                        if( isTabStop( aIt.GetProperty() ) )
                            return aIt.GetProperty();
 
                        if( forward )
                            aIt.Next();
                        else
                            aIt.Prev();
                    }
 
                    return static_cast<wxPGProperty*>( nullptr );
                };
 
        wxPGProperty* current = m_grid->GetSelectedProperty();
        wxPGProperty* target = nullptr;
 
        if( current )
        {
            wxPropertyGridIterator it = m_grid->GetIterator( wxPG_ITERATE_VISIBLE, current );
 
            if( forward )
                it.Next();
            else
                it.Prev();
 
            target = findTarget( it );
        }
 
        // Wrap around (or pick a starting property if nothing is selected)
        if( !target )
        {
            wxPropertyGridIterator it = m_grid->GetIterator( wxPG_ITERATE_VISIBLE,
                                                             forward ? wxTOP : wxBOTTOM );
            target = findTarget( it );
        }
 
        if( target )
            m_grid->SelectProperty( target, true );
        else
            aEvent.Skip();
 
        return;
    }
 
    if( aEvent.GetKeyCode() == 'C' && aEvent.GetModifiers() == wxMOD_CONTROL )
    {
        if( wxPGProperty* prop = m_grid->GetSelectedProperty() )
        {
            if( wxTheClipboard->Open() )
            {
                wxTheClipboard->SetData( new wxTextDataObject( prop->GetValueAsString() ) );
                wxTheClipboard->Close();
                return;
            }
        }
    }
 
    if( aEvent.GetKeyCode() == WXK_SPACE )
    {
        if( wxPGProperty* prop = m_grid->GetSelectedProperty() )
        {
            if( prop->GetValueType() == wxT( "bool" ) )
            {
                m_grid->SetPropertyValue( prop, !prop->GetValue().GetBool() );
                return;
            }
        }
    }
 
    if( aEvent.GetKeyCode() == WXK_RETURN || aEvent.GetKeyCode() == WXK_NUMPAD_ENTER
        || aEvent.GetKeyCode() == WXK_DOWN || aEvent.GetKeyCode() == WXK_UP )
    {
        m_grid->CommitChangesFromEditor();
 
        CallAfter( [this]()
                   {
                       m_grid->SelectProperty( m_grid->GetSelectedProperty(), true );
                   } );
    }
 
    aEvent.Skip();
}
 
 
void PROPERTIES_PANEL::RecalculateSplitterPos()
{
    if( m_splitter_key_proportion < 0 )
        m_grid->CenterSplitter();
    else
        m_grid->SetSplitterPosition( m_splitter_key_proportion * m_grid->GetSize().x );
}
 
 
void PROPERTIES_PANEL::SetSplitterProportion( float aProportion )
{
    m_splitter_key_proportion = aProportion;
    RecalculateSplitterPos();
}
 
 
void PROPERTIES_PANEL::addCategoryButton( const wxString& aGroupKey, const wxString& aTooltip, BITMAPS aBitmap,
                                          std::function<void()> aAction, std::function<bool()> aEnableFunc,
                                          bool aForceCategory )
{
    BITMAP_BUTTON* button = new BITMAP_BUTTON( m_grid, wxID_ANY );
    button->SetBitmap( KiBitmapBundle( aBitmap ) );
    button->SetToolTip( aTooltip );
    button->Hide();
 
    button->Bind( wxEVT_BUTTON,
                  [this, button]( wxCommandEvent& )
                  {
                      for( CATEGORY_BUTTON& entry : m_categoryButtons )
                      {
                          if( entry.button == button )
                          {
                              entry.action();
                              return;
                          }
                      }
                  } );
 
    m_categoryButtons.emplace_back( CATEGORY_BUTTON{ .button = button,
                                                     .groupKey = aGroupKey,
                                                     .action = std::move( aAction ),
                                                     .enableFunc = std::move( aEnableFunc ),
                                                     .forceCategory = aForceCategory } );
}
 
 
wxPGProperty* PROPERTIES_PANEL::categoryForGroup( const wxString& aGroupKey ) const
{
    const wxString caption = wxGetTranslation( aGroupKey );
 
    for( wxPropertyGridIterator it = m_grid->GetIterator( wxPG_ITERATE_VISIBLE ); !it.AtEnd(); it.Next() )
    {
        if( wxPGProperty* pgProp = it.GetProperty(); pgProp->IsCategory() && pgProp->GetLabel() == caption )
            return pgProp;
    }
 
    return nullptr;
}
 
 
void PROPERTIES_PANEL::updateCategoryButtons()
{
    positionCategoryButtons();
}
 
 
void PROPERTIES_PANEL::hideCategoryButtons()
{
    for( CATEGORY_BUTTON& entry : m_categoryButtons )
        entry.button->Hide();
}
 
 
void PROPERTIES_PANEL::positionCategoryButtons()
{
    const int rightEdgeBase = m_grid->GetClientSize().x - m_grid->FromDIP( 4 );
    int       nextRightEdge = rightEdgeBase;
    wxString  currentRow;
    bool      haveCurrentRow = false;
 
    for( CATEGORY_BUTTON& entry : m_categoryButtons )
    {
        if( bool sameRow = haveCurrentRow && currentRow == entry.groupKey; !sameRow )
        {
            currentRow = entry.groupKey;
            haveCurrentRow = true;
            nextRightEdge = rightEdgeBase;
        }
 
        wxPGProperty* category = categoryForGroup( entry.groupKey );
        bool          visible = false;
        int           rowY = 0;
        int           rowHeight = m_grid->GetRowHeight();
 
        if( category && ( !entry.enableFunc || entry.enableFunc() ) )
        {
            rowY = m_grid->CalcScrolledPosition( wxPoint( 0, category->GetY() ) ).y;
            visible = ( rowY + rowHeight > 0 ) && ( rowY < m_grid->GetClientSize().y );
        }
 
        if( !visible )
        {
            entry.button->Hide();
            continue;
        }
 
        const wxSize btnSize = entry.button->GetSize();
        const int    btnY = rowY + ( rowHeight - btnSize.y ) / 2;
        const int    btnX = nextRightEdge - btnSize.x;
 
        if( !entry.button->IsShown() )
            entry.button->Show();
 
        entry.button->SetPosition( wxPoint( std::max( 0, btnX ), std::max( 0, btnY ) ) );
        entry.button->Raise();
 
        nextRightEdge = btnX - m_grid->FromDIP( 2 );
    }
}