Classe COlePasteSpecialDialog

Utilizzata per la finestra di dialogo incolla speciale OLE.

Sintassi

class COlePasteSpecialDialog : public COleDialog

Membri

Costruttori pubblici

Metodi pubblici

Membri dati pubblici

Osservazioni:

Creare un oggetto della classe COlePasteSpecialDialog quando si desidera chiamare questa finestra di dialogo. Dopo aver costruito un COlePasteSpecialDialog oggetto, è possibile utilizzare le funzioni membro AddFormat e AddStandardFormats per aggiungere formati appunti alla finestra di dialogo. È anche possibile utilizzare la struttura m_ps per inizializzare i valori o gli stati dei controlli nella finestra di dialogo. La m_ps struttura è di tipo OLEUIPASTESPECIAL.

Per altre informazioni, vedere la struttura OLEUIPASTESPECIAL in Windows SDK.

Per altre informazioni sulle finestre di dialogo specifiche di OLE, vedere l'articolo Finestre di dialogo in OLE.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COlePasteSpecialDialog

Requisiti

Intestazione: afxodlgs.h

COlePasteSpecialDialog::AddFormat

Chiamare questa funzione per aggiungere nuovi formati all'elenco dei formati supportati dall'applicazione in un'operazione Incolla speciale.

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

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

Parametri

Fmt
Riferimento al tipo di dati da aggiungere.

lpszFormat
Stringa che descrive il formato per l'utente.

lpszResult
Stringa che descrive il risultato se questo formato viene scelto nella finestra di dialogo.

flags
Opzioni di collegamento e incorporamento diverse disponibili per questo formato. Questo flag è una combinazione bit per bit di uno o più valori diversi nel tipo enumerato OLEUIPASTEFLAG.

cfr
Formato degli Appunti da aggiungere.

tymed
Tipi di supporti disponibili in questo formato. Si tratta di una combinazione bit per bit di uno o più valori nel tipo enumerato TYMED.

nFormatID
ID della stringa che identifica questo formato. Il formato di questa stringa è costituito da due stringhe separate da un carattere '\n'. La prima stringa è la stessa che verrebbe passata nel parametro lpstrFormat e la seconda è uguale al parametro lpstrResult .

bEnableIcon
Flag che determina se la casella di controllo Visualizza come icona è abilitata quando questo formato viene scelto nella casella di riepilogo.

ammiccare
Flag che determina se il pulsante di opzione Incolla collegamento è abilitato quando questo formato viene scelto nella casella di riepilogo.

Osservazioni:

Questa funzione può essere chiamata per aggiungere formati standard, ad esempio CF_TEXT o CF_TIFF o formati personalizzati registrati dall'applicazione nel sistema. Per altre informazioni sull'inserimento di oggetti dati nell'applicazione, vedere l'articolo Oggetti dati e Origini dati: Manipolazione.

Per altre informazioni, vedere il tipo di enumerazione TYMED e la struttura FORMATETC in Windows SDK.

Per altre informazioni, vedere il tipo enumerato OLEUIPASTEFLAG in Windows SDK.

COlePasteSpecialDialog::AddLinkEntry

Aggiunge una nuova voce all'elenco dei formati degli Appunti supportati.

OLEUIPASTEFLAG AddLinkEntry(UINT cf);

Parametri

cfr
Formato degli Appunti da aggiungere.

Valore restituito

Struttura OLEUIPASTEFLAG contenente le informazioni per la nuova voce di collegamento.

COlePasteSpecialDialog::AddStandardFormats

Chiamare questa funzione per aggiungere i formati degli Appunti seguenti all'elenco dei formati che l'applicazione può supportare in un'operazione Incolla speciale:

void AddStandardFormats(BOOL bEnableLink = TRUE);

Parametri

bEnableLink
Flag che determina se aggiungere CF_LINKSOURCE all'elenco dei formati che l'applicazione può incollare.

Osservazioni:

• CF_BITMAP

• CF_DIB

• CF_METAFILEPICT

• "Oggetto incorporato"

• (facoltativamente) " Link Source"

Questi formati vengono usati per supportare l'incorporamento e il collegamento.

COlePasteSpecialDialog::COlePasteSpecialDialog

Costruisce un oggetto COlePasteSpecialDialog.

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

Parametri

dwFlags
Il flag di creazione contiene un numero qualsiasi di flag seguenti combinati usando l'operatore OR bit per bit:

• PSF_SELECTPASTE Specifica che il pulsante di opzione Incolla verrà selezionato inizialmente quando viene chiamata la finestra di dialogo. Impossibile utilizzare in combinazione con PSF_SELECTPASTELINK. Si tratta dell'impostazione predefinita.

• PSF_SELECTPASTELINK Specifica che il pulsante di opzione Incolla collegamento verrà selezionato inizialmente quando viene chiamata la finestra di dialogo. Non può essere utilizzato in combinazione con PSF_SELECTPASTE.

• PSF_CHECKDISPLAYASICON Specifica che la casella di controllo Visualizza come icona verrà selezionata inizialmente quando viene chiamata la finestra di dialogo.

• PSF_SHOWHELP Specifica che il pulsante ? verrà visualizzato quando viene chiamata la finestra di dialogo.

pDataObject
Punta a COleDataObject per incollarlo. Se questo valore è NULL, ottiene l'oggetto COleDataObject dagli Appunti.

