AbstractButton QML Type
Tipo base abstracto que proporciona la funcionalidad común a los botones. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: | |
| Inherited By: |
Propiedades
- action : Action
(since QtQuick.Controls 2.3 (Qt 5.10)) - autoExclusive : bool
- autoRepeat : bool
- autoRepeatDelay : int
(since QtQuick.Controls 2.4 (Qt 5.11)) - autoRepeatInterval : int
(since QtQuick.Controls 2.4 (Qt 5.11)) - checkable : bool
- checked : bool
- display : enumeration
(since QtQuick.Controls 2.3 (Qt 5.10)) - down : bool
- icon
(since QtQuick.Controls 2.3)- icon.cache : bool
(since QtQuick.Controls 2.3) - icon.color : color
(since QtQuick.Controls 2.3) - icon.height : int
(since QtQuick.Controls 2.3) - icon.name : string
(since QtQuick.Controls 2.3) - icon.source : url
(since QtQuick.Controls 2.3) - icon.width : int
(since QtQuick.Controls 2.3)
- icon.cache : bool
- implicitIndicatorHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitIndicatorWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - indicator : Item
- pressX : real
(since QtQuick.Controls 2.4 (Qt 5.11)) - pressY : real
(since QtQuick.Controls 2.4 (Qt 5.11)) - pressed : bool
- text : string
Señales
- canceled()
- clicked()
- doubleClicked()
- pressAndHold()
- pressed()
- released()
- toggled()
(since QtQuick.Controls 2.2 (Qt 5.9))
Métodos
- void animateClick()
(since Qt 6.8) - void click()
(since Qt 6.8) - void toggle()
Descripción detallada
AbstractButton proporciona la interfaz para controles con un comportamiento similar al de los botones; por ejemplo, botones de selección y controles que se pueden marcar, como botones de opción y casillas de verificación. Al tratarse de un control abstracto, no tiene implementaciones de delegados, lo que se deja en manos de los tipos que derivan de él.
Véase también « ButtonGroup » y «Controles de botón».
Documentación de propiedades
action : Action [since QtQuick.Controls 2.3 (Qt 5.10)]
Esta propiedad contiene la acción del botón.
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también Action.
autoExclusive : bool
Esta propiedad determina si la exclusividad automática está activada.
Si la exclusividad automática está activada, los botones seleccionables que pertenecen al mismo elemento padre se comportan como si formaran parte del mismo « ButtonGroup ». Solo se puede seleccionar un botón a la vez; al seleccionar otro botón, el que estaba seleccionado anteriormente se deselecciona automáticamente.
Nota: La propiedad no tiene ningún efecto sobre los botones que pertenecen a un « ButtonGroup ».
RadioButton y « TabButton » son autoexclusivos por defecto.
autoRepeat : bool
Esta propiedad determina si el botón repite las señales « pressed()», « released()» y « clicked()» mientras se mantiene pulsado.
Si esta propiedad se establece en true, la señal pressAndHold() no se emitirá.
El valor por defecto es « false ».
El retardo inicial y el intervalo de repetición se definen en milisegundos mediante « autoRepeatDelay » y « autoRepeatInterval ».
autoRepeatDelay : int [since QtQuick.Controls 2.4 (Qt 5.11)]
Esta propiedad almacena el retraso inicial de la repetición automática en milisegundos. El valor por defecto es 300 ms.
Esta propiedad se introdujo en QtQuick.Controls 2.4 (Qt 5.11).
Véase también autoRepeat y autoRepeatInterval.
autoRepeatInterval : int [since QtQuick.Controls 2.4 (Qt 5.11)]
Esta propiedad almacena el intervalo de repetición automática en milisegundos. El valor por defecto es 100 ms.
Esta propiedad se introdujo en QtQuick.Controls 2.4 (Qt 5.11).
Véase también autoRepeat y autoRepeatDelay.
checkable : bool
Esta propiedad indica si el botón es seleccionable.
Un botón que se puede marcar alterna entre marcado (activado) y desmarcado (desactivado) cuando el usuario hace clic en él o pulsa la barra espaciadora mientras el botón tiene el foco activo.
El valor por defecto es « false ».
Véase también checked.
checked : bool
Esta propiedad indica si el botón está marcado.
Desde Qt 6.2, al establecer esta propiedad ya no se ve afectada la propiedad « checkable ». Establece explícitamente la propiedad « checkable » si es necesario.
Véase también checkable.
display : enumeration [since QtQuick.Controls 2.3 (Qt 5.10)]
Esta propiedad determina cómo se muestran los valores de « icon » y « text » dentro del botón.
| Visualización | Resultado |
|---|---|
AbstractButton.IconOnly |
|
AbstractButton.TextOnly |
|
AbstractButton.TextBesideIcon (por defecto) |
|
AbstractButton.TextUnderIcon |
|
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también spacing y padding.
down : bool
Esta propiedad indica si el botón se encuentra visualmente pulsado.
A menos que se establezca explícitamente, esta propiedad adopta el valor de « pressed ». Para volver al valor predeterminado, establezca esta propiedad en « undefined ».
Véase también « pressed ».
icon group
icon.cache : bool [since QtQuick.Controls 2.3]
icon.color : color [since QtQuick.Controls 2.3]
icon.height : int [since QtQuick.Controls 2.3]
icon.name : string [since QtQuick.Controls 2.3]
icon.source : url [since QtQuick.Controls 2.3]
icon.width : int [since QtQuick.Controls 2.3]
| Nombre | Descripción |
|---|---|
| nombre | Esta propiedad contiene el nombre del icono que se va a utilizar. El icono se cargará desde el tema de la plataforma. Si se encuentra el icono en el tema, siempre se utilizará, incluso si también se ha establecido « icon.source ». Si no se encuentra el icono, se utilizará en su lugar « icon.source ». Para obtener más información sobre los iconos de los temas, consulta QIcon::fromTheme(). |
| fuente | Esta propiedad contiene el nombre del icono que se va a utilizar. El icono se cargará como una imagen normal. Si se ha definido ` icon.name ` y hace referencia a un icono de tema válido, siempre se utilizará este en lugar de la propiedad. |
| anchura | Esta propiedad indica el ancho del icono. El ancho del icono nunca superará este valor, aunque se reducirá cuando sea necesario. |
| altura | Esta propiedad establece la altura del icono. La altura del icono nunca superará este valor, aunque se reducirá cuando sea necesario. |
| color | Esta propiedad indica el color del icono. El icono se tiñe con el color especificado, a menos que el color se establezca en « |
| caché | Esta propiedad especifica si el icono debe almacenarse en caché. El valor por defecto es «true». Para obtener más información, consulta cache. Esta propiedad se introdujo en la versión 2.13 de QtQuick.Controls. |
Estas propiedades se introdujeron en QtQuick.Controls 2.3.
Véase también text, display e «Iconos en los controles de Qt Quick ».
implicitIndicatorHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene el indicador implícito «height».
El valor es igual a indicator ? indicator.implicitHeight : 0.
Normalmente se utiliza, junto con « implicitContentHeight » y « implicitBackgroundHeight », para calcular el « implicitHeight ».
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también implicitIndicatorWidth.
implicitIndicatorWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene el ancho implícito del indicador.
El valor es igual a indicator ? indicator.implicitWidth : 0.
Normalmente se utiliza, junto con « implicitContentWidth » y « implicitBackgroundWidth », para calcular el « implicitWidth ».
Esta propiedad se introdujo en QtQuick.Controls 2.5 (Qt 5.12).
Véase también implicitIndicatorHeight.
indicator : Item
Esta propiedad contiene el elemento indicador.
pressX : real [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]
Esta propiedad contiene la coordenada x de la última pulsación.
Nota: El valor se actualiza al desplazar el dedo, pero permanece intacto al levantar el dedo.
Esta propiedad se introdujo en QtQuick.Controls 2.4 (Qt 5.11).
Véase también pressY.
pressY : real [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]
Esta propiedad contiene la coordenada y de la última pulsación.
Nota: El valor se actualiza al desplazar el dedo, pero permanece inalterado al levantar el dedo.
Esta propiedad se introdujo en QtQuick.Controls 2.4 (Qt 5.11).
Véase también pressX.
pressed : bool [read-only]
Esta propiedad indica si el botón está pulsado físicamente. Un botón puede pulsarse mediante eventos táctiles o de teclado.
Véase también down.
text : string
Esta propiedad contiene una descripción textual del botón.
Nota: El texto se utiliza con fines de accesibilidad, por lo que conviene establecer una descripción textual incluso si el elemento de contenido es una imagen.
Véase también icon, display y contentItem.
Documentación de Signal
canceled()
Esta señal se emite cuando el botón pierde el control del ratón mientras está pulsado, o cuando emitiría la señal « released », pero el cursor del ratón no se encuentra dentro del botón.
Nota: El controlador correspondiente es onCanceled.
clicked()
Esta señal se emite cuando el usuario pulsa el botón de forma interactiva mediante la pantalla táctil, el ratón o el teclado.
Nota: El controlador correspondiente es onClicked.
Véase también click(), animateClick() y «Llamar a una función de C++ desde QML al hacer clic en un botón».
doubleClicked()
Esta señal se emite cuando el usuario hace doble clic de forma interactiva en el botón, ya sea con el dedo o con el ratón.
Nota: El controlador correspondiente es onDoubleClicked.
pressAndHold()
Esta señal se emite cuando el usuario pulsa y mantiene pulsado el botón de forma interactiva, ya sea con el dedo o con el ratón. No se emite cuando está activada la opción « autoRepeat ».
Nota: El controlador correspondiente es onPressAndHold.
pressed()
Esta señal se emite cuando el usuario pulsa el botón de forma interactiva mediante el tacto, el ratón o el teclado.
Nota: El controlador correspondiente es onPressed.
released()
Esta señal se emite cuando el usuario suelta el botón de forma interactiva mediante el tacto, el ratón o el teclado.
Nota: El controlador correspondiente es onReleased.
[since QtQuick.Controls 2.2 (Qt 5.9)] toggled()
Esta señal se emite cuando el usuario activa o desactiva de forma interactiva un botón de casilla de selección mediante el tacto, el ratón o el teclado.
Nota: El controlador correspondiente es onToggled.
Esta señal se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
Documentación del método
[since Qt 6.8] void animateClick()
Simula que se pulsa el botón, con un retraso de 100 milisegundos entre la pulsación y la liberación, animando su estado visual durante el proceso.
Se emiten todas las señales asociadas a un clic según corresponda.
Si el « focusPolicy » incluye « Qt.ClickFocus », « activeFocus » pasará a ser « true ».
Esta función no realiza ninguna acción si el botón tiene el estado « disabled ».
Si se vuelve a llamar a esta función antes de soltar el botón, se reinicia el temporizador de liberación.
Este método se introdujo en Qt 6.8.
Véase también click(), pressed(), released() y clicked().
[since Qt 6.8] void click()
Simula que se pulsa el botón sin que haya ningún retraso entre la pulsación y la liberación.
Se emiten todas las señales asociadas a un clic según corresponda.
Si el « focusPolicy » incluye « Qt.ClickFocus », « activeFocus » pasará a ser « true ».
Esta función no realiza ninguna acción si el botón está en estado « disabled ».
Si se vuelve a llamar a esta función antes de soltar el botón, se reinicia el temporizador de liberación.
Este método se introdujo en Qt 6.8.
Véase también animateClick(), pressed(), released() y clicked().
void toggle()
Activa o desactiva el estado de selección del botón.
Véase también click() y animateClick().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
