WinForm中Panel正常窗口状态下完整显示PictureBox并支持滚动的问题

从数据库获取图片并以List形式传入Form，在Form中创建Panel，根据图片数量创建PictureBox并添加到Panel中（本次加载120张800×600的图片）。在FormWindowState.Normal状态下，Panel仅显示54张图片；但将窗口切换为FormWindowState.Maximized后，滚动条可显示所有图片，切回Normal状态后所有图片也可正常滚动查看。若将图片尺寸设为200×200则可一次性显示全部，但需求是必须显示800×600的图片。如何实现正常窗口状态下一次性显示所有图片集并支持滚动？

附上相关代码：

public partial class ShowReferences
{
    private List<Image> imagesCollection;
    private Panel panelToShow;

    public ShowReferences(List<Image> images)
    {
        InitializeComponent();
        imagesCollection = images;
        panelToShow = new Panel();
        panelToShow.AutoScroll = true;
        panelToShow.Dock = DockStyle.Fill;
        Controls.Add(panelToShow);

        for (int i = 0; i < this.imagesCollection.Count; i++)
        {
            PictureBox pictureBox = new PictureBox();
            pictureBox.Image = this.imagesCollection[i];
            pictureBox.SizeMode = PictureBoxSizeMode.AutoSize;
            pictureBox.Location = new Point(0, i * pictureBox.Height);
            this.panelToShow.Controls.Add(pictureBox);
        }
    }
}

窗口调整时的滚动元素值记录：

Action: When fill panel with elements Window state :Normal=======================23.02.2023 16:31:31
panelToShow.AutoScrollMargin :{Width=0, Height=0}
panelToShow.AutoScrollMinSize :{Width=0, Height=0}
panelToShow.AutoScrollOffset :{X=0,Y=0}
panelToShow.AutoScrollPosition :{X=0,Y=0}
panelToShow.HorizontalScroll.Value :0
panelToShow.HorizontalScroll.Maximum :100
panelToShow.HorizontalScroll.Minimum :0
panelToShow.HorizontalScroll.LargeChange :10
panelToShow.HorizontalScroll.SmallChange :1
panelToShow.VerticalScroll.Value :0
panelToShow.VerticalScroll.Maximum :100
panelToShow.VerticalScroll.Minimum :0
panelToShow.VerticalScroll.LargeChange :10
panelToShow.VerticalScroll.SmallChange :1
Action: Change window state size. Window state :Maximized=======================23.02.2023 16:31:34

panelToShow.AutoScrollMargin :{Width=0, Height=0}
panelToShow.AutoScrollMinSize :{Width=0, Height=0}
panelToShow.AutoScrollOffset :{X=0,Y=0}
panelToShow.AutoScrollPosition :{X=0,Y=-32591}
panelToShow.HorizontalScroll.Value :0
panelToShow.HorizontalScroll.Maximum :799
panelToShow.HorizontalScroll.Minimum :0
panelToShow.HorizontalScroll.LargeChange :583
panelToShow.HorizontalScroll.SmallChange :5
panelToShow.VerticalScroll.Value :32591
panelToShow.VerticalScroll.Maximum :66384
panelToShow.VerticalScroll.Minimum :0
panelToShow.VerticalScroll.LargeChange :793
panelToShow.VerticalScroll.SmallChange :5
Action: Change window state size. Window state :Normal=======================23.02.2023 16:31:36

已尝试过重绘窗体和控件、手动设置滚动元素值，但均未解决问题。

问题根源是Panel在Normal状态下未正确计算滚动区域的总尺寸，导致滚动条的Maximum值未更新到实际需要的高度。可通过以下方式解决：

1. 手动计算并设置Panel的AutoScrollMinSize #

在添加完所有PictureBox后，计算所有图片的总宽高，手动设置AutoScrollMinSize，强制Panel识别完整的滚动区域：

public ShowReferences(List<Image> images)
{
    InitializeComponent();
    imagesCollection = images;
    panelToShow = new Panel();
    panelToShow.AutoScroll = true;
    panelToShow.Dock = DockStyle.Fill;
    Controls.Add(panelToShow);

    int totalHeight = 0;
    int maxWidth = 0;
    for (int i = 0; i < this.imagesCollection.Count; i++)
    {
        PictureBox pictureBox = new PictureBox();
        pictureBox.Image = this.imagesCollection[i];
        pictureBox.SizeMode = PictureBoxSizeMode.AutoSize;
        
        // 直接获取图片原始尺寸，避免PictureBox未初始化完成导致尺寸错误
        int imgHeight = pictureBox.Image.Height;
        int imgWidth = pictureBox.Image.Width;
        
        pictureBox.Location = new Point(0, totalHeight);
        this.panelToShow.Controls.Add(pictureBox);
        
        totalHeight += imgHeight;
        maxWidth = Math.Max(maxWidth, imgWidth);
    }
    // 设置滚动区域最小尺寸为所有图片的总宽高
    panelToShow.AutoScrollMinSize = new Size(maxWidth, totalHeight);
}

2. 强制触发Panel布局更新 #

如果不想手动计算尺寸，可在添加完所有控件后强制Panel重新计算布局：

// 在添加完所有PictureBox后执行以下代码
panelToShow.PerformLayout();
panelToShow.Refresh();
panelToShow.VerticalScroll.Update();

3. 确保PictureBox尺寸正确初始化 #

避免依赖PictureBox的Height属性计算位置（刚赋值Image时可能未完成初始化），直接使用Image的原始尺寸来设置Location和计算总高度，如方案1所示。

关键原理 #

从日志可见，Normal状态下VerticalScroll.Maximum初始仅为100，远小于实际需要的66384，说明Panel未自动识别所有子控件的总尺寸。手动设置AutoScrollMinSize会直接告知Panel滚动区域的最小范围，让滚动条最大值正确更新，无论窗口处于Normal还是Maximized状态，都能显示完整的滚动区域。

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