例如由美工提供左边的按钮背景图,我们需要实现右边的效果,并且背景随着按钮的大小自动变化:

圆角按钮背景
圆角按钮效果

qt QSS   border-image_缩放
qt QSS   border-image_缩放_02

前面我们学习过的和修改背景相关的知识有 background-image,如果背景图和按钮一样大时使用 background-image 没有任何问题,但是当按钮和背景图不一样大时,背景图要么显示不全,要么重复平铺到按钮上,显然满足不了这里的需求。不过 QSS 也支持 border-image,使用 border-image 就能很快的做出上面的效果:


.QPushButton {
border-width: 12px 12px 12px 12px;
border-image: url(:/img/round-button.png) 12 12 12 12 repeat stretch;

min-height: 24px; /* 避免按钮太小 */
padding: -10px 0 -10px 0; /* 调整文字与边界的距离 */
}

border-width 后面的四个数字按顺序分别为:

  1. border-top 的高 12px
  2. border-right 的宽 12px
  3. border-bottom 的高 12px
  4. border-left 的宽 12px

border-image 后面的参数按顺序分别为:

  1. 背景图的路径,可以是绝对路径,相对路径,资源文件里的路径
  2. 四个数字按顺序分别为
    1. 背景图中 最上面的 12px 高的图像 填充到 Widget 的 border-top
    2. 背景图中 最右边的 12px 宽的图像 填充到 Widget 的 border-right
    3. 背景图中 最下边的 12px 高的图像 填充到 Widget 的 border-bottom
    4. 背景图中 最左边的 12px 宽的图像 填充到 Widget 的 border-left
  3. 数字后面的第一个参数 repeat|round|stretch 指定 水平方向的缩放或者平铺
  4. 数字后面的第二个参数 repeat|round|stretch 指定 垂直方向的缩放或者平铺

注意
border-width 后的数字有单位
border-image 后的数字没有单位
min-heightpadding 不是必须的,这里用来细微的调节按钮的效果

Border-Image 从名字上看,像是用来图片来设置 border 的,其实是用图片来设置整个 widget 的背景的,我曾经就被这个名字迷惑过


Border-Image 原理

下图是理解 Border-Image 的核心,又称为九宫格,看懂这个图,也就能理解 Border-Image 了:

背景图
Widget

qt QSS   border-image_圆角_03
qt QSS   border-image_相对路径_04



http://qtdebug.com/qtbook-qss-border-image/