TVOT_PUSHBUTTON
Important
La plateforme d’impression moderne est le moyen privilégié de Windows pour communiquer avec les imprimantes. Nous vous recommandons d’utiliser le pilote de classe IPP en boîte de Microsoft, ainsi que les applications de support d’impression (PSA), pour personnaliser l’expérience d’impression dans Windows 10 et 11 pour le développement de périphériques d’impression.
Pour plus d’informations, veuillez consulter la section Plateforme d’impression moderne et le Guide de conception des applications de support d’impression.
Le type d'option TVOT_PUSHBUTTON consiste en un bouton push à l'intérieur d'un cadre.
Structure OPTITEM
Sel/pSel
Dépend du membre Style de la structure OPTPARAM, comme suit.
| Style de bouton poussoir | Sel/pSel Utilisation |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Aucun affichage. |
| PUSHBUTTON_TYPE_DLGPROC | CPSUI stocke la valeur de retour de la procédure de boîte de dialogue. |
| PUSHBUTTON_TYPE_HTCLRADJ | CPSUI stocke la valeur de retour de l'opération de tramage. |
| PUSHBUTTON_TYPE_HTSETUP | CPSUI stocke la valeur de retour de l'opération de tramage. |
Tableau de la structure OPTPARAM (membre pOptParam de OPTTYPE)
pData
Cela dépend de l'élément de style, comme suit.
| Style de bouton poussoir | Utilisation de pData |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Pointeur vers une fonction de type _CPSUICALLBACK. |
| PUSHBUTTON_TYPE_DLGPROC | Pointeur de type DLGPROC vers une procédure de boîte de dialogue (voir la documentation Microsoft Windows SDK). |
| PUSHBUTTON_TYPE_HTCLRADJ | Pointeur sur la structure COLORADJUSTMENT (décrite dans la documentation du SDK Windows). |
| PUSHBUTTON_TYPE_HTSETUP | Pointeur vers une structure DEVHTADJDATA. |
IconID
Identifie une icône à associer au bouton push.
lParam Dépend du membre Style, comme suit.
| Style de bouton poussoir | lParam usage |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Aucun affichage. |
| PUSHBUTTON_TYPE_DLGPROC | Identifiant d'une ressource DIALOG, ou pointeur sur une structure DLGTEMPLATE (voir la documentation du SDK Windows). Dépend de l'indicateur DPF_USE_HDLGTEMPLATE dans le membre Flags de la structure OPTPARAM. |
| PUSHBUTTON_TYPE_HTCLRADJ | Aucun affichage. |
| PUSHBUTTON_TYPE_HTSETUP | Aucun affichage. |
| Terme | Description |
|---|---|
| Style | Spécifie l'opération à effectuer par CPSUI lorsqu'un utilisateur clique sur le bouton push. Peut avoir l’une des valeurs suivantes : |
| PUSHBUTTON_TYPE_CALLBACK | Le CPSUI appelle la fonction de rappel _CPSUICALLBACK de l'application pour gérer les événements liés aux boutons, le membre Reason de la structure CPSUICBPARAM étant défini sur CPSUICB_REASON_PUSHBUTTON. (CPSUI ignore la valeur de retour de la fonction de rappel). |
| PUSHBUTTON_TYPE_DLGPROC | La procédure de boîte de dialogue de l'application gère les événements liés aux boutons. (Pour plus d'informations, voir la section Remarques pour DLGPAGE). Lorsque la fonction reçoit un message WM_INITDIALOG, son argument lParam pointe vers une structure CPSUICBPARAM dont le membre Reason a la valeur CPSUICB_REASON_DLGPROC. |
| PUSHBUTTON_TYPE_HTCLRADJ | CPSUI affiche une boîte de dialogue d'ajustement des couleurs en demi-teinte. |
| PUSHBUTTON_TYPE_HTSETUP | CPSUI affiche une boîte de dialogue de configuration des demi-teintes de l'appareil. |
Structure OPTTYPE
Type TVOT_PUSHBUTTON
Compte 1
Style Les indicateurs de bits facultatifs suivants peuvent être spécifiés.
| Indicateur | Description |
|---|---|
| OTS_PUSH_ENABLE_ALWAYS | S'il est défini, le bouton push est toujours activé, même si l'utilisateur ne peut pas modifier la page de la feuille de propriétés (c'est-à-dire même si CPSUIF_UPDATE_PERMISSION n'est pas défini dans une structure COMPROPSHEETUI). La fonction de rappel du bouton push doit afficher sa boîte de dialogue, mais elle ne doit pas permettre à l'utilisateur de la modifier. Notez que vous devez également définir cet indicateur dans le membre Flags de la structure OPTTYPE. |
| OTS_PUSH_INCL_SETUP_TITLE | Si cette option est activée, le CPSUI inclut le mot « Setup » après la chaîne de nom du bouton (pName dans OPTITEM). |
| OTS_PUSH_NO_DOT_DOT_DOT | Si cette option est activée, le CPSUI inclut trois points (...) après la chaîne de nom du bouton (pName dans OPTITEM). |
BegCtrlID
Si pDlgPage dans COMPROPSHEETUI identifie une page fournie par CPSUI, ou si DlgTemplateID dans DLGPAGE identifie un modèle fourni par CPSUI, BegCtrlID n'est pas utilisé. Sinon, BegCtrlID doit contenir le premier identifiant de contrôle d'un ensemble d'identifiants de contrôle numérotés séquentiellement. Les identificateurs de contrôle doivent identifier les contrôles Windows suivants :
| Identificateur de contrôle | Contrôle Windows |
|---|---|
| Contenu de BegCtrlID | Contrôle Group box |
| Contenu de BegCtrlID +1 | Texte du titre |
| Contenu de BegCtrlID +2 | Boîte du bouton push |
| Contenu de BegCtrlID +3 | Icône du bouton poussoir |
| Contenu de BegCtrlID +4 | Case à cocher étendue ou bouton poussoir étendu (facultatif) |
| Contenu de BegCtrlID +5 | Icône de case à cocher étendue ou de bouton poussoir étendu (facultatif) |
Pour plus d'informations, reportez-vous à la section Personnalisation des contrôles de fenêtre pris en charge par CPSUI.
Spécifications
En-tête : compstui.h (include Compstui.h)