Панель, использующая FlowLayout, не может содержать JScrollPanes?

Прежде всего - нет ничего плохого в использовании собственного компонента в качестве панели содержимого. Но панель содержимого по умолчанию также является экземпляром JPanel, поэтому на самом деле нет смысла заменять ее собственной панелью, если вы не хотите использовать панель содержимого, не являющуюся панелью, или настраиваемый компонент панели.

Так выглядит панель содержимого по умолчанию:

/**
 * Called by the constructor methods to create the default 
 * <code>contentPane</code>. 
 * By default this method creates a new <code>JComponent</code> add sets a 
 * <code>BorderLayout</code> as its <code>LayoutManager</code>.
 * @return the default <code>contentPane</code>
 */
protected Container createContentPane() {
    JComponent c = new JPanel();
    c.setName(this.getName()+".contentPane");
    c.setLayout(new BorderLayout() {
        /* This BorderLayout subclass maps a null constraint to CENTER.
         * Although the reference BorderLayout also does this, some VMs
         * throw an IllegalArgumentException.
         */
        public void addLayoutComponent(Component comp, Object constraints) {
            if (constraints == null) {
                constraints = BorderLayout.CENTER;
            }
            super.addLayoutComponent(comp, constraints);
        }
    });
    return c;
}

Этот метод взят из JRootPane. Как видите, это простая панель JPanel с настраиваемым менеджером компоновки.

В вашем примере есть несколько проблем.

Во-первых, это порядок вызовов - вы изменяете размер кадра перед добавлением в него содержимого. Просто измените порядок, и вы увидите свою полосу прокрутки:

public class MyFrame extends JFrame
{
    public MyFrame ()
    {
        super();

        // Add components first
        initComponents ();

        // Setup frame after so it fits its new content
        setDefaultCloseOperation ( JFrame.EXIT_ON_CLOSE );
        setPreferredSize ( new Dimension ( 500, 300 ) );
        setResizable ( false );
        pack ();
        setLocationRelativeTo ( null );
    }

    private void initComponents ()
    {
        JPanel panel = new JPanel ();
        panel.setLayout ( new BoxLayout ( panel, BoxLayout.Y_AXIS ) );

        for ( int i = 0; i < 100; i++ )
        {
            panel.add ( new JLabel ( "some text" ) );
        }

        JScrollPane scrollPane =
                new JScrollPane ( panel, ScrollPaneConstants.VERTICAL_SCROLLBAR_AS_NEEDED, ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER );

        // Here I create a JPanel to replace the contentPane of JFrame
        JPanel contentPane = new JPanel ();
        contentPane.add ( scrollPane );
        setContentPane ( contentPane );
    }

    public static void main ( String[] args )
    {
        SwingUtilities.invokeLater ( new Runnable ()
        {
            public void run ()
            {
                new MyFrame ().setVisible ( true );
            }
        } );
    }
}

Он по-прежнему будет выглядеть по-другому, потому что ваш new JPanel () использует FlowLayout по умолчанию вместо BorderLayout, который используется компонентом панели содержимого по умолчанию:

Просто установите BorderLayout, и вы получите желаемый результат:

JPanel contentPane = new JPanel ( new BorderLayout () );

Взгляните на WrapLayout , который является расширением FlowLayout

import java.awt.*;
import javax.swing.*;

public class TestWrapLayout {
    public TestWrapLayout () {
        ImageIcon icon = new ImageIcon(getClass().getResource("/resources/stackoverflow2.png"));
        JPanel panel = new JPanel(new WrapLayout());
        for (int i = 1; i <= 250; i++) {
            JLabel iconlabel = new JLabel(icon);
            iconlabel.setLayout(new BorderLayout());
            JLabel textlabel = new JLabel(String.valueOf(i));
            textlabel.setHorizontalAlignment(JLabel.CENTER);
            textlabel.setForeground(Color.WHITE);
            textlabel.setFont(new Font("impact", Font.PLAIN,20));
            iconlabel.add(textlabel);
            panel.add(iconlabel);
        }
        JFrame frame = new JFrame();
        frame.add(new JScrollPane(panel));
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(300, 300);
        frame.setLocationRelativeTo(null);
        frame.setVisible(true);
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(new Runnable(){
            public void run() {
                new TestWrapLayout();
            }
        });
    }
}

Вы должны обновить фрейм после добавления панели с помощью функции pack(). Когда ты делаешь

getContentPane().add(scrollPane);

функция add сделает это за вас (ссылка)

Во-первых, по какой причине была создана вторая панель? Уже есть первая панель, для которой установлен BoxLayout в качестве менеджера по расположению. Простая установка панели прокрутки с первой панелью в качестве родительской работает должным образом.

Вы либо звоните

setContentPane(scrollPane);

or

add(scrollPane);

Теперь я объясню, что вызвало такое неожиданное поведение. Это причуда, которая иногда случается с теми, кто использует технику вложения при построении своих макетов. При использовании вложенности макеты могут влиять друг на друга.

Выбрав другой макет - FlowLayout - в качестве основного базового макета, вы заставили первую панель отображаться в ее предпочтительном размере. Вместо одной панели у вас теперь две панели, базовая панель влияет на панель с помощью меток - она ​​контролирует ее размер. FlowLayout показывает всех своих дочерних элементов в предпочтительном размере; он не соблюдает минимальные и максимальные размеры. Итак, (первая) видимая панель имеет размер, чтобы показать все ее метки; так рассчитывается предпочтительный размер - достаточно большой, чтобы показать все его дочерние элементы. Однако со 100 этикетками он очень большой; макет нарушен. По вертикали он такой большой, что мы практически не можем добраться до низа окна.

Итак, с нашей видимой панелью, показывающей все ее ярлыки, какова цель отображения вертикальной полосы прокрутки? В нем нет необходимости, так как все надписи «видимы» (размещаются в области окна), хотя дизайн нарушен.

Так что проблема не в полосах прокрутки; они работают нормально. Если вы установите (в вашем примере) политику вертикальной полосы прокрутки на VERTICAL_SCROLLBAR_ALWAYS, вы увидите полосу прокрутки там, но без ползунка, поскольку все метки «видимы» и прокручивать нечего. (Полосы прокрутки показывают элементы, которые скрыты от макета.) Проблема заключается в том, что FlowLayout показывает свои компоненты только в предпочтительном размере.

Ниже приведен пример фиксированного кода, который работает должным образом:

package com.zetcode;

import java.awt.Dimension;
import java.awt.EventQueue;
import javax.swing.BoxLayout;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.ScrollPaneConstants;

public class MyFrame extends JFrame {

    public MyFrame() {

        initComponents();

        setTitle("Scrollbar");
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);                       
        setPreferredSize(new Dimension(300, 200));
        pack();
        setLocationRelativeTo(null);        

    }

    private void initComponents() {

        JPanel panel = new JPanel();
        panel.setLayout(new BoxLayout(panel, BoxLayout.Y_AXIS));

        for (int i=0; i < 100; i++)
            panel.add(new JLabel("some text"));

        JScrollPane scrollPane = new JScrollPane(panel, 
                ScrollPaneConstants.VERTICAL_SCROLLBAR_AS_NEEDED, 
                ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED);

        setContentPane(scrollPane);
    }

    public static void main(String[] args) {

        EventQueue.invokeLater(new Runnable() {
            @Override
            public void run() {
                MyFrame ex = new MyFrame();
                ex.setVisible(true);
            }
        });
    }    
}