COlePropertiesDialog, classe

Encapsule la boîte de dialogue Propriétés d'objet OLE courante Windows.

Syntaxe

class COlePropertiesDialog : public COleDialog

Membres

Constructeurs publics

Nom	Description
COlePropertiesDialog ::COlePropertiesDialog	Construit un objet COlePropertiesDialog.

Méthodes publiques

Nom	Description
COlePropertiesDialog ::D oModal	Affiche la boîte de dialogue et permet à l’utilisateur d’effectuer une sélection.
COlePropertiesDialog ::OnApplyScale	Appelé par l’infrastructure lorsque la mise à l’échelle de l’élément de document a changé.

Membres de données publics

Nom	Description
COlePropertiesDialog ::m_gp	Structure utilisée pour initialiser la page « Général » d’un COlePropertiesDialog objet.
COlePropertiesDialog ::m_lp	Structure utilisée pour initialiser la page « Lien » d’un COlePropertiesDialog objet.
COlePropertiesDialog ::m_op	Structure utilisée pour initialiser l’objet COlePropertiesDialog .
COlePropertiesDialog ::m_psh	Structure utilisée pour ajouter des pages de propriétés personnalisées supplémentaires.
COlePropertiesDialog ::m_vp	Structure utilisée pour personnaliser la page « Affichage » d’un COlePropertiesDialog objet.

Notes

Les boîtes de dialogue Propriétés d’objet OLE courantes permettent d’afficher et de modifier facilement les propriétés d’un élément de document OLE de manière cohérente avec les normes Windows. Ces propriétés incluent, entre autres, des informations sur le fichier représenté par l’élément de document, des options d’affichage de l’icône et de la mise à l’échelle de l’image, ainsi que des informations sur le lien de l’élément (si l’élément est lié).

Pour utiliser un COlePropertiesDialog objet, commencez par créer l’objet à l’aide du COlePropertiesDialog constructeur. Une fois la boîte de dialogue construite, appelez la DoModal fonction membre pour afficher la boîte de dialogue et autoriser l’utilisateur à modifier les propriétés de l’élément. DoModal retourne si l’utilisateur a sélectionné le bouton OK (IDOK) ou Cancel (IDCANCEL). En plus des boutons OK et Annuler, il existe un bouton Appliquer. Lorsque l’utilisateur sélectionne Appliquer, toutes les modifications apportées aux propriétés de l’élément de document sont appliquées à l’élément et son image est automatiquement mise à jour, mais reste active.

Le membre de données m_psh est un pointeur vers une PROPSHEETHEADER structure et, dans la plupart des cas, vous n’aurez pas besoin de l’accéder explicitement. Une exception est que vous avez besoin de pages de propriétés supplémentaires au-delà des pages Général, Affichage et Lien par défaut. Dans ce cas, vous pouvez modifier le m_psh membre de données pour inclure vos pages personnalisées avant d’appeler la DoModal fonction membre.

Pour plus d’informations sur les boîtes de dialogue OLE, consultez l’article Boîtes de dialogue dans OLE.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COlePropertiesDialog

Spécifications

En-tête : afxodlgs.h

COlePropertiesDialog ::COlePropertiesDialog

Crée un objet COlePropertiesDialog.

COlePropertiesDialog(
    COleClientItem* pItem,
    UINT nScaleMin = 10,
    UINT nScaleMax = 500,
    CWnd* pParentWnd = NULL);

Paramètres

pItem
Pointeur vers l’élément de document dont les propriétés sont accessibles.

nScaleMin
Pourcentage de mise à l’échelle minimal pour l’image d’élément de document.

nScaleMax
Pourcentage maximal de mise à l’échelle pour l’image d’élément de document.

pParentWnd
Pointeur vers le parent ou le propriétaire de la boîte de dialogue.

Notes

Dérivez votre classe de dialogue Propriétés d’objet COlePropertiesDialog OLE courantes afin d’implémenter la mise à l’échelle pour vos éléments de document. Toutes les boîtes de dialogue implémentées par une instance de cette classe ne prennent pas en charge la mise à l’échelle de l’élément de document.

Par défaut, la boîte de dialogue Propriétés de l’objet OLE commune comporte trois pages par défaut :

• Général

  Cette page contient des informations système pour le fichier représenté par l’élément de document sélectionné. À partir de cette page, l’utilisateur peut convertir l’élément sélectionné en un autre type.

• Afficher

  Cette page contient des options permettant d’afficher l’élément, de modifier l’icône et de modifier la mise à l’échelle de l’image.

• Lien

  Cette page contient des options permettant de modifier l’emplacement de l’élément lié et de mettre à jour l’élément lié. À partir de cette page, l’utilisateur peut interrompre le lien de l’élément sélectionné.

Pour ajouter des pages au-delà de celles fournies par défaut, modifiez la variable membre m_psh avant de quitter le constructeur de votre COlePropertiesDialogclasse dérivée. Il s’agit d’une implémentation avancée du COlePropertiesDialog constructeur.

