COleControlSite Class

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Prend en charge les interfaces de contrôle côté client personnalisées.

class COleControlSite : public CCmdTarget  

Constructeurs publics

NomDescription
COleControlSite::COleControlSiteConstruit un objet COleControlSite.

Méthodes publiques

NomDescription
COleControlSite::BindDefaultPropertyLie la propriété par défaut du contrôle hébergé à une source de données.
COleControlSite::BindPropertyLie une propriété du contrôle hébergé à une source de données.
COleControlSite::CreateControlCrée un contrôle ActiveX hébergé.
COleControlSite::DestroyControlDétruit le contrôle hébergé.
COleControlSite::DoVerbExécute un verbe spécifique du contrôle hébergé.
COleControlSite::EnableDSCPermet à un site de contrôle de données.
COleControlSite::EnableWindowPermet au site de contrôle.
COleControlSite::FreezeEventsSpécifie si le site de contrôle est accepter des événements.
COleControlSite::GetDefBtnCodeRécupère le code de bouton par défaut pour le contrôle hébergé.
COleControlSite::GetDlgCtrlIDRécupère l’identificateur du contrôle.
COleControlSite::GetEventIIDRécupère l’ID d’une interface d’événement pour un contrôle hébergé.
COleControlSite::GetExStyleRécupère les styles étendus de contrôle.
COleControlSite::GetPropertyRécupère une propriété spécifique du contrôle hébergé.
COleControlSite::GetStyleRécupère les styles de contrôle.
COleControlSite::GetWindowTextRécupère le texte du contrôle hébergé.
COleControlSite::InvokeHelperAppeler une méthode spécifique du contrôle hébergé.
COleControlSite::InvokeHelperVAppeler une méthode spécifique du contrôle hébergé avec une liste d’arguments variable.
COleControlSite::IsDefaultButtonDétermine si le contrôle est le bouton par défaut dans la fenêtre.
COleControlSite::IsWindowEnabledVérifie l’état de visibilité de contrôle.
COleControlSite::ModifyStyleModifie l’actuel étendu de styles de contrôle.
COleControlSite::ModifyStyleExModifie les styles de contrôle actuels.
COleControlSite::MoveWindowModifie la position de contrôle.
COleControlSite::QuickActivateRapide active le contrôle hébergé.
COleControlSite::SafeSetPropertyDéfinit une propriété ou méthode du contrôle sans risque de lever une exception.
COleControlSite::SetDefaultButtonDéfinit le bouton par défaut dans la fenêtre.
COleControlSite::SetDlgCtrlIDRécupère l’identificateur du contrôle.
COleControlSite::SetFocusDéfinit le focus sur le site du contrôle.
COleControlSite::SetPropertyDéfinit une propriété spécifique du contrôle hébergé.
COleControlSite::SetPropertyVDéfinit une propriété spécifique du contrôle hébergé avec une liste d’arguments variable.
COleControlSite::SetWindowPosDéfinit la position de contrôle.
COleControlSite::SetWindowTextDéfinit le texte du contrôle hébergé.
COleControlSite::ShowWindowAffiche ou masque le site du contrôle.

Méthodes protégées

NomDescription
COleControlSite::GetControlInfoRécupère les informations du clavier et les mnémoniques du contrôle hébergé.

Membres de données publics

NomDescription
COleControlSite::m_bIsWindowlessDétermine si le contrôle hébergé est un contrôle sans fenêtre.
COleControlSite::m_ctlInfoContient des informations sur la gestion du clavier pour le contrôle.
COleControlSite::m_dwEventSinkLe cookie du contrôle point de connexion.
COleControlSite::m_dwMiscStatusLes divers états pour le contrôle hébergé.
COleControlSite::m_dwPropNotifySinkLe IPropertyNotifySink cookie du contrôle.
COleControlSite::m_dwStyleLes styles du contrôle hébergé.
COleControlSite::m_hWndLa poignée de contrôle.
COleControlSite::m_iidEventsID de l’interface d’événement pour le contrôle hébergé.
COleControlSite::m_nIDL’ID du contrôle hébergé.
COleControlSite::m_pActiveObjectUn pointeur vers le IOleInPlaceActiveObject objet du contrôle hébergé.
COleControlSite::m_pCtrlContLe conteneur du contrôle hébergé.
COleControlSite::m_pInPlaceObjectUn pointeur vers le IOleInPlaceObject objet du contrôle hébergé.
COleControlSite::m_pObjectUn pointeur vers le IOleObjectInterface interface du contrôle.
COleControlSite::m_pWindowlessObjectUn pointeur vers le IOleInPlaceObjectWindowless interface du contrôle.
COleControlSite::m_pWndCtrlPointeur vers l’objet de fenêtre pour le contrôle hébergé.
COleControlSite::m_rectLes dimensions de site du contrôle.

