自定义WinForms按钮：如何实现原生Button的TextImageRelation等渲染逻辑？

首先直接给结论：WinForms没有直接暴露原生Button的图文渲染逻辑供开发者直接复用，但你有两种可行的方案：要么复用原生Button的绘制逻辑（简单快速），要么完全手动用GDI+实现和原生一致的图文布局（更灵活，适合深度自定义）。

方案1：复用原生Button的图文渲染（快速实现） #

如果你只是想在原生Button的基础上添加自定义效果（比如修改边框、背景），但保留原生的图文排列逻辑，最简单的方法是在重写OnPaint时先调用base.OnPaint(e)，让原生控件完成图文绘制，再叠加你的自定义内容：

using System.Drawing;
using System.Windows.Forms;
using System.Drawing.Drawing2D;

public class CustomButton : Button
{
    protected override void OnPaint(PaintEventArgs e)
    {
        // 先让原生Button绘制文本和图像
        base.OnPaint(e);
        
        // 这里添加你的自定义渲染逻辑，比如画圆角边框
        using (var borderPen = new Pen(Color.DodgerBlue, 2))
        {
            borderPen.Alignment = PenAlignment.Inset;
            e.Graphics.SmoothingMode = SmoothingMode.AntiAlias;
            e.Graphics.DrawRoundedRectangle(borderPen, ClientRectangle, 6);
        }
    }
}

这个方案的好处是完全不用自己处理TextImageRelation、TextAlign、ImageAlign这些属性的布局逻辑，原生Button已经帮你搞定了，你只需要专注于自定义部分。

方案2：完全手动用GDI+实现原生级图文布局（深度自定义） #

如果需要完全替换原生绘制逻辑（比如实现自定义的按钮样式，但要保持和原生一致的图文排列规则），你需要手动处理布局计算和渲染。下面是一个完整的实现示例，覆盖所有要求的属性和按钮状态：

using System.Drawing;
using System.Windows.Forms;
using System.Drawing.Drawing2D;

public class GDIPlusCustomButton : Button
{
    protected override void OnPaint(PaintEventArgs e)
    {
        // 绘制背景（可以替换成自定义背景）
        base.OnPaintBackground(e);
        var g = e.Graphics;
        g.SmoothingMode = SmoothingMode.AntiAlias;

        // 处理按钮状态：正常、悬停、按下、禁用
        bool isPressed = Control.MouseButtons == MouseButtons.Left && ClientRectangle.Contains(PointToClient(MousePosition));
        bool isHovered = ClientRectangle.Contains(PointToClient(MousePosition));
        Color textColor = Enabled 
            ? (isPressed ? SystemColors.ControlText : (isHovered ? SystemColors.HighlightText : ForeColor)) 
            : SystemColors.GrayText;

        // 获取文本和图像资源
        string displayText = Text;
        Image displayImage = Image;
        Size textSize = TextRenderer.MeasureText(g, displayText, Font, ClientSize, TextFormatFlags.WordBreak);
        Size imageSize = displayImage != null ? displayImage.Size : Size.Empty;

        // 计算文本和图像的位置矩形
        Rectangle textRect = ClientRectangle;
        Rectangle imageRect = ClientRectangle;

        // 根据TextImageRelation属性处理整体布局
        switch (TextImageRelation)
        {
            case TextImageRelation.ImageBeforeText:
                int totalWidthLeft = imageSize.Width + Padding.Horizontal + textSize.Width;
                int startXLeft = (ClientSize.Width - totalWidthLeft) / 2;
                
                imageRect = new Rectangle(startXLeft, (ClientSize.Height - imageSize.Height) / 2, imageSize.Width, imageSize.Height);
                textRect = new Rectangle(startXLeft + imageSize.Width + Padding.Horizontal, (ClientSize.Height - textSize.Height) / 2, textSize.Width, textSize.Height);
                break;

            case TextImageRelation.TextBeforeImage:
                int totalWidthRight = textSize.Width + Padding.Horizontal + imageSize.Width;
                int startXRight = (ClientSize.Width - totalWidthRight) / 2;
                
                textRect = new Rectangle(startXRight, (ClientSize.Height - textSize.Height) / 2, textSize.Width, textSize.Height);
                imageRect = new Rectangle(startXRight + textSize.Width + Padding.Horizontal, (ClientSize.Height - imageSize.Height) / 2, imageSize.Width, imageSize.Height);
                break;

            case TextImageRelation.ImageAboveText:
                int totalHeightTop = imageSize.Height + Padding.Vertical + textSize.Height;
                int startYTop = (ClientSize.Height - totalHeightTop) / 2;
                
                imageRect = new Rectangle((ClientSize.Width - imageSize.Width) / 2, startYTop, imageSize.Width, imageSize.Height);
                textRect = new Rectangle((ClientSize.Width - textSize.Width) / 2, startYTop + imageSize.Height + Padding.Vertical, textSize.Width, textSize.Height);
                break;

            case TextImageRelation.TextAboveImage:
                int totalHeightBottom = textSize.Height + Padding.Vertical + imageSize.Height;
                int startYBottom = (ClientSize.Height - totalHeightBottom) / 2;
                
                textRect = new Rectangle((ClientSize.Width - textSize.Width) / 2, startYBottom, textSize.Width, textSize.Height);
                imageRect = new Rectangle((ClientSize.Width - imageSize.Width) / 2, startYBottom + textSize.Height + Padding.Vertical, imageSize.Width, imageSize.Height);
                break;

            case TextImageRelation.Overlay:
                // 文本和图像叠加，分别使用各自的Align属性定位
                textRect = GetAlignedBounds(textSize, ClientRectangle, TextAlign);
                imageRect = GetAlignedBounds(imageSize, ClientRectangle, ImageAlign);
                break;

            default:
                goto case TextImageRelation.ImageBeforeText;
        }

        // 绘制图像（处理禁用状态的灰化效果）
        if (displayImage != null)
        {
            if (!Enabled)
            {
                ControlPaint.DrawImageDisabled(g, displayImage, imageRect.X, imageRect.Y, BackColor);
            }
            else
            {
                g.DrawImage(displayImage, imageRect);
            }
        }

        // 绘制文本（使用TextRenderer保证和原生控件一致的渲染效果）
        TextFormatFlags textFlags = GetTextFormatFlags(TextAlign);
        TextRenderer.DrawText(g, displayText, Font, textRect, textColor, textFlags);
    }

