Qt Namespace

Documentación de tipos

enum Qt::AlignmentFlag
banderas Qt::Alineación

Este tipo enum se utiliza para describir la alineación. Contiene indicadores horizontales y verticales que pueden combinarse para producir el efecto deseado.

El enum TextElideMode también se puede utilizar en muchas situaciones para ajustar la apariencia del texto alineado.

Los indicadores horizontales son:

Las banderas verticales son:

Sólo puede utilizar una de las banderas horizontales a la vez. Hay una bandera bidimensional:

Puedes usar como máximo una bandera horizontal y una vertical a la vez. Qt::AlignCenter cuenta como horizontal y vertical.

Tres valores enum son útiles en aplicaciones que pueden ejecutarse en modo de derecha a izquierda:

Máscaras:

Las combinaciones conflictivas de flags tienen significados indefinidos.

El tipo Alignment es un typedef para QFlags<AlignmentFlag>. Almacena una combinación OR de valores AlignmentFlag.

enum Qt::AnchorPoint

Especifica un lado de un elemento de diseño que puede ser anclado. Se utiliza en QGraphicsAnchorLayout.

Véase también QGraphicsAnchorLayout.

enum Qt::ApplicationAttribute

Este enum describe atributos que cambian el comportamiento de las características de la aplicación. Se activan y desactivan con QCoreApplication::setAttribute(), y pueden comprobarse con QCoreApplication::testAttribute().

Cuando este atributo es verdadero Qt no hará el remapeo, y pulsar el modificador Command resultará en Qt::MetaModifier, mientras que pulsar el modificador Control resultará en Qt::ControlModifier.

Tenga en cuenta que las secuencias QKeySequence::StandardKey siempre se basarán en el mismo modificador (es decir, QKeySequence::Copy será Command+C independientemente del valor establecido), pero lo que se emita para QKeySequence::toString() será diferente.

enum Qt::ApplicationState
flags Qt::ApplicationStates

Este tipo enum se utiliza para especificar el estado actual de la aplicación.

Los estados son

El tipo ApplicationStates es un typedef para QFlags<ApplicationState>. Almacena una combinación OR de valores ApplicationState.

enum Qt::ArrowType

enum Qt::AspectRatioMode

Este tipo de enum define lo que ocurre con la relación de aspecto al escalar un rectángulo.

Véase también QSize::scale() y QImage::scaled().

enum Qt::Axis

Este tipo enum define tres valores para representar los tres ejes en el sistema de coordenadas cartesianas.

Véase también QTransform::rotate() y QTransform::rotateRadians().

enum Qt::BGMode

Modo de fondo:

enum Qt::BrushStyle

Este tipo enum define los estilos de pincel soportados por Qt, es decir, el patrón de relleno de las formas dibujadas usando QPainter.

Véase también QBrush.

enum Qt::CaseSensitivity

enum Qt::CheckState

Este enum describe el estado de los elementos comprobables, controles y widgets.

Véase también QCheckBox, Qt::ItemFlags, y Qt::ItemDataRole.

enum Qt::ChecksumType

Este enum describe los posibles estándares utilizados por qChecksum().

enum Qt::ClipOperation

enum class Qt::ColorScheme

Representa el aspecto del tema de una aplicación, definido por QGuiApplication::palette().

enum Qt::ConnectionType

Este enum describe los tipos de conexión que pueden utilizarse entre las señales y las ranuras. En particular, determina si una señal concreta se entrega a una ranura inmediatamente o se pone en cola para su entrega en un momento posterior.

Con las conexiones en cola, los parámetros deben ser de tipos conocidos por el sistema de meta-objetos de Qt, porque Qt necesita copiar los argumentos para almacenarlos en un evento entre bastidores. Si intentas usar una conexión en cola y obtienes el mensaje de error:

QObject::connect: Cannot queue arguments of type 'MyType'

Llame a qRegisterMetaType() para registrar el tipo de datos antes de establecer la conexión.

Si utilizas señales y ranuras con varios subprocesos, consulta Señales y ranuras entre subprocesos.

Véase también Multi-threading en Qt, QObject::connect(), qRegisterMetaType(), y Q_DECLARE_METATYPE().

enum Qt::ContextMenuPolicy

Este tipo enum define las distintas políticas que puede tener un widget respecto a mostrar un menú contextual.

[since 6.8] enum class Qt::ContextMenuTrigger

Este tipo enum define el evento de ratón utilizado para activar un evento de menú contextual.