Cette prise en charge est le principal moyen par lequel un contrôle ActiveX incorporé obtient des informations sur l’emplacement et l’étendue de son site d’affichage, son moniker, son interface utilisateur, ses propriétés ambiantes et autres ressources fournies par son conteneur. COleControlSiteimplémente entièrement le IOleControlSite, IOleInPlaceSite, IOleClientSite, IPropertyNotifySink, IBoundObjectSite, INotifyDBEvents, IRowSetNotify interfaces. En outre, l’interface IDispatch (prise en charge pour les récepteurs d’événements et les propriétés ambiantes) est également implémentée.

Pour créer un site de contrôle ActiveX à l’aide COleControlSite, dérivez une classe de COleControlSite. Dans votre CWnd-remplacement de la classe dérivée pour le conteneur (par exemple, votre boîte de dialogue) le CWnd::CreateControlSite (fonction).

CObject

CCmdTarget

COleControlSite

En-tête : afxocc.h

Lie par défaut simple propriété liée l’objet appelant, sélectionnée dans la bibliothèque de types, le curseur sous-jacent qui est défini par les propriétés de la source de données, nom d’utilisateur, mot de passe et SQL du contrôle de source de données.

virtual void BindDefaultProperty(
    DISPID dwDispID,  
    VARTYPE vtProp,  
    LPCTSTR szFieldName,  
    CWnd* pDSCWnd);

Paramètres

dwDispID
Spécifie le DISPID d’une propriété sur un contrôle lié aux données qui doit être lié à un contrôle de source de données.

vtProp
Spécifie le type de la propriété à lier, par exemple, VT_BSTR, VT_VARIANT, et ainsi de suite.

szFieldName
Spécifie le nom de la colonne du curseur fournie par le contrôle de source de données auquel la propriété va être liée.

pDSCWnd
Un pointeur vers le CWnd-objet dérivé qui héberge le contrôle de source de données auquel la propriété va être liée.

Notes

Le CWnd objet sur lequel vous appelez cette fonction doit être un contrôle lié aux données.

Lie la propriété de dépendant de l’objet appelant simple, sélectionnée dans la bibliothèque de types, le curseur sous-jacent qui est défini par les propriétés de la source de données, nom d’utilisateur, mot de passe et SQL du contrôle de source de données.

virtual void BindProperty(
    DISPID dwDispId,  
    CWnd* pWndDSC);

Paramètres

dwDispId
Spécifie le DISPID d’une propriété sur un contrôle lié aux données qui doit être lié à un contrôle de source de données.

pWndDSC
Un pointeur vers le CWnd-objet dérivé qui héberge le contrôle de source de données auquel la propriété va être liée.

Notes

Le CWnd objet sur lequel vous appelez cette fonction doit être un contrôle lié aux données.

Construit un nouveau COleControlSite objet.

explicit COleControlSite(COleControlContainer* pCtrlCont);

Paramètres

pCtrlCont
Pointeur vers le conteneur du contrôle (qui représente la fenêtre qui héberge le contrôle ActiveX).

Notes

Cette fonction est appelée par le COccManager::CreateContainer (fonction). Pour plus d’informations sur la personnalisation de la création de conteneurs, consultez COccManager::CreateSite.

Crée un contrôle ActiveX, hébergé par le COleControlSite objet.

virtual HRESULT CreateControl(
    CWnd* pWndCtrl,  
    REFCLSID clsid,  
    LPCTSTR lpszWindowName,  
    DWORD dwStyle,  
    const RECT& rect,  
    UINT nID,  
    CFile* pPersist = NULL,  
    BOOL bStorage = FALSE,  
    BSTR bstrLicKey = NULL);

 
virtual HRESULT CreateControl(
    CWnd* pWndCtrl,  
    REFCLSID clsid,  
    LPCTSTR lpszWindowName,  
    DWORD dwStyle,  
    const POINT* ppt,  
    const SIZE* psize,  
    UINT nID,  
    CFile* pPersist = NULL,  
    BOOL bStorage = FALSE,  
    BSTR bstrLicKey = NULL);

