From Xojo Documentation
|You are currently browsing the old Xojo documentation site. Please visit the new Xojo documentation site!|
| This item was deprecated in version 2021r3.
Please use DesktopBevelButton as a replacement.
Supported PlatformsProject Types: Desktop Platforms: macOS, Windows, Linux
- For web apps, see WebButton.
Used for creating a bevel button. A BevelButton can use text, a graphic, a pop-up menu, or several of these interface elements in combination.
|On macOS, BevelButton is not a native control and does not automatically change its appearance in dark mode.|
A BevelButton can display a graphic, a label (caption), or both.
The "No Bevel" option for the BevelStyle property is functional only on Microsoft Windows. On platforms with cursor, the button appears to have no border until the cursor enters the bounds of the BevelButton control. Then the outline of the button appears. On non-Windows systems, the "No Bevel" option has the same appearance of "Small Bevel."
The following code places an icon in the BevelButton, aligns it, and specifies the position of the caption. The graphic, "DatabaseQueryIcon," has been added to the project.
Me.IconAlignment = BevelButton.IconAlignments.TopLeft
Me.CaptionAlignment = BevelButton.CaptionAlignments.Left
Me.CaptionPosition = BevelButton.CaptionPositions.RightOfIcon
Me.IconDeltaX = 2
Me.IconDeltaY = 1
The following code creates a bevel button menu.
me.Caption = "Month"
me.CaptionAlignment = BevelButton.CaptionAlignments.Left
me.MenuStyle = BevelButton.MenuStyles.Right
Var myMenu As New MenuItem
For Each m As String In months
me.Menu = myMenu
The following line of code in the BevelButton's MenuSelected event handler sets the BevelButton caption to the value that the user selects: