Arch Linux+i3环境下wxWidgets窗口圆角背景黑色问题求助

我在Arch Linux的i3窗口管理器环境下开发wxWidgets应用，配置i3实现窗口圆角后，圆角区域下方出现黑色背景，需要消除这个黑色背景并实现透明效果。

我的wxWidgets应用main.cpp代码如下：

#include <wx/wxprec.h>
#ifndef WX_PRECOMP
#include <wx/wx.h>
#endif

class ToolsApp : public wxApp
{
public:
    virtual bool OnInit();
};
class ToolsFrame : public wxFrame
{
public:
    ToolsFrame(const wxString &title, const wxPoint &pos, const wxSize &size);

private:
    void OnExit(wxCommandEvent &event);
    void OnAbout(wxCommandEvent &event);
    void OnSupport(wxCommandEvent &event);
    wxDECLARE_EVENT_TABLE();
};
enum
{
    ID_SUPPORT = 1
};
wxBEGIN_EVENT_TABLE(ToolsFrame, wxFrame)
    EVT_MENU(wxID_EXIT, ToolsFrame::OnExit)
        EVT_MENU(wxID_ABOUT, ToolsFrame::OnAbout)
            EVT_MENU(ID_SUPPORT, ToolsFrame::OnSupport)    
                wxEND_EVENT_TABLE()
                    wxIMPLEMENT_APP(ToolsApp);
bool ToolsApp::OnInit()
{
    ToolsFrame *frame = new ToolsFrame("Hello World", wxPoint(50, 50), wxSize(450, 340));
    frame->Show(true);
    return true;
}
ToolsFrame::ToolsFrame(const wxString &title, const wxPoint &pos, const wxSize &size)
    : wxFrame(NULL, wxID_ANY, title, pos, size)
{
    wxMenu *menuHelp = new wxMenu;
    menuHelp->Append(wxID_ABOUT);
    menuHelp->Append(ID_SUPPORT, "&Support");
    wxMenuBar *menuBar = new wxMenuBar;
    menuBar->Append(menuHelp, "&Help");
    SetMenuBar(menuBar);
    CreateStatusBar();
    SetStatusText("");
}
void ToolsFrame::OnSupport(wxCommandEvent &event)
{
    std::string url = "https://example.com/";
#ifdef __UNIX__
    std::string op = std::string("xdg-open ").append(url);
#else
    std::string op = std::string("start ").append(url);
#endif
    system(op.c_str());
}
void ToolsFrame::OnExit(wxCommandEvent &event)
{
    Close(true);
}
void ToolsFrame::OnAbout(wxCommandEvent &event)
{
    wxMessageBox("...",
                 "About ...", wxOK | wxICON_INFORMATION);
}

问题截图：

注：截图与上述代码不完全匹配，我已对代码做了部分修改。

解决方案 #

1. 确保picom的圆角配置正确 #

i3本身不支持窗口圆角，通常依赖picom合成器实现。编辑~/.config/picom/picom.conf：

# 设置圆角大小
corner-radius = 12;
# 排除不需要圆角的窗口（可选）
rounded-corners-exclude = [
    "class_g = 'i3bar'",
    "class_g = 'dmenu'"
];
# 启用窗口透明度规则（可选，按需调整）
opacity-rule = [
    "95:class_g = 'ToolsFrame'"
];

修改后重启picom：picom --replace

2. 修改wxWidgets代码启用透明支持 #

wxFrame默认绘制不透明背景，需要在ToolsFrame构造函数中添加以下代码：

ToolsFrame::ToolsFrame(const wxString &title, const wxPoint &pos, const wxSize &size)
    : wxFrame(NULL, wxID_ANY, title, pos, size)
{
    // 启用透明背景样式
    SetBackgroundStyle(wxBG_STYLE_TRANSPARENT);
    // 设置完全透明的背景色
    SetBackgroundColour(wxColour(0, 0, 0, 0));

    // 原有的菜单、状态栏代码...
    wxMenu *menuHelp = new wxMenu;
    menuHelp->Append(wxID_ABOUT);
    menuHelp->Append(ID_SUPPORT, "&Support");
    wxMenuBar *menuBar = new wxMenuBar;
    menuBar->Append(menuHelp, "&Help");
    SetMenuBar(menuBar);
    CreateStatusBar();
    SetStatusText("");
}

3. 设置窗口管理器识别透明属性 #

在OnInit()函数中创建窗口后，添加窗口透明度设置：

bool ToolsApp::OnInit()
{
    ToolsFrame *frame = new ToolsFrame("Hello World", wxPoint(50, 50), wxSize(450, 340));
    frame->Show(true);

#ifdef __UNIX__
    // 设置窗口透明度，1.0为完全不透明，可按需调整
    frame->SetOpacity(1.0);
#endif

    return true;
}

4. 重载Paint事件避免默认背景绘制（可选） #

如果仍有黑色残留，给ToolsFrame添加Paint事件处理：

• 在类声明中添加：

  void OnPaint(wxPaintEvent& event);
  

• 在事件表中添加：

  wxBEGIN_EVENT_TABLE(ToolsFrame, wxFrame)
      EVT_MENU(wxID_EXIT, ToolsFrame::OnExit)
      EVT_MENU(wxID_ABOUT, ToolsFrame::OnAbout)
      EVT_MENU(ID_SUPPORT, ToolsFrame::OnSupport)
      EVT_PAINT(ToolsFrame::OnPaint)
  wxEND_EVENT_TABLE()
  

• 实现事件函数：

  void ToolsFrame::OnPaint(wxPaintEvent& event)
  {
      wxPaintDC dc(this);
      // 跳过默认背景绘制，只渲染窗口内容
      event.Skip();
  }
  

验证步骤 #

1. 重新编译应用：g++ main.cpp wx-config --cxxflags --libs -o tools-app
2. 重新加载i3配置：mod+Shift+C
3. 运行应用，检查圆角区域是否已透明

内容的提问来源于stack exchange，提问作者XTREME