Paramètres

pWndCtrl
Pointeur vers l’objet window représentant le contrôle.

clsid
L’ID de classe unique du contrôle.

lpszWindowName
Pointeur vers le texte à afficher dans le contrôle. Définit la valeur de propriété de légende ou le texte de la winodw (le cas échéant).

dwStyle
Styles de Windows. Les styles disponibles sont répertoriés sous le notes section.

rect
Spécifie la taille et la position du contrôle. Il peut être soit un CRect objet ou un RECT structure.

nID
Spécifie la fenêtre de l’enfant. du contrôle

pPersist
Un pointeur vers un CFile contenant l’état persistant du contrôle. La valeur par défaut est NULL, indiquant que le contrôle s’initialise lui-même sans restaurer son état à partir de n’importe quel stockage persistant. Si ce n’est pas NULL, il doit être un pointeur vers un CFile-objet qui contient les données du contrôle persistant, sous la forme d’un flux ou un stockage dérivé. Ces données pourraient ont été enregistrées dans une précédente activation du client. Le CFile peut contenir des autres données, mais doit avoir son pointeur en lecture-écriture défini sur le premier octet de données persistantes au moment de l’appel à CreateControl.

bStorage
Indique si les données de pPersist doivent être interprétées comme IStorage ou IStream données. Si les données de pPersist est un stockage, bStorage doit être TRUE. Si les données de pPersist est un flux, bStorage doit être FALSE. La valeur par défaut est FALSE.

bstrLicKey
Données de clé de licence facultatif. Ces données sont nécessaire uniquement pour la création de contrôles qui exigent une clé de licence d’exécution. Si le contrôle prend en charge le Gestionnaire de licences, vous devez fournir une clé de licence pour la création du contrôle de réussir. La valeur par défaut est NULL.

ppt
Un pointeur vers un POINT structure qui contient l’angle supérieur gauche du contrôle. La taille du contrôle est déterminée par la valeur de psize. Le ppt et psize valeurs sont une méthode facultative de la spécification de la taille et position opf le contrôle.

psize
Un pointeur vers un taille structure qui contient la taille du contrôle. L’angle supérieur gauche est déterminée par la valeur de ppt. Le ppt et psize valeurs sont une méthode facultative de la spécification de la taille et position opf le contrôle.

Valeur de retour

Valeur HRESULT standard.

Notes

Seul un sous-ensemble des fenêtres dwStyle indicateurs sont pris en charge par CreateControl:

  • WS_VISIBLE crée une fenêtre qui est initialement visible. Requis si vous souhaitez que le contrôle soit visible immédiatement, comme des fenêtres ordinaires.

  • WS_DISABLED crée une fenêtre qui est initialement désactivée. Une fenêtre désactivée ne peut pas recevoir d’entrée de l’utilisateur. Peut être définie si le contrôle a une propriété activé.

  • WS_BORDERCrée une fenêtre avec une bordure léger. Peut être définie si le contrôle a une propriété BorderStyle.

  • WS_GROUP Spécifie le premier contrôle d’un groupe de contrôles. L’utilisateur peut modifier le focus clavier d’un contrôle dans le groupe à l’autre en utilisant les touches de direction. Tous les contrôles définis avec la WS_GROUP après le premier contrôle appartiennent au même groupe de style. Le contrôle suivant avec les WS_GROUP style met fin au groupe et démarre le groupe suivant.

  • WS_TABSTOP spécifie un contrôle pouvant recevoir le focus clavier lorsque l’utilisateur appuie sur la touche TAB. En appuyant sur la touche TAB modifie le focus au contrôle suivant de la WS_TABSTOP style.

La deuxième surcharge permet de créer des contrôles de taille par défaut.

Détruit le COleControlSite objet.

virtual BOOL DestroyControl();

Valeur de retour

Différent de zéro si l’opération réussit, sinon 0.

Notes

Une fois terminé, l’objet est libéré de la mémoire et des pointeurs vers l’objet ne sont plus valides.

Exécute le verbe spécifié.

virtual HRESULT DoVerb(
    LONG nVerb,  
    LPMSG lpMsg = NULL);

Paramètres

nVerb
Spécifie le verbe à exécuter. Il peut inclure un des éléments suivants :