Este enum se introdujo en Qt 6.8.

Véase también QStyleHints::contextMenuTrigger.

[since 6.10] enum class Qt::ContrastPreference

Representa la configuración de contraste preferida por el usuario. Los estilos pueden respetar esta configuración aumentando el contraste de los colores de primer plano y fondo, así como dando a los widgets y controles bordes más gruesos.

Este enum se introdujo en Qt 6.10.

enum Qt::CoordinateSystem

Este enum especifica el sistema de coordenadas.

enum Qt::Corner

Este tipo enum especifica una esquina en un rectángulo:

enum Qt::CursorMoveStyle

Este enum describe el estilo de movimiento disponible para los cursores de texto. Las opciones son

enum Qt::CursorShape

Este tipo enum define los distintos cursores que se pueden utilizar.

El cursor de flecha estándar es el predeterminado para los widgets en estado normal.

Constante	Valor	Descripción
Qt::ArrowCursor	0	El cursor de flecha estándar.
Qt::UpArrowCursor	1	Una flecha que apunta hacia arriba, hacia la parte superior de la pantalla.
Qt::CrossCursor	2	Un cursor en forma de cruz, utilizado normalmente para ayudar al usuario a seleccionar con precisión un punto de la pantalla.
Qt::WaitCursor	3	Un cursor de reloj de arena o de reloj, que suele mostrarse durante las operaciones que impiden al usuario interactuar con la aplicación.
Qt::IBeamCursor	4	Un cursor caret o ibeam, que indica que un widget puede aceptar y mostrar entradas de texto.
Qt::SizeVerCursor	5	Un cursor utilizado para los elementos que se utilizan para redimensionar verticalmente las ventanas de nivel superior.
Qt::SizeHorCursor	6	Un cursor utilizado para elementos que se utilizan para redimensionar horizontalmente ventanas de nivel superior.
Qt::SizeBDiagCursor	7	Un cursor utilizado para elementos que se utilizan para redimensionar diagonalmente ventanas de nivel superior en sus esquinas superior derecha e inferior izquierda.
Qt::SizeFDiagCursor	8	Un cursor utilizado para los elementos que se utilizan para redimensionar diagonalmente las ventanas de nivel superior en sus esquinas superior izquierda e inferior derecha.
Qt::SizeAllCursor	9	Un cursor utilizado para elementos que se utilizan para redimensionar ventanas de nivel superior en cualquier dirección.
Qt::BlankCursor	10	Un cursor en blanco/invisible, que suele utilizarse cuando es necesario ocultar la forma del cursor.
Qt::SplitVCursor	11	Un cursor utilizado para los divisores verticales, que indica que se puede arrastrar un tirador horizontalmente para ajustar el uso del espacio disponible.
Qt::SplitHCursor	12	Cursor utilizado para los divisores horizontales, que indica que se puede arrastrar verticalmente un tirador para ajustar el uso del espacio disponible.
Qt::PointingHandCursor	13	Un cursor en forma de mano que se utiliza normalmente para elementos en los que se puede hacer clic, como hipervínculos.
Qt::ForbiddenCursor	14	Un cursor que representa un círculo acuchillado, utilizado normalmente durante las operaciones de arrastrar y soltar para indicar que el contenido arrastrado no puede soltarse sobre determinados widgets o dentro de determinadas regiones.
Qt::OpenHandCursor	17	Un cursor que representa una mano abierta, utilizado normalmente para indicar que el área bajo el cursor es la parte visible de un lienzo en la que el usuario puede hacer clic y arrastrar para desplazarse.
Qt::ClosedHandCursor	18	Un cursor que representa una mano cerrada, utilizado normalmente para indicar que se está realizando una operación de arrastre que implica desplazamiento.
Qt::WhatsThisCursor	15	Una flecha con un signo de interrogación, que suele utilizarse para indicar la presencia de la ayuda ¿Qué es esto? de un widget.
Qt::BusyCursor	16	Un reloj de arena o un cursor de reloj, que suele mostrarse durante operaciones que permiten al usuario interactuar con la aplicación mientras se realizan en segundo plano.
Qt::DragMoveCursor	20	Un cursor que suele utilizarse al arrastrar un elemento.
Qt::DragCopyCursor	19	Un cursor que se utiliza normalmente cuando se arrastra un elemento para copiarlo.
Qt::DragLinkCursor	21	Cursor que se suele utilizar al arrastrar un elemento para establecer un vínculo con él.
Qt::BitmapCursor	24

