- Qt Creator Documentation
- Create scalable buttons and borders
- Qt Creator 21.0.0-beta1

Create custom components ◦ Create shapes

# Create scalable buttons and borders

You can use the BorderImage component to display an image, such as a PNG file, as a border and a background.

Use two border images and suitable graphics to change the appearance of a button when it is clicked. You can use use states to determine which image is visible depending on whether the mouse button is pressed down. You could add more images and states to change the appearance of the button depending on other mouse events, such as hovered.

Use a Text component to add button text. You can use states also to change the button text color and font size. For example, you can scale the button text up or down.

Add a Mouse Area component that covers the whole area and reacts to mouse events.

## Create the button component

To create a button component, select File > New File > Qt Quick Files > Qt Quick UI File >

Choose to create a UI file called `Button.ui.qml` (for example).

Note: Components are listed in Components > My Components only if the filename begins with a capital letter.

## Construct the button component

To construct the button component:

1. Select Design to edit the UI file in the 2D view.
2. Select Assets > to copy the image files you want to use to the project folder.
3. In Navigator, select the root component and set the width (W) and height (H) of the button in the Properties view to match the size of the images you plan to use. This specifies the initial size of the button component.
4. Drag two Border Image components from Components > Default Components > Basic to the root component in Navigator.
5. Drag a Text component to the root component.
6. In Navigator, select the root component, and then select Add Mouse Area in the context menu to add a mouse area.
7. Select a border image to edit the values of its properties:
   1. In the Id field, enter an ID for the border image. In this example, we use the ID inactiveButton.
   2. In the Source field, select the image file for the border image. For example, `inactive_button.png`.
   3. In the Layout tab, select the (Fill to Parent) button to always make the image the same size as its parent. This makes the button component scalable because the image size is bound to the component size.
8. Select the other border image to edit the values of its properties similarly:
   1. In the Id field, enter activeButton.
   2. In the Source field, select the image file for the button when it is clicked. For example, `active_button.png`.
   3. In the Layout tab, select the (Fill to Parent) button.
9. Select the text component to specify font size and color in Properties:
   1. In the Color field, use the color picker to select the font color, or enter a value in the field.
   2. In Font group, Size field, enter the font size.
   3. In the Layout tab, select (Vertical Center) and (Horizontal Center) buttons to inherit the vertical and horizontal centering from the parent. This ensures that the button label is centered when the component is resized.

## Use states to change component property values

1. In the States view, select twice to create two new states.

2. Select State1.
3. Change the state name to active.
4. Select , and then select Set when Condition to determine when the state should be applied.
5. In the Binding Editor, select the `mouseArea` component and the `pressed` signal to specify that the state is applied when the mouse button is pressed down.

6. Select the text component in Navigator to specify that the text size is scaled up when the button is pressed down.
7. In Properties, select the Advanced section, and increase the value of the Scale property.
8. Select inactiveButton in Navigator to hide it in the active state by changing the value of its Visibility property in Properties.
9. Select State2.
10. Change the state name to inactive.
11. Set the when condition for the state to `!mouseArea.pressed` to specify that the state is applied when the mouse button is not pressed down.

12. Select Ctrl+S to save the button.
13. Select the Live Preview button on the top toolbar to see how the button behaves when you select it. Drag the preview window borders to see what happens when you resize the component.

To be useful, the button component has to be created in a project. When you work on other files in the project to create screens or other components for the UI, the button component appears in Components > My Components. You can drag it to the 2D or Navigator view to create button instances and modify the values of their properties to assign them useful IDs, change their appearance, and set the button text for each button instance, for example.

For more information about positioning buttons on screens, see Make layouts scalable.

See also How to: Use UI components, Qt Quick UI design, and Designing Qt Quick UIs.

Create custom components ◦ Create shapes