COleChangeIconDialog, classe

Utilisé pour la boîte de dialogue OLE Changer d'icône.

Syntaxe

class COleChangeIconDialog : public COleDialog

Membres

Constructeurs publics

Nom	Description
COleChangeIconDialog ::COleChangeIconDialog	Construit un objet COleChangeIconDialog.

Méthodes publiques

Nom	Description
COleChangeIconDialog ::D oChangeIcon	Effectue la modification spécifiée dans la boîte de dialogue.
COleChangeIconDialog ::D oModal	Affiche la boîte de dialogue Icône de modification OLE 2.
COleChangeIconDialog ::GetIconicMetafile	Obtient un handle pour le métafichier associé à la forme emblématique de cet élément.

Membres de données publics

Nom	Description
COleChangeIconDialog ::m_ci	Structure qui contrôle le comportement de la boîte de dialogue.

Notes

Créez un objet de classe COleChangeIconDialog lorsque vous souhaitez appeler cette boîte de dialogue. Une fois qu’un COleChangeIconDialog objet a été construit, vous pouvez utiliser la structure m_ci pour initialiser les valeurs ou les états des contrôles dans la boîte de dialogue. La m_ci structure est de type OLEUICHANGEICON. Pour plus d’informations sur l’utilisation de cette classe de dialogue, consultez la fonction membre DoModal .

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

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

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleChangeIconDialog

Spécifications

En-tête : afxodlgs.h

COleChangeIconDialog ::COleChangeIconDialog

Cette fonction construit uniquement un COleChangeIconDialog objet.

explicit COleChangeIconDialog(
    COleClientItem* pItem,
    DWORD dwFlags = CIF_SELECTCURRENT,
    CWnd* pParentWnd = NULL);

Paramètres

pItem
Pointe vers l’élément à convertir.

dwFlags
Indicateur de création, qui contient un nombre quelconque des valeurs suivantes combinées à l’aide de l’opérateur au niveau du bit :

• CIF_SELECTCURRENT Spécifie que la case d’option actuelle est sélectionnée initialement lorsque la boîte de dialogue est appelée. Il s’agit de la valeur par défaut.

• CIF_SELECTDEFAULT Spécifie que la case d’option par défaut est sélectionnée initialement lorsque la boîte de dialogue est appelée.

• CIF_SELECTFROMFILE Spécifie que la case d’option De fichier est sélectionnée initialement lorsque la boîte de dialogue est appelée.

• CIF_SHOWHELP Spécifie que le bouton d’aide s’affiche lorsque la boîte de dialogue est appelée.

• CIF_USEICONEXE Spécifie que l’icône doit être extraite de l’exécutable spécifié dans le szIconExe champ de m_ci au lieu de récupérer à partir du type. Cela est utile pour l’incorporation ou la liaison à des fichiers non OLE.

pParentWnd
Pointe vers l’objet de fenêtre parent ou propriétaire (de type CWnd) auquel appartient l’objet de boîte de dialogue. S’il s’agit de NULL, la fenêtre parente de la boîte de dialogue est définie sur la fenêtre principale de l’application.

Notes

Pour afficher la boîte de dialogue, appelez la fonction DoModal .

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

COleChangeIconDialog ::D oChangeIcon

Appelez cette fonction pour modifier l’icône représentant l’élément en l’élément sélectionné dans la boîte de dialogue après que DoModal retourne IDOK.

BOOL DoChangeIcon(COleClientItem* pItem);

Paramètres

pItem
Pointe vers l’élément dont l’icône change.

Valeur de retour

Différent de zéro si la modification réussit ; sinon 0.

COleChangeIconDialog ::D oModal

Appelez cette fonction pour afficher la boîte de dialogue Icône de modification OLE.

virtual INT_PTR DoModal();

Valeur de retour

État d’achèvement de la boîte de dialogue. L’une des valeurs suivantes :

• IDOK si la boîte de dialogue s’affiche correctement.

• IDCANCEL si l’utilisateur a annulé la boîte de dialogue.

• IDABORT si une erreur s’est produite. Si IDABORT est retourné, appelez la COleDialog::GetLastError fonction membre pour obtenir plus d’informations sur le type d’erreur qui s’est produite. Pour obtenir la liste des erreurs possibles, consultez la fonction OleUIChangeIcon dans le Kit de développement logiciel (SDK) Windows.

Notes

Si vous souhaitez initialiser les différents contrôles de boîte de dialogue en définissant les membres de la structure m_ci , vous devez le faire avant d’appeler DoModal, mais après la construction de l’objet de dialogue.

Si DoModal retourne IDOK, vous pouvez appeler d’autres fonctions membres pour récupérer les paramètres ou les informations qui ont été entrés par l’utilisateur dans la boîte de dialogue.

COleChangeIconDialog ::GetIconicMetafile

Appelez cette fonction pour obtenir un handle au métafichier qui contient l’aspect emblématique de l’élément sélectionné.

HGLOBAL GetIconicMetafile() const;

Valeur de retour

Handle du métafichier contenant l’aspect iconique de la nouvelle icône, si la boîte de dialogue a été ignorée en choisissant OK ; sinon, l’icône telle qu’elle était avant l’affichage de la boîte de dialogue.

COleChangeIconDialog ::m_ci

Structure de type OLEUICHANGEICON utilisée pour contrôler le comportement de la boîte de dialogue Modifier l’icône.

OLEUICHANGEICON m_ci;

Notes

Les membres de cette structure peuvent être modifiés directement ou via des fonctions membres.

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

Voir aussi

COleDialog, classe
Graphique hiérarchique
COleDialog, classe