Partager via

COlePasteSpecialDialog, classe

  • Article

Utilisée pour la boîte de dialogue OLE Collage spécial.

Syntaxe

class COlePasteSpecialDialog : public COleDialog

Membres

Constructeurs publics

Nom Description
COlePasteSpecialDialog ::COlePasteSpecialDialog Construit un objet COlePasteSpecialDialog.

Méthodes publiques

Nom Description
COlePasteSpecialDialog ::AddFormat Ajoute des formats personnalisés à la liste des formats que votre application peut coller.
COlePasteSpecialDialog ::AddLinkEntry Ajoute une nouvelle entrée à la liste des formats presse-papiers pris en charge.
COlePasteSpecialDialog ::AddStandardFormats Ajoute CF_BITMAP, CF_DIB, CF_METAFILEPICT et éventuellement CF_LINKSOURCE à la liste des formats que votre application peut coller.
COlePasteSpecialDialog ::CreateItem Crée l’élément dans le document conteneur au format spécifié.
COlePasteSpecialDialog ::D oModal Affiche la boîte de dialogue OLE Paste Special.
COlePasteSpecialDialog ::GetDrawAspect Indique s’il faut dessiner un élément en tant qu’icône ou non.
COlePasteSpecialDialog ::GetIconicMetafile Obtient un handle pour le métafichier associé à la forme emblématique de cet élément.
COlePasteSpecialDialog ::GetPasteIndex Obtient l’index des options de collage disponibles choisies par l’utilisateur.
COlePasteSpecialDialog ::GetSelectionType Obtient le type de sélection choisi.

Membres de données publics

Nom Description
COlePasteSpecialDialog ::m_ps Structure de type OLEUIPASTESPECIAL qui contrôle la fonction de la boîte de dialogue.

Notes

Créez un objet de classe COlePasteSpecialDialog lorsque vous souhaitez appeler cette boîte de dialogue. Une fois qu’un COlePasteSpecialDialog objet a été construit, vous pouvez utiliser les fonctions membres AddFormat et AddStandardFormats pour ajouter des formats presse-papiers à la boîte de dialogue. Vous pouvez également utiliser la structure m_ps pour initialiser les valeurs ou les états des contrôles dans la boîte de dialogue. La m_ps structure est de type OLEUIPASTESPECIAL.

Pour plus d’informations, consultez la structure OLEUIPASTESPECIAL 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

COlePasteSpecialDialog

Spécifications

En-tête : afxodlgs.h

COlePasteSpecialDialog ::AddFormat

Appelez cette fonction pour ajouter de nouveaux formats à la liste des formats que votre application peut prendre en charge dans une opération Coller spécial.

void AddFormat(
    const FORMATETC& formatEtc,
    LPTSTR lpszFormat,
    LPTSTR lpszResult,
    DWORD flags);

void AddFormat(
    UINT cf,
    DWORD tymed,
    UINT nFormatID,
    BOOL bEnableIcon,
    BOOL bLink);

Paramètres

Fmt
Référence au type de données à ajouter.

lpszFormat
Chaîne qui décrit le format pour l’utilisateur.

lpszResult
Chaîne qui décrit le résultat si ce format est choisi dans la boîte de dialogue.

flags
Les différentes options de liaison et d’incorporation disponibles pour ce format. Cet indicateur est une combinaison au niveau du bit d’une ou plusieurs des différentes valeurs du type énuméré OLEUIPASTEFLAG.

cf
Format du Presse-papiers à ajouter.

tymed
Types de supports disponibles dans ce format. Il s’agit d’une combinaison au niveau du bit d’une ou plusieurs des valeurs du type énuméré TYMED.

nFormatID
ID de la chaîne qui identifie ce format. Le format de cette chaîne est deux chaînes distinctes séparées par un caractère '\n'. La première chaîne est la même que celle qui serait passée dans le paramètre lpstrFormat , et la seconde est la même que le paramètre lpstrResult .

bEnableIcon
Indicateur qui détermine si la case à cocher Afficher en tant qu’icône est activée lorsque ce format est choisi dans la zone de liste.

cligner
Indicateur qui détermine si la case d’option Coller le lien est activée lorsque ce format est choisi dans la zone de liste.

Notes

Cette fonction peut être appelée pour ajouter des formats standard tels que CF_TEXT ou CF_TIFF ou des formats personnalisés que votre application a inscrits auprès du système. Pour plus d’informations sur le collage d’objets de données dans votre application, consultez l’article Objets de données et sources de données : Manipulation.

Pour plus d’informations, consultez le type d’énumération TYMED et la structure FORMATETC dans le Kit de développement logiciel (SDK) Windows.

Pour plus d’informations, consultez le type énuméré OLEUIPASTEFLAG dans le Kit de développement logiciel (SDK) Windows.

COlePasteSpecialDialog ::AddLinkEntry

Ajoute une nouvelle entrée à la liste des formats presse-papiers pris en charge.

OLEUIPASTEFLAG AddLinkEntry(UINT cf);

Paramètres

cf
Format du Presse-papiers à ajouter.

Valeur de retour

Structure OLEUIPASTEFLAG contenant les informations de la nouvelle entrée de lien.

COlePasteSpecialDialog ::AddStandardFormats

Appelez cette fonction pour ajouter les formats presse-papiers suivants à la liste des formats que votre application peut prendre en charge dans une opération Coller spécial :

void AddStandardFormats(BOOL bEnableLink = TRUE);

Paramètres

bEnableLink
Indicateur qui détermine s’il faut ajouter CF_LINKSOURCE à la liste des formats que votre application peut coller.