enum Qt::DateFormat

Véase también QDate::toString(), QTime::toString(), QDateTime::toString(), QDate::fromString(), QTime::fromString(), y QDateTime::fromString().

enum Qt::DayOfWeek

enum Qt::DockWidgetArea
flags Qt::DockWidgetAreas

Representa las áreas a las que se puede acoplar un QDockWidget.

El tipo DockWidgetAreas es un typedef para QFlags<DockWidgetArea>. Almacena una combinación OR de valores DockWidgetArea.

Ver también QDockWidget::setAllowedAreas y QDockWidget::isAreaAllowed.

enum Qt::DropAction
flags Qt::DropActions

El tipo DropActions es un typedef para QFlags<DropAction>. Almacena una combinación OR de valores DropAction.

enum Qt::Edge
flags Qt::Edges

Este tipo enum especifica un borde en un rectángulo:

El tipo Edges es un typedef para QFlags<Edge>. Almacena una combinación OR de valores de Edge.

enum Qt::EnterKeyType

Puede utilizarse para modificar el aspecto de la tecla Retorno en un teclado en pantalla.

enum Qt::EventPriority

Este enum se puede utilizar para especificar las prioridades de los eventos.

Tenga en cuenta que estos valores se proporcionan únicamente por conveniencia, ya que las prioridades de eventos pueden ser cualquier valor entre INT_MAX y INT_MIN, ambos inclusive. Por ejemplo, puedes definir prioridades personalizadas como relativas entre sí:

enum CustomEventPriority
{
    // An important event
    ImportantEventPriority = Qt::HighEventPriority,

    // A more important event
    MoreImportantEventPriority = ImportantEventPriority + 1,

    // A critical event
    CriticalEventPriority = 100 * MoreImportantEventPriority,

    // Not that important
    StatusEventPriority = Qt::LowEventPriority,

    // These are less important than Status events
    IdleProcessingDoneEventPriority = StatusEventPriority - 1
};

Véase también QCoreApplication::postEvent().

enum Qt::FillRule

Especifica qué método debe utilizarse para rellenar los trazados y polígonos.

enum Qt::FindChildOption
flags Qt::FindChildOptions

El tipo FindChildOptions es un typedef para QFlags<FindChildOption>. Almacena una combinación OR de valores FindChildOption.

enum Qt::FocusPolicy

Este tipo enum define las distintas políticas que puede tener un widget con respecto a la adquisición del foco del teclado.

enum Qt::FocusReason

Este enum especifica por qué ha cambiado el foco. Se pasará a través de QWidget::setFocus y se puede recuperar en el QFocusEvent enviado al widget al cambiar el foco.

Ver también Enfoque de Teclado en Widgets.

enum Qt::GestureFlag
flags Qt::GestureFlags

Este tipo enum describe banderas adicionales que pueden usarse al suscribirse a un gesto.

El tipo GestureFlags es un typedef para QFlags<GestureFlag>. Almacena una combinación OR de valores GestureFlag.

Véase también QWidget::grabGesture() y QGraphicsObject::grabGesture().

enum Qt::GestureState

Este tipo enum describe el estado de un gesto.

Véase también QGesture.

enum Qt::GestureType

Este tipo enum describe los gestos estándar.

Los gestos definidos por el usuario se registran con la función QGestureRecognizer::registerRecognizer(), que genera un ID de gesto personalizado con el indicador Qt::CustomGesture activado.

Véase también QGesture, QWidget::grabGesture(), y QGraphicsObject::grabGesture().

enum Qt::GlobalColor

Objetos predefinidos de Qt QColor:

Véase también QColor.

Qt::HANDLE

Un tipo de manejador para objetos del sistema, definido como void * en todas las plataformas.

enum class Qt::HighDpiScaleFactorRoundingPolicy

Este enum describe las posibles políticas de redondeo del factor de escala High-DPI, que deciden cómo se manejan los factores de escala no enteros (como el 150% de Windows).

La política activa se establece llamando a QGuiApplication::setHighDpiScaleFactorRoundingPolicy() antes de crear el objeto de aplicación.

Véase también QGuiApplication::setHighDpiScaleFactorRoundingPolicy().

enum Qt::HitTestAccuracy

Este enum contiene los tipos de precisión que puede utilizar la clase QTextDocument al comprobar los clics del ratón en documentos de texto.

enum Qt::ImageConversionFlag
flags Qt::ImageConversionFlags

Las opciones marcadas "(por defecto)" se establecen si no se incluyen otros valores de la lista (ya que los valores por defecto son cero):

