ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Button control
  • Overview
  • Images associated with a Button control in a window
  • Overview
  • Special case: images to manage the Button control states
  • Animations in the Button control
  • Image and text positioning
  • Customize the shape of the Button control via the style options
  • Images associated with a button in a page
  • Advanced configuration of images
  • Configuring the display mode (button in a window)
  • Image of multilingual button
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Images and buttons
Overview
WINDEV, WEBDEV and WINDEV Mobile include many features to improve the appearance of applications and sites.
Universal Windows 10 AppAndroidiPhone/iPad In a window, you can:
  • use images in Button controls. These images can:
    • define the different states of the control.
    • be animated.
    • be positioned relative to the text displayed in the control.
    • be used to define the shape of the control.
  • Define shadows on the boders of Button controls.
Most of these options can be defined in the "General" and "Style" tabs of the control description window.
Universal Windows 10 AppAndroidAndroid Widget iPhone/iPad
Images associated with a Button control in a window

Overview

In a window, you have two options to define the image associated with a Button control:
  • image: this image will appear over the button, regardless of its shape.
    Example: Button control with an image and without border:
    Tip: For best results, the image should be 5 pixels smaller than the Button control (horizontally and vertically).
  • image of button border: this image is used to easily redefine the button shape. For example:
These images are selected in the control description window ("General" tab):
Remarks:
  • The image library included with WINDEV or WINDEV Mobile allows you to choose the images (border and image) associated with the control. To open this library, expand the Drop-down button button and select "Catalog".
  • To edit the image options (display mode, symmetry, ...), expand the Drop-down button button and select "Display options, transparency, symmetry" (see Configuring the display mode (button in a window)).
  • Android Widget You can only set the image of the button border.

Special case: images to manage the Button control states

WINDEV and WINDEV Mobile allow you to manage the different button states: normal, pressed, grayed out, focused and hover. For more details, see States of a Button control.
If the states of a Button control are defined using images, you can:
  • use two images (image displayed in the control and image in the frame), each with 5 states. With this solution, you can use the same border image for multiple Button controls and use another image on top.
  • include the image displayed in the control directly in the border image. In this case, specify only the border image in the control description.
Idle, pressed, grayed out, selected, hovered button
Idle, pressed, grayed out, selected, hovered button
For a border image (and/or image displayed in the button) with multiple states, WINDEV allows you to:
  • stretch the image (if the Button control is larger than the image, for example). Several possibilities are available:
    • No stretching.
    • Stretch horizontally (3 images). The following criteria are used:
      • the image is divided into three sections
      • section 1 corresponds to the left area
      • section 3 corresponds to the right area
      • section 2 corresponds to the middle area. The size of this section is equal to 16 pixels. This section will be repeated as many times as necessary until the button image reaches the desired size.
    • Stretch horizontally and vertically.
    • Custom stretch with 9-slice scaling.

Animations in the Button control

You can also animate the images of Button controls. To do so, the Button control can:
  • use an animated image. In this case, the image displayed in the control will be animated (e.g., animated GIF). The animation is automatically managed.
  • use an image that will be animated by WINDEV or WINDEV Mobile. In this case, the image displayed in the control contains a set with all the drawings of the animation (the horizontal drawings represent the states of the button). The number of steps in the animation must be specified in the "General" tab of the description window of Button control.
AndroidAndroid Widget

Image and text positioning

When an image contains a caption and an icon (image), you have the ability to configure the relative position of image and text in the control style:
  1. Display the description window of Button control ("Description" in the context menu).
  2. Display the "Style" tab.
  3. Select the "Caption" element and configure the caption position via the "Position" option.
Universal Windows 10 AppAndroidAndroid Widget iPhone/iPad

Customize the shape of the Button control via the style options

You can configure the shape of the Button control via the style options.
To configure the shape of the Button control:
  1. Go to the "Style" tab of the control description window.
  2. Select the "Outside border" element.
  3. In "Border", select the desired border.
    • Click to configure the border (the configuration options are different depending on the type of border chosen).
    • Click (to the right of the "Border" option) to configure the shadow of the border. If a shadow is used, you can choose:
      • the X and Y offset of the shadow,
      • the percentage of opacity,
      • the blur radius,
      • the color of the shadow.
        Remark: Button controls that use the XP theme do not support shadows.
  4. Validate.
Remarks:
  • Some options are not visible if the button includes a border/background image.
  • You can choose specific borders for each state of the Button control: normal, hover, pressed, focused, grayed.
  • The "Round" border is used to get a round button. In this case:
    • the transparency is automatically supported.
    • The click is adapted to the shape: if the user clicks the corner of the control, outside the circle, the click is ignored.
  • The "Custom" option allows you to fully customize the borders by clicking the icon :
Images associated with a button in a page
Advanced configuration of images
Universal Windows 10 AppAndroidiPhone/iPad

Configuring the display mode (button in a window)

When describing the images of a button, you can configure the image display mode:
  1. Click Drop-down button.
  2. In the menu that is displayed, select "Display options, transparency, symmetry".
  3. In the window that is displayed, you can to configure:
    • the image display mode
    • its rotation
    • its transparency
    • its symmetry.
Remark: If the image is multilingual, this configuration applies to all languages.

Image of multilingual button

If your site or application is multilingual, a different button image can be selected for each language. This option is useful when the images associated with the button contain the caption of the button.
To manage multilingual images:
  1. Display the description of Button control.
  2. Click the Drop-down button button next to the image path.
  3. Select "Multilingual".
  4. The multilingual image management window opens. By default, the same file is associated with all the languages supported by the window or by the page.
  5. For each language, click the Drop-down button button. You can:
    • Select the image corresponding to the language on your computer ("Browse" option).
    • Select the image corresponding to the language in the image catalog ("Catalog" option).
    At runtime, the corresponding button image will be displayed depending on the language selected by Nation.
  6. Validate. The "Multilingual value" caption appears in the image name.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 04/07/2023

Send a report | Local help