ValeurSignificationSymbole
0Primary (verbe)OLEIVERB_PRIMARY
-1Verbe secondaire(Aucun)
1Affiche l’objet à modifier.OLEIVERB_SHOW
-2Modifie l’élément dans une fenêtre distincte.OLEIVERB_OPEN
-3Masque l’objet.OLEIVERB_HIDE
-4Active un contrôle sur place.OLEIVERB_UIACTIVATE
-5Active un contrôle sur place, sans les éléments d’interface utilisateur.OLEIVERB_INPLACEACTIVATE
-7Afficher les propriétés du contrôle.OLEIVERB_PROPERTIES

lpMsg
Pointeur vers le message qui a provoqué l’élément à activer.

Valeur de retour

Valeur HRESULT standard.

Notes

Cette fonction appelle directement par le biais du contrôle IOleObject interface pour exécuter le verbe spécifié. Si une exception est levée à la suite de cet appel de fonction, un HRESULT code d’erreur est renvoyé.

Pour plus d’informations, consultez IOleObject::DoVerb dans les SDK Windows.

Permet de données pour le site du contrôle.

virtual void EnableDSC();

Notes

Appelé par l’infrastructure pour activer et initialiser pour le site de contrôle de données. Remplacez cette fonction pour fournir le comportement personnalisé.

Active ou désactive la souris et clavier pour le site du contrôle.

virtual BOOL EnableWindow(BOOL bEnable);

Paramètres

bEnable
Spécifie s’il faut activer ou désactiver la fenêtre : TRUE si l’entrée de la fenêtre est activée, sinon FALSE.

Valeur de retour

Différent de zéro si la fenêtre a été désactivée précédemment, sinon 0.

Spécifie si le site de contrôle sera gérer ou ignorer des événements déclenchés à partir d’un contrôle.

void FreezeEvents(BOOL bFreeze);

Paramètres

bFreeze
Spécifie si le site de contrôle souhaite cesser d'accepter des événements. Différent de zéro si le contrôle n’accepte pas d’événements ; Sinon, zéro.

Notes

Si bFreeze est TRUE, le site de contrôle demande le contrôle d’arrêt fring événements. Si bFreeze est FALSE, le site de contrôle demande le contrôle pour poursuivre le déclenchement d’événements.

System_CAPS_ICON_note.jpg Remarque

Le contrôle n’est pas nécessaire d’arrêter le déclenchement d’événements si demandé par le site du contrôle. Il peut continuer, mais tous les événements suivants seront ignorés par le site du contrôle.

Récupère des informations sur les touches mnémoniques et le comportement du clavier d’un contrôle.

void GetControlInfo();

Notes

Les informations sont stockées dans COleControlSite::m_ctlInfo.

Détermine si le contrôle est un bouton de commande par défaut.

DWORD GetDefBtnCode();

Valeur de retour

Peut avoir l'une des valeurs suivantes :

  • DLGC_DEFPUSHBUTTON contrôle est le bouton par défaut dans la boîte de dialogue.

  • DLGC_UNDEFPUSHBUTTON contrôle n’est pas le bouton par défaut dans la boîte de dialogue.

  • 0 contrôle n’est pas un bouton.

Récupère l’identificateur du contrôle.

virtual int GetDlgCtrlID() const;  

Valeur de retour

L’identificateur d’élément de boîte de dialogue du contrôle.

Récupère un pointeur vers l’interface d’événement par défaut du contrôle.

BOOL GetEventIID(IID* piid);

Paramètres

piid
Un pointeur vers un ID d’interface.

Valeur de retour

Différent de zéro si l’opération réussit, sinon 0. En cas de réussite, piid contient l’ID de l’interface d’événement par défaut du contrôle.

Récupère les styles étendus de la fenêtre.

virtual DWORD GetExStyle() const;  

Valeur de retour

La fenêtre de contrôle de styles étendus.

Notes

Pour récupérer les styles normales, appelez COleControlSite::GetStyle.

Obtient la propriété du contrôle spécifiée par dwDispID.

virtual void GetProperty(
    DISPID dwDispID,  
    VARTYPE vtProp,  
    void* pvProp) const;  

Paramètres

dwDispID
Identifie l’ID de dispatch de la propriété sur la valeur par défaut du contrôle IDispatch interface, doit être récupéré.

vtProp
Spécifie le type de la propriété à récupérer. Pour les valeurs possibles, consultez la section Notes pour COleDispatchDriver::InvokeHelper.

pvProp
Adresse de la variable qui reçoit la valeur de propriété. Il doit correspondre au type spécifié par vtProp.

Notes

La valeur est retournée via pvProp.

