QAction Class

Documentation sur les propriétés

autoRepeat : bool

Cette propriété indique si l'action peut être répétée automatiquement

Si la valeur est « true », l'action se répète automatiquement lorsque la combinaison de raccourcis clavier est maintenue enfoncée, à condition que la répétition automatique du clavier soit activée sur le système. La valeur par défaut est « true ».

Fonctions d'accès :

Signal de notification :

checkable : bool

Cette propriété s'applique que l'action soit ou non une action à cocher

Une action à bascule est une action qui peut être activée ou désactivée. Par exemple, dans un traitement de texte, le bouton « Gras » de la barre d’outils peut être activé ou désactivé. Une action qui n’est pas une action à bascule est une action de commande ; une action de commande est simplement exécutée, par exemple l’enregistrement d’un fichier. Par défaut, cette propriété est définie sur « false ».

Dans certaines situations, l'état d'une action à bascule doit dépendre de l'état d'autres actions. Par exemple, les actions de basculement « Alignement à gauche », « Centrage » et « Alignement à droite » s’excluent mutuellement. Pour obtenir un basculement exclusif, ajoutez les actions de basculement concernées à un groupe d’actions ( QActionGroup ) dont la propriété QActionGroup::exclusive est définie sur true.

Fonctions d'accès :

Signal de notification :

Voir aussi setChecked().

checked : bool

Cette propriété indique si l'action est cochée.

Seules les actions pouvant être cochées peuvent l’être. Par défaut, cette propriété est définie sur false (l’action n’est pas cochée).

Fonctions d’accès :

Signal de notification :

Voir également checkable et toggled().

enabled : bool

Cette propriété s'applique que l'action soit activée ou non

Les actions désactivées ne peuvent pas être sélectionnées par l'utilisateur. Elles ne disparaissent pas des menus ni des barres d'outils, mais elles sont affichées de manière à indiquer qu'elles ne sont pas disponibles. Par exemple, elles peuvent être affichées uniquement en nuances de gris.

What's This? L'aide relative aux actions désactivées reste disponible, à condition que la propriété ` QAction::whatsThis ` soit définie.

