在 Winforms .NET Core 中使用命令链接

Question

I would like to add command links into my C# Windows Forms app for Windows 10 21H2, but I haven't found any tutorials online.

I believe that this is a photo of a command link, but I'm not too sure. Can someone tell me how to add these to my app?

I couldn't find any controls like this in the VS toolbox.

Answer 1

Try this Custom Control, derived from Button, where the BS_COMMANDLINK Style is added in the CreateParams property override.
This turns the standard Button Control in a CommandLink Button.
The Text Property value of the Control is shown to the right of the arrow, while the custom LinkNote Property provides the description that is shown right below the text, with a smaller Font.
When you set the LinkNote value, the BCM_SETNOTE message is sent to the native Button. This sets the associated Note, at design-time or run-time.

The custom ControlDesigner is used to remove properties that are not needed / used when this style is set, or properties, as FlatStyle (which needs to be set to FlatStyle.System ), that cannot be changed.
Unfortunately, this Designer works only in .NET Framework, to make it work in .NET 5+, you need to install the Microsoft.WinForms.Designer.SDK package. Open up the Package Manager Console and paste:

NuGet\Install-Package Microsoft.WinForms.Designer.SDK -Version 1.1.0-prerelease-preview3.22076.5

This package is hard to find otherwise.
If you don't care about the Designer's features, just remove it

using System.Collections;
using System.ComponentModel;
using System.Runtime.InteropServices;
#if NET5_0_OR_GREATER
    using Microsoft.DotNet.DesignTools.Designers;
#else
    using System.Windows.Forms.Design;
#endif

[ToolboxItem(true)]
[Designer(typeof(CommandLinkDesigner))]
public class CommandLink : Button {
    private const int BCM_SETNOTE = 0x1609;
    private string m_LinkNote = string.Empty;

    public CommandLink() {
        SetStyle(ControlStyles.ResizeRedraw | ControlStyles.UseTextForAccessibility, true);
        FlatStyle = FlatStyle.System;
    }

    [DefaultValue(FlatStyle.System)]
    public new FlatStyle FlatStyle {
        get { return base.FlatStyle; }
        set { base.FlatStyle = FlatStyle.System; }
    }

    public string LinkNote {
        get => m_LinkNote;
        set {
            if (value != m_LinkNote) {
                m_LinkNote = value;
                SendMessage(this.Handle, BCM_SETNOTE, 0, m_LinkNote);
            }
        }
    }

    protected override CreateParams CreateParams {
        get {
            var cp = base.CreateParams;
            cp.Style |= (0 | 0x0E); // Set BS_COMMANDLINK 
            return cp;
        }
    }

    [DllImport("user32.dll", CharSet = CharSet.Unicode)]
    private static extern bool SendMessage(IntPtr hWnd, int msg, int wParam, string lParam);

    public class CommandLinkDesigner : ControlDesigner {
        private readonly string[] RemovedProperties = new[] {
            "AllowDrop", "AutoEllipsis", "AutoSize", "AutoSizeMode",
            "BackColor", "BackgroundImage", "BackgroundImageLayout",
            "Cursor", "FlatAppearance", "FlatStyle",
            "ForeColor", "Image", "ImageAlign", "ImageImdex", "ImageKey",
            "ImageList", "TextAlign", "TextImageRelation"
        };

        public CommandLinkDesigner() { }

        protected override void PreFilterProperties(IDictionary properties)
        {
            foreach (string prop in RemovedProperties) {
                properties.Remove(prop);
            }
            base.PreFilterProperties(properties);
        }
    }
}

Answer 2

To add a command link to a Windows Forms application, you can use the CommandLink control from the System.Windows.Forms.VisualStyles namespace. Here is an example of how to use the CommandLink control in a Windows Forms application:

using System.Windows.Forms.VisualStyles;

// ...

// Create a new CommandLink control
CommandLink commandLink = new CommandLink();

// Set the text and description of the CommandLink
commandLink.Text = "Run the app";
commandLink.Description = "Click this button to run the app";

// Add the CommandLink to the form
this.Controls.Add(commandLink);

You can customize the appearance and behavior of the CommandLink control by setting its various properties, such as Text, Description, and UseVisualStyleBackColor. You can also handle the Click event of the CommandLink control to specify the action that should be taken when the user clicks the button.