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
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.
Affichage
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