AbstractButton QML Type
Tipo base abstracto que proporciona 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 comportamiento similar al de un botón; por ejemplo, botones pulsadores y controles seleccionables como botones de radio y casillas de verificación. Como control abstracto, no tiene implementaciones delegadas, dejándolas a 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 indica si la autoexclusividad está activada.
Si la autoexclusividad está activada, los botones seleccionables que pertenecen al mismo elemento padre se comportan como si formaran parte del mismo ButtonGroup. Sólo se puede marcar un botón a la vez; si se marca otro botón, automáticamente se desmarca el que estaba marcado anteriormente.
Nota: La propiedad no tiene efecto en los botones que pertenecen a un elemento ButtonGroup.
RadioButton y TabButton son autoexcluyentes por defecto.
autoRepeat : bool
Esta propiedad mantiene si el botón repite las señales pressed(), released() y clicked() mientras se mantiene pulsado el botón.
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 en autoRepeatDelay y autoRepeatInterval.
autoRepeatDelay : int [since QtQuick.Controls 2.4 (Qt 5.11)]
Esta propiedad contiene el retardo inicial de la auto-repetición en milisegundos. El valor por defecto es 300 ms.
Esta propiedad se introdujo en QtQuick.Controls 2.4 (Qt 5.11).
Ver también autoRepeat y autoRepeatInterval.
autoRepeatInterval : int [since QtQuick.Controls 2.4 (Qt 5.11)]
Esta propiedad contiene el intervalo de auto-repetición en milisegundos. El valor por defecto es 100 ms.
Esta propiedad se introdujo en QtQuick.Controls 2.4 (Qt 5.11).
Ver también autoRepeat y autoRepeatDelay.
checkable : bool
Esta propiedad indica si el botón es seleccionable.
Un botón checkable cambia entre checked (activado) y unchecked (desactivado) cuando el usuario hace clic sobre é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, establecer esta propiedad ya no afecta a la propiedad checkable. Establezca 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 icon y text dentro del botón.
| Mostrar | Resultado |
|---|---|
AbstractButton.IconOnly |
|
AbstractButton.TextOnly |
|
AbstractButton.TextBesideIcon (por defecto) |
|
AbstractButton.TextUnderIcon |
|
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Ver también spacing y padding.
down : bool
Esta propiedad mantiene si el botón está visualmente hacia abajo.
A menos que se establezca explícitamente, esta propiedad sigue el valor de pressed. Para volver al valor por defecto, establezca esta propiedad a 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 a utilizar. El icono se cargará desde el tema de la plataforma. Si el icono se encuentra en el tema, siempre se utilizará, incluso si icon.source también está configurado. Si no se encuentra el icono, se utilizará icon.source en su lugar. Para más información sobre iconos de temas, véase QIcon::fromTheme(). |
| fuente | Esta propiedad contiene el nombre del icono a utilizar. El icono se cargará como una imagen normal. Si icon.name está definida y se refiere a un icono de tema válido, siempre se utilizará en lugar de esta propiedad. |
| anchura | Esta propiedad contiene la anchura del icono. La anchura del icono nunca superará este valor, aunque se reducirá cuando sea necesario. |
| altura | Esta propiedad contiene la altura del icono. La altura del icono nunca superará este valor, aunque se reducirá cuando sea necesario. |
| color | Esta propiedad contiene el color del icono. El icono se tiñe con el color especificado, a menos que el color sea |
| caché | Esta propiedad especifica si el icono debe ser almacenado en caché. El valor por defecto es true. Para más información, consulte cache. Esta propiedad se introdujo en QtQuick.Controls 2.13. |
Estas propiedades se introdujeron en QtQuick.Controls 2.3.
Véase también text, display, e Icons en Qt Quick Controls.
implicitIndicatorHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Esta propiedad contiene la altura del indicador implícito.
El valor es igual a indicator ? indicator.implicitHeight : 0.
Se utiliza normalmente, 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.
Se utiliza normalmente, 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 en los movimientos táctiles, pero se deja intacto después de soltar el toque.
Esta propiedad se introdujo en QtQuick.Controls 2.4 (Qt 5.11).
Ver 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 en los movimientos táctiles, pero se deja intacto después de soltar el toque.
Esta propiedad se introdujo en QtQuick.Controls 2.4 (Qt 5.11).
Ver también pressX.
pressed : bool [read-only]
Esta propiedad indica si el botón ha sido pulsado físicamente. Un botón puede ser presionado por 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 tiene sentido establecer una descripción textual aunque el elemento de contenido sea una imagen.
Véase también icon, display, y contentItem.
Documentación de la señal
canceled()
Esta señal se emite cuando el botón pierde el agarre del ratón mientras está siendo pulsado, o cuando emitiría la señal released pero el cursor del ratón no está dentro del botón.
Nota: El manejador correspondiente es onCanceled.
clicked()
Esta señal se emite cuando el botón es pulsado de forma interactiva por el usuario a través del tacto, el ratón o el teclado.
Nota: El manejador correspondiente es onClicked.
Véase también click(), animateClick(), y Llamar a una función C++ desde QML cuando se hace clic en un botón.
doubleClicked()
Esta señal se emite cuando el usuario hace doble clic en el botón de forma interactiva a través del tacto o 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 mediante el tacto o el ratón. No se emite cuando autoRepeat está activado.
Nota: El controlador correspondiente es onPressAndHold.
pressed()
Esta señal se emite cuando el usuario pulsa el botón de forma interactiva a través del 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 un botón seleccionable es pulsado interactivamente por el usuario mediante el tacto, el ratón o el teclado.
Nota: El manejador 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 la pulsación del botón, con un retardo de 100 milisegundos entre la pulsación y la liberación, animando su estado visual en el proceso.
Todas las señales asociadas a un clic se emiten según corresponda.
Si focusPolicy incluye Qt.ClickFocus, activeFocus se convertirá en true.
Esta función no hace nada si el botón es disabled.
Llamar de nuevo a esta función antes de soltar el botón reinicia el temporizador de liberación.
Este método se introdujo en Qt 6.8.
Ver también click(), pressed(), released(), y clicked().
[since Qt 6.8] void click()
Simula la pulsación de un botón sin retardo entre la pulsación y la liberación.
Todas las señales asociadas a un clic se emiten según corresponda.
Si focusPolicy incluye Qt.ClickFocus, activeFocus se convertirá en true.
Esta función no hace nada si el botón es disabled.
Llamar a esta función de nuevo antes de soltar el botón reinicia el temporizador de liberación.
Este método se introdujo en Qt 6.8.
Ver también animateClick(), pressed(), released(), y clicked().
void toggle()
Cambia el estado marcado 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.