Preferencia Color/Mono (ignorada para QBitmap):

Modo de interpolación preferido:

Modo de interpolación preferido para máscaras alfa de 1 bit:

Preferencia de igualación de color frente a difuminado:

El tipo ImageConversionFlags es un typedef para QFlags<ImageConversionFlag>. Almacena una combinación OR de valores ImageConversionFlag.

enum Qt::InputMethodHint
flags Qt::InputMethodHints

Banderas que alteran el comportamiento:

Banderas que restringen la entrada (banderas exclusivas):

Máscaras:

El tipo InputMethodHints es un typedef para QFlags<InputMethodHint>. Almacena una combinación OR de valores InputMethodHint.

Véase también QGraphicsItem::inputMethodHints().

enum Qt::InputMethodQuery
flags Qt::InputMethodQueries

Máscaras:

El tipo InputMethodQueries es un typedef para QFlags<InputMethodQuery>. Almacena una combinación OR de valores InputMethodQuery.

Véase también QInputMethodQueryEvent.

enum Qt::ItemDataRole

Cada elemento del modelo tiene asociado un conjunto de elementos de datos, cada uno con su propia función. Los roles son utilizados por la vista para indicar al modelo qué tipo de datos necesita. Los modelos personalizados deben devolver datos en estos tipos.

Los roles de propósito general (y los tipos asociados) son:

Roles que describen la apariencia y los metadatos (con tipos asociados):

Roles de accesibilidad (con tipos asociados):

Roles de usuario:

Para los roles de usuario, depende del desarrollador decidir qué tipos utilizar y asegurarse de que los componentes utilizan los tipos correctos cuando acceden y establecen datos.

enum Qt::ItemFlag
flags Qt::ItemFlags

Este enum describe las propiedades de un ítem:

Tenga en cuenta que los elementos comprobables necesitan un conjunto adecuado de banderas y un estado inicial, indicando si el elemento está comprobado o no. Esto se gestiona automáticamente para los componentes modelo/vista, pero debe establecerse explícitamente para las instancias de QListWidgetItem, QTableWidgetItem, y QTreeWidgetItem.

Tenga en cuenta que es un comportamiento indefinido reimplementar QAbstractItemModel::hasChildren para que devuelva true para un índice si ese índice tiene el indicador Qt::ItemNeverHasChildren activado.

El tipo ItemFlags es un typedef para QFlags<ItemFlag>. Almacena una combinación OR de valores ItemFlag.

Véase también QAbstractItemModel.

enum Qt::ItemSelectionMode

Este enum se utiliza en QGraphicsItem, QGraphicsScene y QGraphicsView para especificar cómo se seleccionan los elementos, o cómo determinar si las formas y los elementos colisionan.

Véase también QGraphicsScene::items(), QGraphicsScene::collidingItems(), QGraphicsView::items(), QGraphicsItem::collidesWithItem() y QGraphicsItem::collidesWithPath().

enum Qt::ItemSelectionOperation

Este enum se utiliza en QGraphicsScene para especificar qué hacer con los elementos actualmente seleccionados al establecer un área de selección.

Véase también QGraphicsScene::setSelectionArea().

enum Qt::Key

Los nombres de las claves utilizadas por Qt.

Ver también QKeyEvent::key().

enum Qt::KeyboardModifier
flags Qt::KeyboardModifiers

Este enum describe las teclas modificadoras.

El tipo KeyboardModifiers es un typedef para QFlags<KeyboardModifier>. Almacena una combinación OR de valores KeyboardModifier.

Véase también MouseButton y Modifier.

enum Qt::LayoutDirection

Especifica la dirección de los diseños de Qt y el manejo del texto.

La maquetación de derecha a izquierda es necesaria en algunos idiomas, como el árabe y el hebreo.

LayoutDirectionAuto tiene dos propósitos. Cuando se utiliza junto con widgets y diseños, implicará el uso de la dirección de diseño establecida en el widget padre o QApplication. Esto tiene el mismo efecto que QWidget::unsetLayoutDirection().

Cuando LayoutDirectionAuto se utiliza junto con la maquetación de texto, implicará que la direccionalidad del texto se determina a partir del contenido de la cadena a maquetar.

Véase también QGuiApplication::setLayoutDirection(), QWidget::setLayoutDirection(), QTextOption::setTextDirection() y QString::isRightToLeft().

enum Qt::MaskMode

