WinForms系统菜单：添加带图标与文字的菜单项后仅显示图标求助

Hey there! I’ve run into this exact issue before when tweaking Win32 system menus in WinForms—let’s break down what’s likely going wrong and how to fix it.

The Core Problem: Misconfigured fMask and fType Flags #

WinForms relies on the underlying Win32 MENUITEMINFO structure to modify system menus. When your menu only shows the icon and not the text, it’s almost always because you’re not explicitly telling the system to render both elements correctly.

Key Fixes to Try #

1. Ensure fMask Includes Both Text and Bitmap Flags

You need to explicitly flag that you’re providing both text content and an icon. Set fMask to include both MIIM_TYPE (for text data) and MIIM_BITMAP (for the icon bitmap):

mii.fMask = MIIM_TYPE | MIIM_BITMAP;

If you omit MIIM_TYPE, the system will completely ignore the text string you’ve set in dwTypeData.

2. Set fType to MFT_STRING

Don’t set fType to MFT_BITMAP—that tells the menu to only render the bitmap and discard any text. Keep it as MFT_STRING (the default for text-based items) to enable simultaneous text and icon rendering:

mii.fType = MFT_STRING;

3. Verify dwTypeData and cch Are Correctly Populated

When using MIIM_TYPE, you must:

• Assign your menu text directly to dwTypeData
• Set cch to the length of the text string (omit the null terminator for most .NET Framework versions)

Example of correct setup:

mii.dwTypeData = "My Custom Menu Item";
mii.cch = (uint)mii.dwTypeData.Length;

Full Working Code Example #

Here’s a complete snippet to add a system menu item with both icon and text in WinForms:

First, define the necessary P/Invoke structures and constants:

using System;
using System.Runtime.InteropServices;
using System.Windows.Forms;

public partial class MainForm : Form
{
    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
    private struct MENUITEMINFO
    {
        public uint cbSize;
        public uint fMask;
        public uint fType;
        public uint fState;
        public uint wID;
        public IntPtr hSubMenu;
        public IntPtr hbmpChecked;
        public IntPtr hbmpUnchecked;
        public IntPtr dwItemData;
        public string dwTypeData;
        public uint cch;
        public IntPtr hbmpItem;
    }

    private const uint MIIM_TYPE = 0x00000010;
    private const uint MIIM_BITMAP = 0x00000080;
    private const uint MFT_STRING = 0x00000000;

    [DllImport("user32.dll", CharSet = CharSet.Unicode)]
    private static extern bool SetMenuItemInfo(IntPtr hMenu, uint uItem, bool fByPosition, ref MENUITEMINFO lpmii);

    [DllImport("user32.dll")]
    private static extern IntPtr GetSystemMenu(IntPtr hWnd, bool bRevert);

    [DllImport("gdi32.dll")]
    private static extern bool DeleteObject(IntPtr hObject);

    // ... rest of your form code ...

Then, add the menu item in your form’s Load event:

private void MainForm_Load(object sender, EventArgs e)
{
    IntPtr hSysMenu = GetSystemMenu(this.Handle, false);
    if (hSysMenu == IntPtr.Zero) return;

    // Load your icon (replace with your own resource)
    var menuIcon = Properties.Resources.MyMenuIcon.ToBitmap();
    IntPtr hIconBitmap = menuIcon.GetHbitmap();

    // Configure menu item info
    MENUITEMINFO mii = new MENUITEMINFO();
    mii.cbSize = (uint)Marshal.SizeOf(mii);
    mii.fMask = MIIM_TYPE | MIIM_BITMAP;
    mii.fType = MFT_STRING;
    mii.dwTypeData = "Custom Menu Item";
    mii.cch = (uint)mii.dwTypeData.Length;
    mii.hbmpItem = hIconBitmap;

    // Insert the item at position 0 (adjust as needed)
    SetMenuItemInfo(hSysMenu, 0, true, ref mii);

    // Clean up bitmap handle to avoid memory leaks
    DeleteObject(hIconBitmap);
}

Bonus: Avoid Memory Leaks #

Always call DeleteObject() on your bitmap handle after setting the menu item—Win32 won’t clean this up automatically for you, so skipping this can lead to memory bloat over time.

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