Une action sera désactivée lorsque tous les widgets auxquels elle est ajoutée (à l'aide de ` QWidget::addAction()`) sont désactivés ou invisibles. Lorsqu'une action est désactivée, il n'est pas possible de la déclencher via son raccourci.

Par défaut, cette propriété est définie sur true (les actions sont activées).

Fonctions d'accès :

Signal de notification :

Voir également text.

font : QFont

Cette propriété définit la police de l'action

La propriété « font » sert à afficher le texte défini dans l'QAction. La police peut être considérée comme une indication, car elle ne sera pas toujours prise en compte selon l'application et le style.

Par défaut, cette propriété contient la police par défaut de l'application.

Fonctions d'accès :

Signal de notification :

Voir également setText().

icon : QIcon

Cette propriété contient l'icône de l'action

Dans les barres d'outils, l'icône est utilisée comme icône du bouton d'outil ; dans les menus, elle s'affiche à gauche du texte du menu, à condition que la méthode ` QAction::iconVisibleInMenu ` renvoie ` true`.

Il n'y a pas d'icône par défaut.

Si une icône nulle (QIcon::isNull()) est transmise à cette fonction, l’icône de l’action est effacée.

Fonctions d'accès :

Signal de notification :

iconText : QString

Cette propriété contient le texte descriptif de l'icône de l'action

Si la propriété « QToolBar::toolButtonStyle » est définie sur une valeur permettant l’affichage de texte, le texte défini dans cette propriété apparaît sous forme d’étiquette dans le bouton d’outil correspondant.

Il sert également de texte par défaut dans les menus et les infobulles si l'action n'a pas été définie avec setText() ou setToolTip(), et sera également utilisé dans les boutons de la barre d'outils si aucune icône n'a été définie à l'aide de setIcon().

Si le texte de l’icône n’est pas explicitement défini, le texte normal de l’action sera utilisé comme texte de l’icône.

Par défaut, cette propriété contient une chaîne vide.

Fonctions d'accès :

Signal de notification :

Voir également setToolTip() et setStatusTip().

iconVisibleInMenu : bool

Cette propriété détermine si une action doit afficher une icône dans un menu

Dans certaines applications, il peut être judicieux d'afficher des actions avec des icônes dans la barre d'outils, mais pas dans les menus. Si cette propriété est définie sur « true », l'icône (si elle est valide) s'affiche dans le menu ; si elle est définie sur « false », elle ne s'affiche pas.

Par défaut, le comportement dépend de la présence ou non de l'attribut ` Qt::AA_DontShowIconsInMenus ` dans l'application. La définition explicite de cette propriété remplace la présence (ou l'absence) de cet attribut.

Par exemple :

QApplication app(argc, argv);
app.setAttribute(Qt::AA_DontShowIconsInMenus);  // Icons are *no longer shown* in menus
// ...
QAction *myAction = new QAction();
// ...
myAction->setIcon(SomeIcon);
myAction->setIconVisibleInMenu(true);   // Icon *will* be shown in menus for *this* action.

Fonctions d’accès :

Signal de notification :

Voir également icon et QCoreApplication::setAttribute().

menuRole : MenuRole

Cette propriété définit le rôle de l'action dans le menu

Elle indique le rôle que joue l’action dans le menu de l’application sous macOS. Par défaut, toutes les actions ont le rôle « TextHeuristicRole », ce qui signifie que l’action est ajoutée en fonction de son texte (voir QMenuBar pour plus d’informations).

Le rôle dans le menu ne peut être modifié qu’avant l’ajout des actions dans la barre de menus sous macOS (généralement juste avant l’affichage de la première fenêtre de l’application).

Fonctions d’accès :

Signal de notification :

priority : Priority

Cette propriété définit la priorité de l'action dans l'interface utilisateur.

Cette propriété peut être définie pour indiquer comment l'action doit être hiérarchisée dans l'interface utilisateur.

Par exemple, lorsque les barres d'outils sont configurées en mode « Qt::ToolButtonTextBesideIcon », les actions dont la propriété « LowPriority » est définie n'afficheront pas leurs libellés.

Fonctions d'accès :

Signal de notification :

shortcut : QKeySequence

Cette propriété contient le raccourci clavier principal de l'action

Les codes de touche valides pour cette propriété sont disponibles sur Qt::Key et Qt::Modifier. Il n'y a pas de touche de raccourci par défaut.

Fonctions d'accès :

Signal de notification :

shortcutContext : Qt::ShortcutContext

Cette propriété contient le contexte du raccourci de l'action

Les valeurs valides pour cette propriété sont disponibles à l'adresse Qt::ShortcutContext. La valeur par défaut est Qt::WindowShortcut.

Fonctions d'accès :

Signal de notification :

shortcutVisibleInContextMenu : bool

Cette propriété détermine si une action doit afficher ou non un raccourci dans un menu contextuel

Dans certaines applications, il peut être utile que les actions disposent de raccourcis dans les menus contextuels. Si cette propriété est définie sur « true », le raccourci (s'il est valide) s'affiche lorsque l'action apparaît dans un menu contextuel ; si elle est définie sur « false », il ne s'affiche pas.

Par défaut, le comportement dépend de la valeur de l'attribut « Qt::AA_DontShowShortcutsInContextMenus » défini pour l'application. La définition explicite de cette propriété remplace cet attribut.

Fonctions d'accès :

Signal de notification :

Voir également « shortcut » et « QCoreApplication::setAttribute() ».

statusTip : QString

Cette propriété contient l'info-bulle de l'action

L'info-bulle de statut s'affiche sur toutes les barres d'état fournies par le widget parent de niveau supérieur de l'action.

Par défaut, cette propriété contient une chaîne vide.

Fonctions d'accès :

Signal de notification :

Voir également setToolTip() et showStatusText().

text : QString

Cette propriété contient le texte descriptif de l'action

Si l'action est ajoutée à un menu, l'option de menu sera composée de l'icône (le cas échéant), du texte et du raccourci (le cas échéant). Si le texte n'est pas explicitement défini dans le constructeur ou à l'aide de la méthode setText(), le texte de l'icône de description de l'action sera utilisé comme texte. Il n'y a pas de texte par défaut.

Certains éléments de l'interface utilisateur, tels que les menus ou les boutons, peuvent utiliser le caractère « & » devant un caractère pour créer automatiquement un mnémonique (un raccourci) pour ce caractère. Par exemple, « &Fichier » pour un menu créera le raccourci Alt+F, qui ouvrira le menu Fichier. « E&xit » créera le raccourci Alt+X pour un bouton, ou, dans un menu, permettra d’accéder à l’élément de menu en appuyant sur « x ». (Utilisez « && » pour afficher un « & » réel.) Le widget peut intercepter un raccourci donné et effectuer une action correspondante.

Fonctions d’accès :

Signal de notification :

Voir également iconText.

toolTip : QString

Cette propriété contient l'info-bulle de l'action

Ce texte est utilisé pour l'info-bulle. Si aucune info-bulle n'est spécifiée, c'est le texte de l'action qui est utilisé.

Par défaut, cette propriété contient le texte de l'action.

Fonctions d'accès :

Signal de notification :

Voir également setStatusTip() et setShortcut().

visible : bool

Cette propriété indique si l'action est visible (par exemple dans les menus et les barres d'outils)

Si « visible » est vrai, l'action est visible (par exemple dans les menus et les barres d'outils) et peut être sélectionnée par l'utilisateur ; si « visible » est faux, l'action n'est ni visible ni sélectionnable par l'utilisateur.

Les actions qui ne sont pas visibles ne sont pas grisées ; elles n’apparaissent tout simplement pas.

Par défaut, cette propriété est définie sur « true » (les actions sont visibles).

Fonctions d’accès :

Signal de notification :

whatsThis : QString

Cette propriété contient le texte d'aide « Qu'est-ce que c'est ? » de l'action

Le texte « Qu'est-ce que c'est ? » sert à fournir une brève description de l'action. Ce texte peut contenir du texte enrichi. Il n'y a pas de texte « Qu'est-ce que c'est ? » par défaut.

Fonctions d’accès :

Signal de notification :

Voir également QWhatsThis.