IconicButton¶

Base icon + label button used by AppBar* / IconButton.

import QWinUI3.Extras · src/extras/QWinUI3/Extras/IconicButton.qml

Category: Buttons & commands · Library: v2.80

Gallery: IconicButton — src/gallery/pages/IconicButtonPage.qml

Extends AbstractButton.

Example¶

IconicButton {
    id: btn
    text: qsTr("Open")
    symbol: FluentIcons.Open
    onClicked: open()
}

Notes¶

Button with leading Fluent symbol + text. Prefer IconButton / AppBarButton for specialized layouts; this type is usable standalone. microMotionEnabled / hoverScale / pressScale / effectiveIconScale (1.49).

API¶

Properties¶

Name	Type	Description
`symbol`	`var`	FluentIcons symbol (preferred over iconGlyph)
`iconGlyph`	`string`	Raw Fluent glyph string fallback
`iconSize`	`real`	Icon size in px
`toolTipText`	`string`	Tooltip text
`badgeVisible`	`bool`	Show avatar badge
`badgeValue`	`int`	Numeric badge value (-1 hides count)
`badgeText`	`string`	Badge caption
`badgeMaxValue`	`int`	Badge max before +
`highlighted`	`bool`	Emphasized / selected chrome
`flat`	`bool`	Flat chrome without fill
`microMotionEnabled`	`bool`	WinUI-style glyph hover/press micro-motion (1.49); off when Theme.reducedMotion
`hoverScale`	`real`	Hover glyph scale when microMotionEnabled
`pressScale`	`real`	Pressed glyph scale when microMotionEnabled
`effectiveIconScale`	`real`	Resolved glyph scale (1 when reduced motion / disabled)
`effectiveIconGlyph`	`string`	Resolved glyph string

Signals¶

No custom signals (use inherited signals from the base type).

Methods¶

No custom methods (use inherited methods from the base type).

Inherited from `AbstractButton`¶

Also available (base type / Qt Quick Controls):

text
enabled
down / pressed / hovered
clicked()

Generated from module sources by scripts/generate_component_docs.py — do not edit by hand.