最近在给一个跑了七八年的 JavaGUI 桌面工具做界面翻新打开老代码满屏都是RowLayout和RowData。很多人一上手 SWT 就直接奔着GridLayout去了觉得RowLayout太简陋——说白了就是从左往右摆一排控件。可真正把窗口拖窄、把控件动态藏起来、把高 DPI 缩放打开之后你会发现RowLayout那套按行排列、自动换行、逐控件覆写的机制反而是工具栏、标签云、按钮条这类场景里最省事的选择。这篇就聊透 SWT 里这个被低估的布局管理器它到底怎么算尺寸、wrap 和 pack 到底在争什么、RowData里那几个字段分别管哪条轴、ScrolledComposite 里换行为什么不生效、以及我踩过的那些让人想砸键盘的坑。不管你是刚接触 SWT 的学生还是维护老 RCP 界面的老手这里的内容应该都能直接抄去用。1. RowLayout 到底是个什么东西什么时候该用它1.1 它的本质一条会折行的传送带RowLayout的模型非常朴素把子控件一个接一个地排在一行里排不下就换行。你可以把它想成超市收银台上的商品传送带——东西从左边进摆满了就往下一层走。它不关心你摆的是什么只关心这一行还剩多宽。默认情况下它水平排列、允许换行、每个控件保持自己的首选尺寸、外侧留 3 像素边距、控件之间留 3 像素间距。这几个默认值加起来就是很多人第一次跑 SWT 程序时那股按钮挤在一起、四周还有点空的观感来源。和FillLayout那种所有子控件平分容器的粗暴策略不同RowLayout尊重控件自己computeSize()出来的结果。你放一个宽 200 的Text它就占 200你放三个宽度不一的Button三个宽度就各不相同。这一点在工具栏场景里极其关键——保存和另存为两个按钮本来就该宽度不同硬要平分反而难看。它的第二个特点是能折。wrap打开之后容器变窄控件自动滚到下一行。这个能力在FillLayout里是没有的在GridLayout里要靠numColumns手动算列数也做不自然。做标签列表、做筛选条件栏、做那种窗口无论多宽都不出现横向滚动条的界面RowLayout的折行是最实测下来最省代码的方案。1.2 和 GridLayout、FillLayout 放一起怎么选很多人纠结的不是怎么用而是到底该选哪个。我把这三个布局在真实项目里的取舍整理成一张表你可以直接对照自己的场景维度RowLayoutGridLayoutFillLayout排列逻辑顺序排一行超宽折行严格二维网格行列数可控水平或垂直平铺是否尊重首选尺寸是packtrue时是否强制平分折行/自动换列原生支持不支持不支持单控件单独定制通过RowData覆写宽高通过GridData覆写grab/span/对齐无复杂表单能力弱强无典型场景工具栏、按钮条、标签云、状态栏表单、设置页、多列面板整体分栏、主区域填充学习成本低中高极低我自己的判断标准很粗暴如果这个容器里的控件顺序排开就行、宽度参差也没关系、窄了就换行用RowLayout如果对不齐就活该被产品经理骂那就上GridLayout如果只是把一个区域整体撑满FillLayout一行代码搞定。举两个具体例子。一个是搜索条件栏Label Text Label Combo Button依次排列窗口拉窄时自动折成两行——RowLayout十行代码GridLayout得算半天numColumns还得处理折行时不出现的空位。另一个是主内容区左边一个树右边一个表格——这是FillLayout(SWT.HORIZONTAL)或者GridLayout的活儿RowLayout在这里会给你惊喜惊悚的那种因为两个控件都会保持首选宽度容器一拉大右边直接空出一大块白。1.3 什么时候千万别用它说句实在的RowLayout在一些场景下是纯纯的坑。第一种是严格对齐的表单。RowLayout没有列的概念你把 5 个Label放在左边、5 个Text放在右边只要字号一变、或者某个标签文字长了两个字符整排就歪了。这种必须用GridLayout配GridData.horizontalAlignment SWT.FILL别硬扛。第二种是需要按比例分配空间的布局。RowLayout里没有grabExcessHorizontalSpace这种概念唯一能拉伸的是fill和justify而这两个是填满整行和把剩余空隙切成等份塞进间隔里跟让中间这个输入框占 70% 宽度完全是两回事。要做自适应比例老老实实换GridLayout。第三种是单个容器里控件超过几百个。RowLayout每次 layout 都要遍历所有子控件重新计算折行控件数量上百之后窗口拖拽会明显掉帧。我做标签云的时候贴了 400 多个Label窗口一拖就一顿一顿的最后改成虚拟化 分批加载才顺过来。十几二十个控件随便用上百个就得掂量掂量。注意判断该不该用 RowLayout看一条就够——这些控件是否彼此独立、没有对齐诉求。有对齐诉求的一律上 GridLayout别指望 RowLayout 能对齐。2. 六个参数决定一切wrap、pack、fill、justify、spacing、margin2.1 wrap 与 pack一个管换不换行一个管占多大wrap是RowLayout最有辨识度的开关默认true。打开时当剩余宽度不足以放下下一个控件它就把这个控件挪到下一行。关掉之后超出容器的控件会被直接裁掉——注意是裁掉不是出现滚动条RowLayout本身不管滚动想要滚动条得起ScrolledComposite。pack这个名字容易误解它不是打包而是这一行是否只占最小所需空间。默认true意思是每行的高度等于这一行里最高控件的首选高度行与行之间紧凑排列。设成false之后行会沿着排列方向的垂直方向扩展把容器的剩余空间分掉。举个直观的例子容器高 200里面两行按钮每行高 26。packtrue时两行加起来占 52 像素剩下的 148 全是空白全都堆在底部packfalse时两行的行高会被拉成各 100按钮在 100 高的行里垂直居中——视觉效果就是按钮被均匀撒在整个容器里。这两个参数的组合有四种实际行为差得挺远wrappack实际效果适用场景truetrue紧凑折行右下留白工具栏、标签云最常用truefalse折行且行高均分容器高度卡片流、纵向均匀分布falsetrue不折行超出被裁剪单行固定工具条falsefalse不折行行高撑满少见的定高横幅我个人 90% 的场景都是wraptrue, packtrue剩下 10% 里大部分是packfalse做纵向均匀分布。wrapfalse我基本只在确定容器宽度够用的单行状态栏里用因为一旦用户把窗口拉窄界面直接残废风险太高。2.2 fill 与 justify按钮变成面条的两大元凶这两个参数是新手翻车率最高的地方。fill默认false一旦设成true控件会在垂直于排列方向的轴上被拉满。水平排列时就是把每个控件的高度拉到该行的行高。注意它拉的是高度不是宽度——很多同学开了fill发现按钮变高了却没变宽以为是没生效其实是理解错了轴。justify默认false设成true时RowLayout会把容器里这一行没用完的剩余宽度平均分配到控件之间的间距上并且让第一个控件贴左边、最后一个贴右边。这玩意儿看起来很美实际特别挑场景如果一行只有 2 个按钮、容器宽 800两个按钮会被推到两端中间空出巨大的缝隙视觉上像布局崩了。它真正合适的场景是导航条首尾各一个元素比如左边是标题、右边是关闭按钮。这里有个很多人不知道的细节fill和justify同时打开时justify会先把剩余宽度分掉fill再在剩下的空间里干活两者叠加出来的效果非常诡异。我建议这两个开关永远只开一个除非你已经在真机上把窗口从 300 拖到 1920 全看了一遍。还有一个隐藏得比较深的坑filltrue时行高由该行最高控件决定而最高控件可能是你放进去的一个带SWT.BORDER的Text它有内边距算出来比按钮高 2~4 像素。结果就是同一行的按钮全被拉高到Text的高度看着像按钮被压扁后又拉长。解决办法是给那个Text显式套一个RowData定死高度。2.3 spacing 与 margin 家族像素账要算清楚spacing管的是控件与控件之间的距离marginLeft / marginRight / marginTop / marginBottom管的是控件与容器边框的距离两者互不干扰、会叠加。默认值都是 3这个 3 在低分辨率屏幕上勉强能看在高 DPI 屏上会显得特别局促所以我一般统一调成 6~8。这里有个历史遗留问题老代码里常见marginWidth和marginHeight这两个字段在较新的 SWT 版本里已经废弃它们会映射成marginLeft marginRight和marginTop marginBottom。也就是说你写layout.marginWidth 10实际效果是左右各 10。新代码别再用了直接写四个方向语义清楚也不会因为版本差异行为不一致。具体怎么估一个工具栏的宽度拿我上周做的一个筛选条举例8 个按钮实测平均宽度 92 像素spacing 6左右margin各 12。那么单行总宽 12 92×8 6×7 12 790。此时如果外壳宽度是 600可用宽度 600 - 24 576每个按钮间距占 98576 ÷ 98 ≈ 5.8也就是第一行能放 5 个剩下 3 个折到第二行。这个估算不需要精确但能让你在写代码前就知道窗口默认尺寸该给多少省掉反复试的功夫。高度同理单行时容器内容高 按钮高 marginTopmarginBottom。按钮高 26、上下 margin 各 12就是 50。如果外面还套了GridLayout的单元格记得把 50 这个数填进GridData.heightHint否则会被别的控件挤变形。提示改完 margin 之后一定要调shell.layout(true, true)true的第二个参数表示连同子容器一起重排只调layout()无参版本嵌套容器里的布局可能不刷新。3. RowData把单个控件从集体宿舍里拎出来3.1 三个字段怎么用RowLayout给每个控件统一规则RowData给单个控件开后门。它只有三个字段width、height、exclude。width和height一旦设了非默认值SWT.DEFAULT就会覆盖控件自己算出来的尺寸。这一点特别重要RowData的优先级高于computeSize()所以你可以用它强行把一个按钮压成 60 像素宽也可以把一个Label撑到 200 像素高让它和旁边的多行文本对齐。exclude是最被低估的一个。设成true之后这个控件依然显示但不参与布局计算——它不占位置后面的控件会补上来。这跟setVisible(false)完全不是一回事setVisible(false)只是看不见位置还留着界面会出现一个诡异的空洞。所以动态显示/隐藏控件在RowLayout里的标准姿势是两个都做Button extra new Button(shell, SWT.PUSH); extra.setText(高级设置); RowData rd new RowData(); rd.width 96; rd.height 26; rd.exclude true; // 初始不占位 extra.setLayoutData(rd); extra.setVisible(false); // 初始不可见 // 某个开关触发时 boolean show advanced.getSelection(); extra.setVisible(show); rd.exclude !show; // 改同一个 RowData 实例即可 shell.layout(true, true);注意这里我改的是同一个RowData实例而不是new一个新的塞回去。原因在下一节。3.2 为什么不能每次 new 一个 RowData这是我在老代码里见过最多的错误写法// 错误示范 button.setLayoutData(new RowData(96, 26)); // 后来某处又写 button.setLayoutData(new RowData()); // 想把尺寸恢复默认第二行确实把尺寸恢复了但同时也把之前所有通过RowData设置的属性包括exclude全部冲掉了。更麻烦的是RowLayout内部在计算时会去读每个控件的layoutData如果类型不是RowData比如你手滑塞了个GridData进去运行时会直接抛ClassCastException异常信息还特别隐晦只告诉你类转换失败不告诉你是哪个容器惹的祸。我的习惯是一个控件的RowData只创建一次之后所有修改都改字段。动态场景下我会把它存成字段或者用MapControl, RowData缓存起来MapControl, RowData dataCache new HashMap(); RowData rd dataCache.computeIfAbsent(ctrl, c - { RowData d new RowData(); d.width 96; d.height 26; return d; }); rd.exclude !visible; ctrl.setVisible(visible);多写三行省下两小时排查。3.3 混合控件时的垂直对齐RowLayout有个让人抓狂的行为它不做垂直对齐。一行里有高有矮的控件它们全部贴着行的顶部排。你放一个 26 像素高的按钮和一个 60 像素高的多行文本框按钮会顶在最上面下面空出 34 像素看起来像布局没做完。解决办法只有两个。第一用RowData把矮的控件高度设成和高的那个一致或者用SWT.CENTER样式在某些控件上产生居中效果但支持得很有限。第二更稳妥的做法是——把这一行拆成一个子Composite子容器用GridLayout做垂直居中外层RowLayout只负责排列这个子容器。听起来绕但真写过几次之后就习惯了RowLayout嵌套GridLayout是很常见的组合拳。还有一个反直觉的点filltrue时控件会被拉到行高但如果行里某个控件设了RowData.height行高会按最大值算而不是按你设的那个值算。所以给一个控件设高等于同时给整行所有开了fill的控件设高。这个联动关系经常被忽略导致我只改了一个控件的高度怎么整排都变了。4. 从零手搓一个能自适应的筛选工具条4.1 需求与骨架假设要做一个这样的东西顶部一排筛选控件关键词输入、类别下拉、日期区间、几个快捷按钮窗口拉窄时自动折行窗口拉宽时排成一行底部右侧还要有一个对齐到右边的重置按钮。这个需求用RowLayout做代码量大概 60 行。先搭骨架。SWT 程序的固定套路是Display→Shell→ 设置布局 → 添加控件 →open()→ 事件循环public class FilterBarDemo { public static void main(String[] args) { Display display new Display(); Shell shell new Shell(display); shell.setText(筛选工具条 - RowLayout 示例); shell.setSize(720, 180); RowLayout layout new RowLayout(); layout.wrap true; layout.pack true; layout.fill true; layout.justify false; layout.spacing 6; layout.marginLeft 12; layout.marginRight 12; layout.marginTop 12; layout.marginBottom 12; shell.setLayout(layout); buildContent(shell); shell.open(); while (!shell.isDisposed()) { if (!display.readAndDispatch()) { display.sleep(); } } display.dispose(); } }这段的关键在fill true开关打开之后同一行里所有控件的高度会被统一按钮和输入框看起来才齐。justify false是刻意的因为我要在最后手动控制重置按钮的位置用justify会把它和前面的控件全部拉开反而乱。4.2 控件构建与尺寸覆写接下来往里填控件。这里我把每个控件的RowData都显式设一遍图的就是行为确定private static void buildContent(Shell shell) { Label lblKey new Label(shell, SWT.NONE); lblKey.setText(关键词); lblKey.setLayoutData(size(SWT.DEFAULT, 26)); Text txtKey new Text(shell, SWT.BORDER); txtKey.setLayoutData(size(180, 26)); Label lblCat new Label(shell, SWT.NONE); lblCat.setText(类别); lblCat.setLayoutData(size(SWT.DEFAULT, 26)); Combo cmbCat new Combo(shell, SWT.READ_ONLY); cmbCat.setItems(new String[]{全部, 订单, 退款, 对账}); cmbCat.select(0); cmbCat.setLayoutData(size(110, 26)); Label lblRange new Label(shell, SWT.NONE); lblRange.setText(日期); lblRange.setLayoutData(size(SWT.DEFAULT, 26)); DateTime dtFrom new DateTime(shell, SWT.DATE | SWT.DROP_DOWN); dtFrom.setLayoutData(size(130, 26)); Label dash new Label(shell, SWT.NONE); dash.setText(至); dash.setLayoutData(size(SWT.DEFAULT, 26)); DateTime dtTo new DateTime(shell, SWT.DATE | SWT.DROP_DOWN); dtTo.setLayoutData(size(130, 26)); Button btnQuery new Button(shell, SWT.PUSH); btnQuery.setText(查询); btnQuery.setLayoutData(size(80, 26)); Button btnReset new Button(shell, SWT.PUSH); btnReset.setText(重置); btnReset.setLayoutData(size(80, 26)); } private static RowData size(int w, int h) { RowData rd new RowData(); rd.width w; rd.height h; return rd; }这里有个细节值得单独说RowData.width SWT.DEFAULT和width 0完全不是一回事。SWT.DEFAULT值是 -1表示用控件自己算出来的宽度0表示真的给它 0 像素宽——控件会被压成一条线肉眼几乎看不见但布局里还留着spacing的缝隙排查起来极其迷惑。我见过有人误写成 0然后花一晚上找为什么按钮消失了。另外DateTime控件在不同平台上的首选宽度差异很大macOS 和 Windows 风格不一样所以必须显式定宽否则折行位置会不一致。这就是为什么我把所有控件的尺寸都写死——在RowLayout里确定性的尺寸比让它自己算更重要因为你无法预判computeSize()在不同主题下会返回什么。4.3 折行行为实测与窗口尺寸设定代码跑起来之后我做了几组实测记录如下按钮平均宽 80spacing 6左右 margin 各 12外壳宽度可用宽度单行容纳实际行数观察320296约 2 个控件6 行以上严重折行建议设最小宽度480456约 4 个控件4 行可用但显得挤640616约 6 个2~3 行比较舒服720696约 7 个2 行默认尺寸推荐10241000全部 10 个1 行一行排完右侧留白从表里能看出来RowLayout的折行是逐控件贪心的不做全局平衡。也就是说可能出现第一行满满当当、第二行只有两个控件的孤儿行。如果你介意这个只能自己算好宽度或者干脆接受它——毕竟工具栏这种场景用户对孤儿行宽容度很高。还有一件事必须做给Shell设最小尺寸。RowLayout不会阻止你把它拖到 100 像素宽那时候每个控件都折成单独一行界面上会竖着排一长串很难看。shell.setMinimumSize(480, 140);这一行代码能省掉 80% 的用户把窗口拖成一条线然后来投诉的问题。setMinimumSize在部分老版本平台上对Shell生效有限制稳妥一点的做法是在SWT.Resize里判断客户端宽高小于阈值就强行setSize回去。5. 常见问题与排查实录5.1 问题速查表把我在项目里遇到过的问题整理成表遇到症状直接查症状大概率原因处理办法布局完全不生效控件挤在左上角忘记parent.setLayout(...)或没调layout()设布局后调用shell.layout(true, true)运行时报ClassCastException父容器用RowLayout子控件塞了GridData检查所有setLayoutData的类型控件隐藏后留下空洞只调了setVisible(false)没设excludeRowData.exclude true并重排按钮被拉成面条justify true或fill true误开关掉重试逐个排除折行不生效wrap false或父容器宽度未定检查wrap父容器给确定宽度ScrolledComposite 内不折行内容Composite宽度没跟随视口监听getClientArea变化重设setMinSize高 DPI 屏下间距过小固定像素值未按缩放系数换算用display.getDPI()做缩放控件顺序错乱多个线程操作 UI所有 UI 操作切回Display线程修改RowData后界面不变只改了对象没触发重排改完调layout(true, true)表里最后一条值得强调RowData是个普通 POJO改它的字段不会自动触发任何事件。RowLayout只在 layout 的时候才去读这些值。所以我明明把exclude设成true了怎么没反应——八成是忘了重排。5.2 ScrolledComposite 里折行失效的完整解法这个坑我踩过两次第二次才彻底搞明白。现象是ScrolledComposite里放一个RowLayout(wraptrue)的内容容器窗口拉窄内容容器不会跟着变窄控件永远排一行然后出现横向滚动条。根本原因是ScrolledComposite里的内容Composite需要自己知道自己该多宽。它默认会按computeSize(SWT.DEFAULT, SWT.DEFAULT)算出一个一条线排到底的宽度这个宽度远超视口于是ScrolledComposite就给你横向滚动条而不是让内容变窄折行。正确姿势是在视口尺寸变化时把内容宽度重新设给内容容器ScrolledComposite sc new ScrolledComposite(parent, SWT.V_SCROLL); sc.setExpandHorizontal(true); sc.setExpandVertical(false); Composite content new Composite(sc, SWT.NONE); RowLayout rl new RowLayout(); rl.wrap true; rl.spacing 8; rl.marginLeft 8; rl.marginRight 8; content.setLayout(rl); // 填充内容 for (int i 0; i 60; i) { Label tag new Label(content, SWT.BORDER); tag.setText(标签项 i); tag.setLayoutData(new RowData(110, 28)); } sc.setContent(content); // 关键跟随视口宽度重算 Runnable reflow () - { int w sc.getClientArea().width; if (w 0) return; content.setSize(content.computeSize(w, SWT.DEFAULT)); sc.setMinSize(content.computeSize(w, SWT.DEFAULT)); }; sc.addListener(SWT.Resize, e - reflow.run()); sc.getVerticalBar().addListener(SWT.Selection, e - reflow.run()); reflow.run();要点有三个。第一setExpandHorizontal(true)让内容跟着视口水平扩展。第二content.setSize(...)传的宽度必须是视口宽度而不是SWT.DEFAULT。第三加SWT.Resize监听否则窗口缩放之后不会重新折行。这三条少一条表现都不一样少第一条内容不跟着宽少第二条永远排一行少第三条缩放后不刷新。注意computeSize的第二个参数传SWT.DEFAULT让高度按内容自适应。如果你硬编码高度滚动条的拇指大小会算错滚到一半就卡住。5.3 几个我自己攒下来的小技巧第一别在RowLayout里直接放ToolBar。ToolBar有自己的布局逻辑SWT.FLAT、SWT.WRAP样式塞进RowLayout里会和一个普通控件一样只占首选宽度但它的内部项目不会跟着折行看起来半死不活。工具栏就用ToolBarToolItemRowLayout留给按钮条这种用Button拼的场景。第二改spacing的时候顺手看一眼marginWidth。老代码里这两个经常被一起写marginWidth的废弃会有编译警告但不会报错运行时行为也会变映射成左右各一半很容易出现我明明设了 10怎么看起来只有 5的错觉。第三做一个dumpLayout的调试方法。在排查布局问题时把容器里所有控件的getBounds()打印出来一眼就能看出哪个控件占了不该占的宽度private static void dumpLayout(Composite c) { for (Control ctrl : c.getChildren()) { System.out.printf(%-16s %s%n, ctrl.getClass().getSimpleName(), ctrl.getBounds()); } }getBounds()打印出来如果是(0, 0, 0, 0)说明这个控件压根没参与布局去查exclude如果宽度远远超出你的预期去查RowData.width是不是被别的代码覆盖了如果高度异常八成是fill和某个高控件联动导致的。第四垂直排列的RowLayout(SWT.VERTICAL)别配filltrue除非你想让每个按钮都横跨整个侧边栏。垂直模式下fill拉的是宽度侧边栏宽度 200按钮就会被拉成 200 宽看起来像一排扁扁的色块。真要做侧边导航宁可给按钮设RowData.width把fill关掉再配合RowData(height)统一高度。第五高 DPI 缩放要自己做。RowLayout的spacing、margin、RowData里的宽高全是原始像素不会自动跟着系统缩放走。在 150% 缩放的屏幕上你设的 6 像素间距看起来只有 4 像素界面会显得特别挤。稳妥的写法是从Display拿 DPI算一个缩放系数Display display Display.getCurrent(); int dpi display.getDPI().x; // 通常 96 double scale dpi / 96.0; // 150% 屏约等于 1.5 layout.spacing (int) Math.round(6 * scale); layout.marginLeft (int) Math.round(12 * scale);第六也是我最想说的一条RowLayout的参数最好不要散落在各处。我见过一个类里spacing被设置了三次分别在构造时、事件回调里、和某个初始化样式的方法里最后一次覆盖前一次谁也不知道最终值是多少。把布局参数的设置收敛到一个buildLayout()方法里其它地方只改RowData的字段出了问题只看一个地方就够。我个人在实际维护老界面时的体会是RowLayout的问题从来不是它能力不够而是它的默认值太保守、太不显眼。默认 3 像素的边距让人觉得它就那样fill和justify两个开关的名字又太像exclude藏在RowData里没几个人会去翻文档。把这些细节都摊开调一遍之后它在工具栏、标签流、条件筛选条这些场景里的性价比其实比手写GridLayout高不少——尤其是需要窄了就折行这种活的时候GridLayout得写一堆列数计算和空位填充RowLayout一行wrap true就完事了。