COlePropertiesDialog ::D oModal

Appelez cette fonction membre pour afficher la boîte de dialogue Propriétés d’objet OLE courantes de Windows et autoriser l’utilisateur à afficher et/ou modifier les différentes propriétés de l’élément de document.

virtual INT_PTR DoModal();

Valeur de retour

IDOK ou IDCANCEL en cas de réussite ; sinon 0. IDOK et IDCANCEL sont des constantes qui indiquent si l’utilisateur a sélectionné le bouton OK ou Annuler.

Si IDCANCEL est retourné, vous pouvez appeler la fonction Windows CommDlgExtendedError pour déterminer si une erreur s’est produite.

COlePropertiesDialog ::m_gp

Structure de type OLEUIGNRLPROPS, utilisée pour initialiser la page Général de la boîte de dialogue Propriétés de l’objet OLE.

OLEUIGNRLPROPS m_gp;

Notes

Cette page affiche le type et la taille d’une incorporation et permet à l’utilisateur d’accéder à la boîte de dialogue Convertir. Cette page affiche également la destination du lien si l’objet est un lien.

Pour plus d’informations sur la OLEUIGNRLPROPS structure, consultez le Kit de développement logiciel (SDK) Windows.

COlePropertiesDialog ::m_lp

Structure de type OLEUILINKPROPS, utilisée pour initialiser la page Lien de la boîte de dialogue Propriétés de l’objet OLE.

OLEUILINKPROPS m_lp;

Notes

Cette page affiche l’emplacement de l’élément lié et permet à l’utilisateur de mettre à jour ou de rompre le lien vers l’élément.

Pour plus d’informations sur la OLEUILINKPROPS structure, consultez le Kit de développement logiciel (SDK) Windows.

COlePropertiesDialog ::m_op

Structure de type OLEUIOBJECTPROPS, utilisée pour initialiser la boîte de dialogue Propriétés d’objet OLE courantes.

OLEUIOBJECTPROPS m_op;

Notes

Cette structure contient des membres utilisés pour initialiser les pages Général, Lien et Affichage.

Pour plus d’informations, consultez les structures OLEUIOBJECTPROPS et OLEUILINKPROPS dans le Kit de développement logiciel (SDK) Windows.

COlePropertiesDialog ::m_psh

Structure de type PROPSHEETHEADER, dont les membres stockent les caractéristiques de l’objet de dialogue.

PROPSHEETHEADER m_psh;

Notes

Après avoir construit un COlePropertiesDialog objet, vous pouvez utiliser m_psh pour définir différents aspects de la boîte de dialogue avant d’appeler la DoModal fonction membre.

Si vous modifiez directement le membre de m_psh données, vous remplacerez tout comportement par défaut.

Pour plus d’informations sur la PROPSHEETHEADER structure, consultez le Kit de développement logiciel (SDK) Windows.

COlePropertiesDialog ::m_vp

Structure de type OLEUIVIEWPROPS, utilisée pour initialiser la page Affichage de la boîte de dialogue Propriétés de l’objet OLE.

OLEUIVIEWPROPS m_vp;

Notes

Cette page permet à l’utilisateur de basculer entre les vues « contenu » et « icône » de l’objet, et de modifier sa mise à l’échelle dans le conteneur. Il permet également à l’utilisateur d’accéder à la boîte de dialogue Modifier l’icône lorsque l’objet est affiché en tant qu’icône.

Pour plus d’informations sur la OLEUIVIEWPROPS structure, consultez le Kit de développement logiciel (SDK) Windows.

COlePropertiesDialog ::OnApplyScale

Appelé par l’infrastructure lorsque la valeur de mise à l’échelle a changé et que ok ou Appliquer a été sélectionné.

virtual BOOL OnApplyScale(
    COleClientItem* pItem,
    int nCurrentScale,
    BOOL bRelativeToOrig);

Paramètres

pItem
Pointeur vers l’élément de document dont les propriétés sont accessibles.

nCurrentScale
Valeur numérique de l’échelle de boîte de dialogue.

bRelativeToOrig
Indique si la mise à l’échelle s’applique à la taille d’origine de l’élément de document.

Valeur de retour

Différent de zéro s’il est géré ; sinon 0.

Notes

L'implémentation par défaut n'exécute aucune opération. Vous devez remplacer cette fonction pour activer les contrôles de mise à l’échelle.

Remarque

Avant l’affichage de la boîte de dialogue propriétés d’objet OLE courante, l’infrastructure appelle cette fonction avec une valeur NULL pour pItem et un - 1 pour nCurrentScale. Cela permet de déterminer si les contrôles de mise à l’échelle doivent être activés.

Voir aussi

Exemple CIRC MFC
COleDialog, classe
Graphique hiérarchique
COleDialog, classe
CPropertyPage, classe