TVOT_PUSHBUTTON
Important
Nous vous recommandons d’utiliser le pilote de classe de boîte de réception IPP 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’imprimante.
Pour plus d’informations, consultez le Guide de conception de l’application de support d’impression.
Le type d’option TVOT_PUSHBUTTON se compose d’un bouton pousseur à l’intérieur d’une zone de groupe.
Structure OPTITEM
Sel/pSel
Dépend du membre Style de la structure OPTPARAM, comme suit.
| Style de bouton-poussur | Sel/pSel Usage |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Non utilisé. |
| 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 halftoning. |
| PUSHBUTTON_TYPE_HTSETUP | CPSUI stocke la valeur de retour de l’opération de halftoning. |
Tableau de structure OPTPARAM (membre pOptParam d’OPTTYPE)
Pdata
Dépend du membre Style , comme suit.
| Style de bouton poussur | 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 (consultez la documentation Microsoft Windows SDK). |
| PUSHBUTTON_TYPE_HTCLRADJ | Pointeur vers 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 pousseur.
Lparam Dépend du membre Style , comme suit.
| Style de bouton poussur | utilisation de lParam |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Non utilisé. |
| PUSHBUTTON_TYPE_DLGPROC | Identificateur de ressource pour une ressource DIALOG, ou handle vers 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 | Non utilisé. |
| PUSHBUTTON_TYPE_HTSETUP | Non utilisé. |
| 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 | CPSUI appelle la fonction de rappel _CPSUICALLBACK de l’application pour gérer les événements de bouton, avec le membre Reason de la structure CPSUICBPARAM 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 de bouton. (Pour plus d’informations, consultez la section Remarques pour DLGPAGE.) Lorsque la fonction reçoit un message WM_INITDIALOG, son argument lParam pointe vers une structure CPSUICBPARAM avec le membre Reason défini sur 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 en demi-teinte de l’appareil. |
Structure OPTTYPE
Type TVOT_PUSHBUTTON
Nombre 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 poussoir doit afficher sa boîte de dialogue, mais elle ne doit pas autoriser les modifications de l’utilisateur. Notez que vous devez également définir cet indicateur dans le membre Flags de la structure OPTTYPE . |
| OTS_PUSH_INCL_SETUP_TITLE | S’il est défini, CPSUI inclut le mot « Setup » après la chaîne de nom du bouton (pName dans OPTITEM). |
| OTS_PUSH_NO_DOT_DOT_DOT | S’il est défini, 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 identificateur de contrôle d’un jeu séquentiel d’identificateurs de contrôle. 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 begCtrlID +1 | Texte du titre |
| Contenu begCtrlID +2 | Zone de bouton pousseur |
| Contenu begCtrlID +3 | Icône de bouton Push |
| Contenu begCtrlID +4 | Case à cocher étendue ou bouton pousseur étendu (facultatif) |
| Contenu begCtrlID +5 | Icône de case à cocher étendue ou de bouton push étendu (facultatif) |
Pour plus d’informations, consultez Personnalisation des contrôles de fenêtre CPSUI-Supported.
Configuration requise
En-tête : compstui.h (include Compstui.h)