Récupère les styles de contrôle.

virtual DWORD GetStyle() const;  

Valeur de retour

Styles de la fenêtre.

Notes

Pour obtenir la liste des valeurs possibles, consultez la page Styles Windows. Pour récupérer les styles étendus de contrôle, appelez COleControlSite::GetExStyle.

Récupère le texte du contrôle actuel.

virtual void GetWindowText(CString& str) const;  

Paramètres

str
Une référence à un CString objet qui contient le texte du contrôle actuel.

Notes

Si le contrôle prend en charge la propriété stockée Caption, cette valeur est retournée. Si la propriété stockée Caption n’est pas pris en charge, la valeur de la propriété Text est retournée.

Appelle la méthode ou la propriété spécifiée par dwDispID, dans le contexte spécifié par wFlags.

virtual void AFX_CDECL InvokeHelper(
    DISPID dwDispID,  
    WORD wFlags,  
    VARTYPE vtRet,  
    void* pvRet,  
    const BYTE* pbParamInfo, ...);

Paramètres

dwDispID
Identifie l’ID de dispatch de la propriété ou méthode, trouvée dans le contrôle IDispatch interface, à appeler.

wFlags
Indicateurs décrivant le contexte de l’appel à IDispatch::Invoke. Pour possible wFlags les valeurs, consultez IDispatch::Invoke dans les SDK Windows.

vtRet
Spécifie le type de la valeur de retour. Pour les valeurs possibles, consultez la section Notes pour COleDispatchDriver::InvokeHelper.

pvRet
Adresse de la variable qui recevra la valeur de propriété ou la valeur de retour. Elle doit correspondre au type spécifié par vtRet.

pbParamInfo
Pointeur vers une chaîne d’octets terminée par un caractère Null qui spécifie les types des paramètres suivant pbParamInfo. Pour les valeurs possibles, consultez la section Notes pour COleDispatchDriver::InvokeHelper.

...
Liste variable de paramètres, des types spécifiés dans pbParamInfo.

Notes

Le paramètre pbParamInfo spécifie les types des paramètres passés à la méthode ou propriété. La liste d’arguments variable est représentée par... dans la déclaration de la syntaxe.

Cette fonction convertit les paramètres VARIANTARG les valeurs, puis appelle le IDispatch::Invoke méthode sur le contrôle. Si l’appel à IDispatch::Invoke échoue, cette fonction lève une exception. Si le code d’état retourné par IDispatch::Invoke est DISP_E_EXCEPTION, cette fonction génère une COleDispatchException objet, sinon elle lève un COleException.

Appelle la méthode ou la propriété spécifiée par dwDispID, dans le contexte spécifié par wFlags.

virtual void InvokeHelperV(
    DISPID dwDispID,  
    WORD wFlags,  
    VARTYPE vtRet,  
    void* pvRet,  
    const BYTE* pbParamInfo,  
    va_list argList);

Paramètres

dwDispID
Identifie l’ID de dispatch de la propriété ou méthode, trouvée dans le contrôle IDispatch interface, à appeler.

wFlags
Indicateurs décrivant le contexte de l’appel à IDispatch::Invoke.

vtRet
Spécifie le type de la valeur de retour. Pour les valeurs possibles, consultez la section Notes pour COleDispatchDriver::InvokeHelper.

pvRet
Adresse de la variable qui recevra la valeur de propriété ou la valeur de retour. Elle doit correspondre au type spécifié par vtRet.

pbParamInfo
Pointeur vers une chaîne d’octets terminée par un caractère Null qui spécifie les types des paramètres suivant pbParamInfo. Pour les valeurs possibles, consultez la section Notes pour COleDispatchDriver::InvokeHelper.

argList
Pointeur vers une liste d’arguments variable.

Notes

Le paramètre pbParamInfo spécifie les types des paramètres passés à la méthode ou propriété. Paramètres supplémentaires pour la méthode ou propriété appelée peuvent être passés à l’aide de la va_list paramètre.

En règle générale, cette fonction est appelée par COleControlSite::InvokeHelper.

Détermine si le contrôle est le bouton par défaut.

BOOL IsDefaultButton();

Valeur de retour

Différent de zéro si le contrôle est le bouton par défaut dans la fenêtre, sinon, zéro.

Détermine si le site de contrôle est activé.

virtual BOOL IsWindowEnabled() const;  

Valeur de retour

Différent de zéro si le contrôle est activé, sinon, zéro.