    // 根据ContentAlignment获取对应的TextFormatFlags
    private TextFormatFlags GetTextFormatFlags(ContentAlignment align)
    {
        TextFormatFlags flags = TextFormatFlags.WordBreak;
        switch (align)
        {
            case ContentAlignment.TopLeft: flags |= TextFormatFlags.Top | TextFormatFlags.Left; break;
            case ContentAlignment.TopCenter: flags |= TextFormatFlags.Top | TextFormatFlags.HorizontalCenter; break;
            case ContentAlignment.TopRight: flags |= TextFormatFlags.Top | TextFormatFlags.Right; break;
            case ContentAlignment.MiddleLeft: flags |= TextFormatFlags.VerticalCenter | TextFormatFlags.Left; break;
            case ContentAlignment.MiddleCenter: flags |= TextFormatFlags.VerticalCenter | TextFormatFlags.HorizontalCenter; break;
            case ContentAlignment.MiddleRight: flags |= TextFormatFlags.VerticalCenter | TextFormatFlags.Right; break;
            case ContentAlignment.BottomLeft: flags |= TextFormatFlags.Bottom | TextFormatFlags.Left; break;
            case ContentAlignment.BottomCenter: flags |= TextFormatFlags.Bottom | TextFormatFlags.HorizontalCenter; break;
            case ContentAlignment.BottomRight: flags |= TextFormatFlags.Bottom | TextFormatFlags.Right; break;
        }
        return flags;
    }

    // 根据对齐方式计算元素在容器内的位置
    private Rectangle GetAlignedBounds(Size elementSize, Rectangle container, ContentAlignment align)
    {
        int x = container.X;
        int y = container.Y;

        switch (align)
        {
            case ContentAlignment.TopCenter:
                x = container.X + (container.Width - elementSize.Width) / 2;
                y = container.Y;
                break;
            case ContentAlignment.TopRight:
                x = container.Right - elementSize.Width;
                y = container.Y;
                break;
            case ContentAlignment.MiddleLeft:
                x = container.X;
                y = container.Y + (container.Height - elementSize.Height) / 2;
                break;
            case ContentAlignment.MiddleCenter:
                x = container.X + (container.Width - elementSize.Width) / 2;
                y = container.Y + (container.Height - elementSize.Height) / 2;
                break;
            case ContentAlignment.MiddleRight:
                x = container.Right - elementSize.Width;
                y = container.Y + (container.Height - elementSize.Height) / 2;
                break;
            case ContentAlignment.BottomLeft:
                x = container.X;
                y = container.Bottom - elementSize.Height;
                break;
            case ContentAlignment.BottomCenter:
                x = container.X + (container.Width - elementSize.Width) / 2;
                y = container.Bottom - elementSize.Height;
                break;
            case ContentAlignment.BottomRight:
                x = container.Right - elementSize.Width;
                y = container.Bottom - elementSize.Height;
                break;
        }
        return new Rectangle(x, y, elementSize.Width, elementSize.Height);
    }
}

这个实现的关键点： #

• 完全支持TextImageRelation的所有枚举值，包括叠加模式
• 遵循TextAlign和ImageAlign的对齐规则
• 处理了按钮的所有状态（正常、悬停、按下、禁用）的视觉效果
• 使用TextRenderer而非Graphics.DrawString，保证文本渲染和原生WinForms控件一致，避免字体模糊问题
• 考虑了Padding属性对图文间距的影响

关于“内置实现方式”的补充 #

WinForms的Button控件内部确实已经实现了所有这些图文布局逻辑，但这些逻辑大多是private或internal的，没有对外暴露。所以你无法直接调用原生的布局方法，只能通过上面两种方案来实现需求：要么复用原生绘制，要么手动复刻逻辑。

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