Qt应用中QPushButton无法正确设置QIcon问题求助

Hey there, let's troubleshoot why your QPushButton icon isn't showing up properly! From the code snippet you shared, you've got the image loading and scaling started, but there are a few key missing pieces and common pitfalls to address. Let's break this down step by step:

1. Add the Critical Icon Assignment Step #

Your code cuts off after scaling the QPixmap—you need to convert that scaled pixmap into a QIcon and assign it to the button, plus set the icon size to ensure it displays. Here's the complete corrected code:

Widget::Widget(QWidget *parent) : QWidget(parent), ui(new Ui::Widget) {
    ui->setupUi(this);
    QImage img(":/sample");
    
    // First, check if the image loaded successfully (critical for debugging)
    if(img.isNull()){
        qDebug() << "Failed to load image resource! Check your .qrc setup.";
        return;
    }

    QPixmap scaledPixmap = QPixmap::fromImage(img).scaled(
        ui->pushButton->size(),
        Qt::KeepAspectRatio,  //补全 your truncated enum value
        Qt::SmoothTransformation  // Optional: makes scaling look cleaner
    );

    // Create QIcon and assign to the button
    ui->pushButton->setIcon(QIcon(scaledPixmap));
    // Set icon size to match the scaled pixmap (this is often overlooked!)
    ui->pushButton->setIconSize(scaledPixmap.size());
}

2. Verify Your Qt Resource File (.qrc) Setup #

Since you're using the resource path :/sample, make sure your .qrc file is correctly configured and linked to your project:

• Your .qrc file should include the image like this:

  <RCC>
      <qresource prefix="/">
          <file>sample.png</file> <!-- Match this to your actual image filename -->
      </qresource>
  </RCC>
  

• Your project's .pro file must reference the resource file:

  RESOURCES += your_resource_filename.qrc
  

If the path is wrong, img.isNull() will return true—the debug message in the code above will help you catch this quickly.

3. Check Button Properties #

• Ensure the button's iconSize isn't set to a tiny value (the code above handles this by matching the scaled pixmap size, which is reliable).
• If you're using Qt Designer, confirm the button hasn't been set to hide icons: check the iconVisibleInMenu property (though this is usually enabled by default for regular push buttons).
• Avoid custom stylesheets that might override or hide the icon: if you've added stylesheet code like border-image or background-image, it could cover the button's icon.

4. Other Quick Checks #

• Make sure your image format is supported by Qt (PNG, JPG, BMP are all safe—rare formats may require additional plugins).
• Double-check the Qt::KeepAspectRatio enum value in your scaling code (your snippet cut it off, so a typo here would cause compilation errors or unexpected behavior).

After making these adjustments, your QPushButton icon should display as expected!

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