Notes

  • CF_BITMAP

  • CF_DIB

  • CF_METAFILEPICT

  • « Objet incorporé »

  • (facultatif) " Source du lien »

Ces formats sont utilisés pour prendre en charge l’incorporation et la liaison.

COlePasteSpecialDialog ::COlePasteSpecialDialog

Construit un objet COlePasteSpecialDialog.

COlePasteSpecialDialog(
    DWORD dwFlags = PSF_SELECTPASTE,
    COleDataObject* pDataObject = NULL,
    CWnd* pParentWnd = NULL);

Paramètres

dwFlags
L’indicateur de création contient un nombre quelconque des indicateurs suivants combinés à l’aide de l’opérateur OR au niveau du bit :

  • PSF_SELECTPASTE Spécifie que la case d’option Coller est cochée initialement lorsque la boîte de dialogue est appelée. Impossible d’utiliser en combinaison avec PSF_SELECTPASTELINK. Il s’agit de la valeur par défaut.

  • PSF_SELECTPASTELINK Spécifie que la case d’option Coller le lien est activée initialement lorsque la boîte de dialogue est appelée. Impossible d’utiliser en combinaison avec PSF_SELECTPASTE.

  • PSF_CHECKDISPLAYASICON Spécifie que la case à cocher Afficher en tant qu’icône est cochée initialement lorsque la boîte de dialogue est appelée.

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

pDataObject
Pointe vers le COleDataObject pour le collage. Si cette valeur est NULL, elle obtient le COleDataObject Presse-papiers.

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

Cette fonction construit uniquement un COlePasteSpecialDialog objet. Pour afficher la boîte de dialogue, appelez la fonction DoModal .

Pour plus d’informations, consultez le type énuméré OLEUIPASTEFLAG dans le Kit de développement logiciel (SDK) Windows.

COlePasteSpecialDialog ::CreateItem

Crée le nouvel élément qui a été choisi dans la boîte de dialogue Coller spécial.

BOOL CreateItem(COleClientItem* pNewItem);

Paramètres

pNewItem
Pointe vers une COleClientItem instance. Ne peut pas avoir la valeur NULL.

Valeur de retour

Différent de zéro si l’élément a été créé avec succès ; sinon 0.

Notes

Cette fonction ne doit être appelée qu’après que DoModal retourne IDOK.

COlePasteSpecialDialog ::D oModal

Affiche la boîte de dialogue OLE Paste Special.

virtual INT_PTR DoModal();

Valeur de retour

État d’achèvement de la boîte de dialogue. 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 OleUIPasteSpecial 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_ps , 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 l’entrée d’informations par l’utilisateur dans la boîte de dialogue.

COlePasteSpecialDialog ::GetDrawAspect

Détermine si l’utilisateur a choisi d’afficher l’élément sélectionné en tant qu’icône.

DVASPECT GetDrawAspect() const;

Valeur de retour

Méthode nécessaire pour restituer l’objet.

  • DVASPECT_CONTENT Retourné si la case à cocher Afficher en tant qu’icône n’a pas été cochée lorsque la boîte de dialogue a été ignorée.

  • DVASPECT_ICON Retourné si la case à cocher Afficher en tant qu’icône a été cochée lorsque la boîte de dialogue a été ignorée.

Notes

Appelez cette fonction uniquement après que DoModal retourne IDOK.

Pour plus d’informations sur l’aspect du dessin, consultez la structure FORMATETC dans le Kit de développement logiciel (SDK) Windows.

COlePasteSpecialDialog ::GetIconicMetafile

Obtient le métafichier associé à l’élément sélectionné par l’utilisateur.

HGLOBAL GetIconicMetafile() const;

Valeur de retour

Handle du métafichier contenant l’aspect iconique de l’élément sélectionné, si la case à cocher Afficher en tant qu’icône a été cochée lorsque la boîte de dialogue a été ignorée en choisissant OK ; sinon NULL.

COlePasteSpecialDialog ::GetPasteIndex

Obtient la valeur d’index associée à l’entrée sélectionnée par l’utilisateur.

int GetPasteIndex() const;

Valeur de retour

Index dans le tableau de OLEUIPASTEENTRY structures sélectionnées par l’utilisateur. Le format qui correspond à l’index sélectionné doit être utilisé lors de l’exécution de l’opération de collage.

Notes

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

COlePasteSpecialDialog ::GetSelectionType

Détermine le type de sélection effectué par l’utilisateur.

UINT GetSelectionType() const;

Valeur de retour

Retourne le type de sélection effectué.

Notes

Les valeurs de type de retour sont spécifiées par le Selection type d’énumération déclaré dans la COlePasteSpecialDialog classe.

enum Selection {
    pasteLink,
    pasteNormal,
    pasteOther,
    pasteStatic
    };

Voici quelques descriptions de ces valeurs :

  • COlePasteSpecialDialog::pasteLink La case d’option Coller le lien a été cochée et le format choisi était un format OLE standard.

  • COlePasteSpecialDialog::pasteNormal La case d’option Coller a été cochée et le format choisi était un format OLE standard.

  • COlePasteSpecialDialog::pasteOther Le format sélectionné n’est pas un format OLE standard.

  • COlePasteSpecialDialog::pasteStatic Le format choisi était un métafichier.

COlePasteSpecialDialog ::m_ps

Structure de type OLEUIPASTESPECIAL utilisée pour contrôler le comportement de la boîte de dialogue Coller spécial.

OLEUIPASTESPECIAL m_ps;

Notes

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

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

Voir aussi

Exemple OCLIENT MFC
COleDialog, classe
Graphique hiérarchique
COleDialog, classe