Notes

La valeur est extraite de la propriété du contrôle activé stockée.

Détermine si l’objet est un contrôle sans fenêtre.

BOOL m_bIsWindowless;  

Notes

Différent de zéro si le contrôle n’a aucune fenêtre, sinon, zéro.

Informations sur la gestion des entrées au clavier par le contrôle.

CONTROLINFO m_ctlInfo;  

Notes

Ces informations sont stockées dans un CONTROLINFO structure.

Contient le cookie de point de connexion à partir de récepteur d’événements du contrôle.

DWORD m_dwEventSink;  

Contient diverses informations sur le contrôle.

DWORD m_dwMiscStatus;  

Notes

Pour plus d’informations, consultez OLEMISCdans les SDK Windows.

Contient le IPropertyNotifySink cookie.

DWORD m_dwPropNotifySink;  

Contient les styles de fenêtre du contrôle.

DWORD m_dwStyle;  

Contient le HWND du contrôle, ou NULL si le contrôle est sans fenêtre.

HWND m_hWnd;  

Contient l’ID de l’interface du récepteur événement par défaut du contrôle.

IID m_iidEvents;  

Contient l’ID d’élément boîte de dialogue. du contrôle

UINT m_nID;  

Contient le IOleInPlaceActiveObject interface du contrôle.

LPOLEINPLACEACTIVEOBJECT m_pActiveObject;  

Contient le conteneur du contrôle (représentant le formulaire).

COleControlContainer* m_pCtrlCont;  

Contient le IOleInPlaceObject IOleInPlaceObject interface du contrôle.

LPOLEINPLACEOBJECT m_pInPlaceObject;  

Contient le IOleObjectInterface interface du contrôle.

LPOLEOBJECT m_pObject;  

Contient le IOleInPlaceObjectWindowless IOleInPlaceObjectWindowless interface du contrôle.

IOleInPlaceObjectWindowless* m_pWindowlessObject;  

Contient un pointeur vers le CWnd objet qui représente le contrôle lui-même.

CWnd* m_pWndCtrl;  

Contient les limites du contrôle, par rapport à la fenêtre du conteneur.

CRect m_rect;  

Modifie les styles du contrôle.

virtual BOOL ModifyStyle(
    DWORD dwRemove,  
    DWORD dwAdd,  
    UINT nFlags);

Paramètres

dwRemove
Les styles à supprimer les styles de fenêtre en cours.

dwAdd
Les styles à ajouter des styles de fenêtre en cours.

nFlags
Indicateurs de positionnement de la fenêtre. Pour obtenir la liste des valeurs possibles, consultez la SetWindowPos de fonction dans le SDK Windows.

Valeur de retour

Différent de zéro si les styles sont modifiés, sinon, zéro.

Notes

Action du contrôle la propriété Enabled sera modifiée pour correspondre au paramètre pour WS_DISABLED. Propriétés de Style de bordure du contrôle stock seront modifiée pour correspondre au paramètre demandé pour WS_BORDER. Tous les autres styles sont appliqués directement à un handle de fenêtre du contrôle, s’il en existe.

Modifie les styles de fenêtre du contrôle. Ajouter ou supprimer des styles peuvent être combinées à l’aide de l’opérateur de bits OR (opérateur) (|). Consultez le CreateWindow de fonction dans le SDK Windows pour plus d’informations sur les styles de fenêtres disponibles.

Si nFlags est différent de zéro, ModifyStyle appelle la fonction Win32 SetWindowPos, puis le redessine la fenêtre en combinant nFlags avec quatre indicateurs suivants :

  • SWP_NOSIZEConserve la taille actuelle.

  • SWP_NOMOVEConserve la position actuelle.

  • SWP_NOZORDERConserve l’ordre de plan actuel.

  • SWP_NOACTIVATEN’active pas la fenêtre.

Pour modifier une fenêtre de styles étendus, appelez ModifyStyleEx.

Modifie les styles étendus du contrôle.

virtual BOOL ModifyStyleEx(
    DWORD dwRemove,  
    DWORD dwAdd,  
    UINT nFlags);

Paramètres

dwRemove
Les styles étendus à supprimer les styles de fenêtre en cours.

dwAdd
Les styles étendus à ajouter des styles de fenêtre en cours.

nFlags
Indicateurs de positionnement de la fenêtre. Pour obtenir la liste des valeurs possibles, consultez la SetWindowPos de fonction dans le SDK Windows.