Este enum especifica el comportamiento de las funciones QPixmap::createMaskFromColor() y QImage::createMaskFromColor().

enum Qt::MatchFlag
flags Qt::MatchFlags

Este enum describe el tipo de coincidencias que se pueden utilizar al buscar elementos en un modelo.

El tipo MatchFlags es un typedef para QFlags<MatchFlag>. Almacena una combinación OR de valores MatchFlag.

Véase también QString::compare() y QRegularExpression.

enum Qt::Modificador
flags Qt::Modificadores

Este enum proporciona nombres más cortos para las teclas modificadoras de teclado soportadas por Qt.

El tipo Modifiers es un typedef para QFlags<Modifier>. Almacena una combinación OR de valores Modificadores.

Ver también KeyboardModifier y MouseButton.

enum Qt::MouseButton
flags Qt::MouseButtons

Este tipo enum describe los diferentes botones del ratón.

El tipo MouseButtons es un typedef para QFlags<MouseButton>. Almacena una combinación OR de valores MouseButton.

Ver también KeyboardModifier y Modifier.

enum Qt::MouseEventFlag
flags Qt::MouseEventFlags

Este enum proporciona información adicional relativa a un QMouseEvent.

El tipo MouseEventFlags es un typedef para QFlags<MouseEventFlag>. Almacena una combinación OR de valores MouseEventFlag.

enum Qt::MouseEventSource

Este enum describe la fuente de un evento de ratón y puede ser útil para determinar si el evento es un evento de ratón artificial originado desde otro dispositivo como una pantalla táctil.

Ver también Qt::AA_SynthesizeMouseForUnhandledTouchEvents.

enum Qt::NativeGestureType

Este enum devuelve el tipo de gesto.

enum Qt::NavigationMode

Este tipo enum describe el modo para mover el enfoque.

Ver también QApplication::setNavigationMode() y QApplication::navigationMode().

enum Qt::Orientación
flags Qt::Orientaciones

Este tipo se utiliza para indicar la orientación de un objeto.

Orientation se utiliza, por ejemplo, con QScrollBar.

El tipo Orientations es un typedef para QFlags<Orientation>. Almacena una combinación OR de valores de Orientación.

enum Qt::PenCapStyle

Este tipo enum define los estilos de tapa de lápiz soportados por Qt, es decir, las tapas de final de línea que se pueden dibujar usando QPainter.

Qt::SquareCap	Qt::TapaPlana	Qt::TapaRedonda

Véase también QPen.

enum Qt::PenJoinStyle

Este tipo enum define los estilos de unión de lápices soportados por Qt, es decir, qué uniones entre dos líneas conectadas se pueden dibujar usando QPainter.

Qt::BevelJoin	Qt::MiterJoin	Qt::JuntaRedonda

Véase también QPen.

enum Qt::PenStyle

Este tipo enum define los estilos de pluma que se pueden dibujar utilizando QPainter. Los estilos son:

Qt::SolidLine	Qt::DashLine	Qt::LíneaPunto
Qt::DashDotLine	Qt::DashDotDotLínea	Qt::LíneaDashPersonalizada

Véase también QPen.

[since 6.5] enum class Qt::PermissionStatus

Este enum describe los posibles estados de un permiso.

Este enum se introdujo en Qt 6.5.

Ver también QCoreApplication::requestPermission(), QCoreApplication::checkPermission(), y Application Permissions.

enum Qt::ReturnByValueConstant

Se trata de un tipo ficticio, diseñado para ayudar a los usuarios en la transición de ciertas API obsoletas a las API que las sustituyen.

Véase también QCursor::bitmap(), QCursor::mask(), QLabel::picture(), y QLabel::pixmap().

enum Qt::ScreenOrientation
flags Qt::ScreenOrientations

Este tipo enum especifica las distintas orientaciones que puede tener una pantalla.

El tipo ScreenOrientations es un typedef para QFlags<ScreenOrientation>. Almacena una combinación OR de valores ScreenOrientation.

enum Qt::ScrollBarPolicy

Este tipo enum describe los distintos modos de las barras de desplazamiento de QAbstractScrollArea.

(Los modos para las barras de desplazamiento horizontal y vertical son independientes).

enum Qt::ScrollPhase

Este enum describe la fase de desplazamiento.

enum Qt::ShortcutContext

Para que se produzca un evento QEvent::Shortcut, la secuencia de teclas del acceso directo debe ser introducida por el usuario en un contexto en el que el acceso directo esté activo. Los contextos posibles son los siguientes