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é indique si l'action est une action contrôlable

Une action vérifiable est une action dont l'état est activé ou désactivé. Par exemple, dans un traitement de texte, un bouton de la barre d'outils Gras 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 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", "Centrer" et "Alignement à droite" s'excluent mutuellement. Pour obtenir un basculement exclusif, ajoutez les actions de basculement concernées à un site QActionGroup dont la propriété QActionGroup::exclusive est définie sur true (vrai).

Fonctions d'accès :

Signal du notificateur :

Voir également setChecked().

checked : bool

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

Seules les actions vérifiables peuvent être vérifiées. Par défaut, cette propriété vaut false (l'action n'est pas vérifiée).

Fonctions d'accès :

Signal de notification :

Voir aussi checkable et toggled().

enabled : bool

Cette propriété indique si l'action est activée

Les actions désactivées ne peuvent pas être choisies par l'utilisateur. Elles ne disparaissent pas des menus ou des barres d'outils, mais elles sont affichées d'une manière qui indique qu'elles ne sont pas disponibles. Par exemple, elles peuvent être affichées uniquement en nuances de gris.

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

Une action est désactivée lorsque tous les widgets auxquels elle est ajoutée (avec QWidget::addAction()) sont désactivés ou non visibles. 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 true (les actions sont activées).

Fonctions d'accès :

Signal Notificateur :

Voir aussi text.

font : QFont

Cette propriété contient la police de caractères de l'action

La propriété font est utilisée pour rendre le texte défini sur le site QAction. La police peut être considérée comme un indice car elle ne sera pas consultée dans tous les cas en fonction de l'application et du style.

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

Fonctions d'accès :

Signal Notifier :

Voir aussi 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 l'icône du bouton de l'outil ; dans les menus, elle est affichée à gauche du texte du menu, à condition que 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 du notificateur :

iconText : QString

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

Si QToolBar::toolButtonStyle est défini à une valeur permettant l'affichage de texte, le texte défini dans cette propriété apparaît en tant qu'é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 à l'aide de 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é pour le texte de l'icône.

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

Fonctions d'accès :

Signal du notificateur :

Voir aussi setToolTip() et setStatusTip().

iconVisibleInMenu : bool

Cette propriété indique si une action doit ou non afficher une icône dans un menu

Dans certaines applications, il peut être judicieux d'avoir des actions avec des icônes dans la barre d'outils, mais pas dans les menus. Si true, l'icône (si elle est valide) est affichée dans le menu, si false, elle n'est pas affichée.

La valeur par défaut est de suivre si l'attribut Qt::AA_DontShowIconsInMenus est défini pour l'application. La définition explicite de cette propriété annule la présence (ou l'absence) de l'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 aussi icon et QCoreApplication::setAttribute().

menuRole : MenuRole

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

Cette propriété indique le rôle de 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 que les actions ne soient placées dans la barre de menu de macOS (généralement juste avant l'affichage de la première fenêtre d'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 priorisée dans l'interface utilisateur.

Par exemple, lorsque le mode Qt::ToolButtonTextBesideIcon est activé pour les barres d'outils, les actions avec LowPriority n'afficheront pas les étiquettes de texte.

Fonctions d'accès :

Signal de notification :

shortcut : QKeySequence

Cette propriété contient la clé de raccourci principale de l'action

Les codes clés valides pour cette propriété se trouvent dans Qt::Key et Qt::Modifier. Il n'y a pas de raccourci clavier 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 de cette propriété se trouvent à l'adresse Qt::ShortcutContext. La valeur par défaut est Qt::WindowShortcut.

Fonctions d'accès :

Signal du notificateur :

shortcutVisibleInContextMenu : bool

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

Dans certaines applications, il peut être utile d'avoir des actions avec des raccourcis dans les menus contextuels. Si cette propriété vaut true, le raccourci (s'il est valide) est affiché lorsque l'action est affichée via un menu contextuel ; si elle vaut false, il n'est pas affiché.

La valeur par défaut est de suivre si l'attribut Qt::AA_DontShowShortcutsInContextMenus est défini pour l'application. La définition explicite de cette propriété a pour effet de remplacer l'attribut.

Fonctions d'accès :

Notifier signal :

Voir aussi shortcut et QCoreApplication::setAttribute().

statusTip : QString

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

L'info-bulle est affichée sur toutes les barres d'état fournies par le widget parent de premier niveau de l'action.

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

Fonctions d'accès :

Signal du notificateur :

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 comprendra l'icône (s'il y en a une), le texte et le raccourci (s'il y en a un). Si le texte n'est pas explicitement défini dans le constructeur ou en utilisant 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 "&" devant un caractère pour créer automatiquement 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ée le raccourci Alt+X pour un bouton ou, dans un menu, permet de naviguer jusqu'à l'élément de menu en appuyant sur "x". (utilisez "&&" pour afficher une véritable esperluette). Le widget peut consommer et effectuer une action sur un raccourci donné.

Fonctions d'accès :

Signal de notification :

Voir aussi 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, le texte de l'action est utilisé.

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

Fonctions d'accès :

Signal du notificateur :

Voir aussi setStatusTip() et setShortcut().

visible : bool

Cette propriété indique si l'action peut être vue (par exemple, dans les menus et les barres d'outils)

Si visible est vrai, l'action peut être vue (par exemple dans les menus et les barres d'outils) et choisie par l'utilisateur ; si visible est faux, l'action ne peut pas être vue ou choisie par l'utilisateur.

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

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

Fonctions d'accès :

Signal du notificateur :

whatsThis : QString

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

Le texte "Qu'est-ce que c'est ?" est utilisé pour fournir une brève description de l'action. Le texte peut contenir du texte enrichi. Il n'y a pas de texte d'aide par défaut.

Fonctions d'accès :

Signal du notificateur :

Voir aussi QWhatsThis.