Valeur de retour

Différent de zéro si les styles sont modifiés, sinon, zéro.

Notes

La propriété du contrôle stockée apparence sera modifiée pour correspondre au paramètre pour WS_EX_CLIENTEDGE. Tous les autres styles de fenêtre étendus sont appliqués directement à un handle de fenêtre du contrôle, s’il en existe.

Modifie la fenêtre étendu de styles de l’objet de site du contrôle. Ajouter ou supprimer des styles peuvent être combinées à l’aide de l’opérateur de bits OR (opérateur) (|). Consultez le CreateWindowEx de fonction dans le SDK Windows pour plus d’informations sur les styles de fenêtres disponibles.

Si nFlags est différent de zéro, ModifyStyleEx appelle la fonction Win32 SetWindowPos, puis le redessine la fenêtre en combinant nFlags avec quatre indicateurs suivants :

  • SWP_NOSIZEConserve la taille actuelle.

  • SWP_NOMOVEConserve la position actuelle.

  • SWP_NOZORDERConserve l’ordre de plan actuel.

  • SWP_NOACTIVATEN’active pas la fenêtre.

Pour modifier une fenêtre de styles étendus, appelez ModifyStyle.

Modifie la position du contrôle.

virtual void MoveWindow(
    int x,  
    int y,  
    int nWidth,  
    int nHeight);

Paramètres

x
Nouvelle position du côté gauche de la fenêtre.

y
Nouvelle position du bord supérieur de la fenêtre.

nWidth
La nouvelle largeur de la fenêtre

nHeight
La nouvelle hauteur de la fenêtre.

Rapide active le contrôle de contenu.

virtual BOOL QuickActivate();

Valeur de retour

Différent de zéro si le site de contrôle a été activé, sinon, zéro.

Notes

Cette fonction doit être appelée uniquement si l’utilisateur remplace le processus de création du contrôle.

Le IPersist*::Load et IPersist*::InitNew méthodes doivent être appelées après l’activation rapide. Le contrôle doit établir sa connexion aux récepteurs du conteneur pendant l’activation rapide. Toutefois, ces connexions ne sont pas actives jusqu'à ce que IPersist*::Load ou IPersist*::InitNew a été appelée.

Définit la propriété du contrôle spécifiée par dwDispID.

virtual BOOL AFX_CDECL SafeSetProperty(
    DISPID dwDispID,  
    VARTYPE vtProp, ...);

Paramètres

dwDispID
Identifie l’ID de dispatch de la propriété ou méthode, trouvée dans le contrôle IDispatch interface, à définir.

vtProp
Spécifie le type de propriété à définir. Pour les valeurs possibles, consultez la section Notes pour COleDispatchDriver::InvokeHelper.

...
Un seul paramètre du type spécifié par vtProp.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

Notes

System_CAPS_ICON_note.jpg Remarque

Contrairement aux SetProperty et SetPropertyV, si une erreur s’est produite (par exemple, essayez de définir une propriété qui n’existe pas), aucune exception n’est levée.

Définit le contrôle comme le bouton par défaut.

void SetDefaultButton(BOOL bDefault);

Paramètres

bDefault
Différent de zéro si le contrôle devient le bouton par défaut ; Sinon, zéro.

Notes

System_CAPS_ICON_note.jpg Remarque

Le contrôle doit avoir la OLEMISC_ACTSLIKEBUTTON état bit défini.

Modifie la valeur d’identificateur d’élément boîte de dialogue du contrôle.

virtual int SetDlgCtrlID(int nID);

Paramètres

nID
La nouvelle valeur de l’identificateur.

Valeur de retour

Si l’opération réussit, la boîte de dialogue précédente élément identificateur de la fenêtre. sinon 0.

Notes

Définit le focus sur le contrôle.

virtual CWnd* SetFocus();  
virtual CWnd* SetFocus(LPMSG lpmsg);

Paramètres

lpmsg
Un pointeur vers un structure MSG. Cette structure contient le déclenchement de message Windows le SetFocus demande pour le contrôle contenu dans le site actuel du contrôle.

Valeur de retour

Pointeur vers la fenêtre qui avait précédemment le focus.

Définit la propriété du contrôle spécifiée par dwDispID.

virtual void AFX_CDECL SetProperty(
    DISPID dwDispID,  
    VARTYPE vtProp, ...);

Paramètres

dwDispID
Identifie l’ID de dispatch de la propriété ou méthode, trouvée dans le contrôle IDispatch interface, à définir.