pParentWnd
Punta all'oggetto finestra padre o proprietario (di tipo CWnd) a cui appartiene l'oggetto finestra di dialogo. Se è NULL, la finestra padre della finestra di dialogo viene impostata sulla finestra principale dell'applicazione.

Osservazioni:

Questa funzione costruisce solo un COlePasteSpecialDialog oggetto . Per visualizzare la finestra di dialogo, chiamare la funzione DoModal .

Per altre informazioni, vedere il tipo enumerato OLEUIPASTEFLAG in Windows SDK.

COlePasteSpecialDialog::CreateItem

Crea il nuovo elemento scelto nella finestra di dialogo Incolla speciale.

BOOL CreateItem(COleClientItem* pNewItem);

Parametri

pNewItem
Punta a un'istanza COleClientItem di . Non può essere NULL.

Valore restituito

Diverso da zero se l'elemento è stato creato correttamente; in caso contrario, 0.

Osservazioni:

Questa funzione deve essere chiamata solo dopo che DoModal restituisce IDOK.

COlePasteSpecialDialog::D oModal

Visualizza la finestra di dialogo OLE Paste Special .

virtual INT_PTR DoModal();

Valore restituito

Stato di completamento per la finestra di dialogo. Uno dei valori seguenti:

• IDOK se la finestra di dialogo è stata visualizzata correttamente.

• IDCANCEL se l'utente ha annullato la finestra di dialogo.

• IDABORT se si è verificato un errore. Se viene restituito IDABORT, chiamare la COleDialog::GetLastError funzione membro per ottenere altre informazioni sul tipo di errore che si è verificato. Per un elenco dei possibili errori, vedere la funzione OleUIPasteSpecial in Windows SDK.

Osservazioni:

Se si desidera inizializzare i vari controlli della finestra di dialogo impostando i membri della struttura m_ps , è necessario eseguire questa operazione prima di chiamare DoModal, ma dopo la costruzione dell'oggetto dialogo.

Se DoModal restituisce IDOK, è possibile chiamare altre funzioni membro per recuperare le impostazioni o l'input di informazioni da parte dell'utente nella finestra di dialogo.

COlePasteSpecialDialog::GetDrawAspect

Determina se l'utente ha scelto di visualizzare l'elemento selezionato come icona.

DVASPECT GetDrawAspect() const;

Valore restituito

Metodo necessario per eseguire il rendering dell'oggetto.

• DVASPECT_CONTENT Restituito se la casella di controllo Visualizza come icona non è stata selezionata quando la finestra di dialogo è stata chiusa.

• DVASPECT_ICON Restituito se la casella di controllo Visualizza come icona è stata selezionata quando la finestra di dialogo è stata chiusa.

Osservazioni:

Chiamare questa funzione solo dopo che DoModal restituisce IDOK.

Per altre informazioni sull'aspetto del disegno, vedere la struttura FORMATETC in Windows SDK.

COlePasteSpecialDialog::GetIconicMetafile

Ottiene il metafile associato all'elemento selezionato dall'utente.

HGLOBAL GetIconicMetafile() const;

Valore restituito

Handle del metafile contenente l'aspetto iconico dell'elemento selezionato, se la casella di controllo Visualizza come icona è stata selezionata quando la finestra di dialogo è stata chiusa scegliendo OK; in caso contrario, NULL.

COlePasteSpecialDialog::GetPasteIndex

Ottiene il valore di indice associato alla voce selezionata dall'utente.

int GetPasteIndex() const;

Valore restituito

Indice nella matrice di OLEUIPASTEENTRY strutture selezionate dall'utente. Il formato che corrisponde all'indice selezionato deve essere utilizzato quando si esegue l'operazione incolla.

Osservazioni:

Per altre informazioni, vedere la struttura OLEUIPASTEENTRY in Windows SDK.

COlePasteSpecialDialog::GetSelectionType

Determina il tipo di selezione effettuata dall'utente.

UINT GetSelectionType() const;

Valore restituito

Restituisce il tipo di selezione effettuata.

Osservazioni:

I valori del tipo restituito vengono specificati dal Selection tipo di enumerazione dichiarato nella COlePasteSpecialDialog classe .

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

Di seguito sono riportate brevi descrizioni di questi valori:

• COlePasteSpecialDialog::pasteLink Il pulsante di opzione Incolla collegamento è stato selezionato e il formato scelto era un formato OLE standard.

• COlePasteSpecialDialog::pasteNormal Il pulsante di opzione Incolla è stato selezionato e il formato scelto era un formato OLE standard.

• COlePasteSpecialDialog::pasteOther Il formato selezionato non è un formato OLE standard.

• COlePasteSpecialDialog::pasteStatic Il formato scelto è un metafile.

COlePasteSpecialDialog::m_ps

Struttura di tipo OLEUIPASTESPECIAL utilizzata per controllare il comportamento della finestra di dialogo Incolla speciale.

OLEUIPASTESPECIAL m_ps;

Osservazioni:

I membri di questa struttura possono essere modificati direttamente o tramite funzioni membro.

Per altre informazioni, vedere la struttura OLEUIPASTESPECIAL in Windows SDK.

Vedi anche

OCLIENT di esempio MFC
Classe COleDialog
Grafico della gerarchia
Classe COleDialog