vtProp
Spécifie le type de propriété à définir. Pour les valeurs possibles, consultez la section Notes pour COleDispatchDriver::InvokeHelper.

...
Un seul paramètre du type spécifié par vtProp.

Notes

Si SetProperty rencontre une erreur, une exception est levée.

Le type d’exception est déterminé par la valeur de retour de la tentative de définition de la propriété ou méthode. Si la valeur de retour est DISP_E_EXCEPTION, un COleDispatchExcpetion est générée ; sinon une COleException.

Définit la propriété du contrôle spécifiée par dwDispID.

virtual void SetPropertyV(
    DISPID dwDispID,  
    VARTYPE vtProp,  
    va_list argList);

Paramètres

dwDispID
Identifie l’ID de dispatch de la propriété ou méthode, trouvée dans le contrôle IDispatch interface, à définir.

vtProp
Spécifie le type de propriété à définir. Pour les valeurs possibles, consultez la section Notes pour COleDispatchDriver::InvokeHelper.

argList
Pointeur vers la liste d’arguments.

Notes

Paramètres supplémentaires pour la méthode ou propriété appelée peuvent être passeed à l’aide de la arg_list paramètre. Si SetProperty rencontre une erreur, une exception est levée.

Le type d’exception est déterminé par la valeur de retour de la tentative de définition de la propriété ou méthode. Si la valeur de retour est DISP_E_EXCEPTION, un COleDispatchExcpetion est générée ; sinon une COleException.

Définit la taille, position et ordre de plan de site du contrôle.

virtual BOOL SetWindowPos(
    const CWnd* pWndInsertAfter,  
    int x,  
    int y,  
    int cx,  
    int cy,  
    UINT nFlags);

Paramètres

pWndInsertAfter
Pointeur vers la fenêtre.

x
Nouvelle position du côté gauche de la fenêtre.

y
Nouvelle position du bord supérieur de la fenêtre.

cx
La nouvelle largeur de la fenêtre

cy
La nouvelle hauteur de la fenêtre.

nFlags
Spécifie la fenêtre de dimensionnement et de positionnement des indicateurs. Pour les valeurs possibles, consultez la section Notes pour SetWindowPos dans les SDK Windows.

Valeur de retour

Différent de zéro si l’opération réussit, sinon, zéro.

Définit le texte pour le site du contrôle.

virtual void SetWindowText(LPCTSTR lpszString);

Paramètres

lpszString
Pointeur vers une chaîne terminée par null à utiliser en tant que le nouveau texte de titre ou le contrôle.

Notes

Cette fonction essaie d’abord de définir la propriété stockée Caption. Si la propriété stockée Caption n’est pas pris en charge, la propriété Text est définie à la place.

Définit l’état d’affichage de la fenêtre.

virtual BOOL ShowWindow(int nCmdShow);

Paramètres

nCmdShow
Spécifie comment le site de contrôle doit être affiché. Il doit être une des valeurs suivantes :

  • SW_HIDE masque cette fenêtre et Active une autre fenêtre.

  • SW_MINIMIZE réduit la fenêtre et Active la fenêtre de niveau supérieur dans la liste du système.

  • SW_RESTORE active et affiche la fenêtre. Si la fenêtre est réduite ou agrandie, Windows le restaure à sa taille et sa position d’origine.

  • SW_SHOW Active la fenêtre et l’affiche dans sa taille actuelle et son emplacement.

  • SW_SHOWMAXIMIZED Active la fenêtre et l’affiche comme une fenêtre agrandie.

  • SW_SHOWMINIMIZED active de la fenêtre et l’affiche sous forme d’icône.

  • SW_SHOWMINNOACTIVE affiche la fenêtre sous forme d’icône. La fenêtre actuellement active reste active.

  • SW_SHOWNA affiche la fenêtre dans son état actuel. La fenêtre actuellement active reste active.

  • SW_SHOWNOACTIVATE affiche la fenêtre dans sa taille et la position la plus récente. La fenêtre actuellement active reste active.

  • SW_SHOWNORMAL active et affiche la fenêtre. Si la fenêtre est réduite ou agrandie, Windows le restaure à sa taille et sa position d’origine.

Valeur de retour

Différent de zéro si la fenêtre a été précédemment visible ; 0 si la fenêtre a été précédemment masquée.

CCmdTarget (classe)
Graphique de la hiérarchie
COleControlContainer (classe)

Afficher: