Classe COleInsertDialog

Utilizzata per la finestra di dialogo di inserimento oggetto OLE.

Sintassi

class COleInsertDialog : public COleDialog

Membri

Costruttori pubblici

Metodi pubblici

Membri dati pubblici

Osservazioni:

Creare un oggetto della classe COleInsertDialog quando si desidera chiamare questa finestra di dialogo. Dopo aver costruito un COleInsertDialog oggetto, è possibile utilizzare la struttura m_io per inizializzare i valori o gli stati dei controlli nella finestra di dialogo. La m_io struttura è di tipo OLEUIINSERTOBJECT. Per altre informazioni sull'uso di questa classe di dialoghi, vedere la funzione membro DoModal .

Per altre informazioni, vedere la struttura OLEUIINSERTOBJECT 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

COleInsertDialog

Requisiti

Intestazione: afxodlgs.h

COleInsertDialog::COleInsertDialog

Questa funzione costruisce solo un COleInsertDialog oggetto .

COleInsertDialog (
    DWORD dwFlags = IOF_SELECTCREATENEW,
    CWnd* pParentWnd = NULL);

Parametri

dwFlags
Flag di creazione che contiene un numero qualsiasi dei valori seguenti da combinare usando l'operatore OR bit per bit:

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

• IOF_SELECTCREATENEW Specifica che il pulsante di opzione Crea nuovo verrà selezionato inizialmente quando viene chiamata la finestra di dialogo. Si tratta dell'impostazione predefinita e non può essere usata con IOF_SELECTCREATEFROMFILE.

• IOF_SELECTCREATEFROMFILE Specifica che il pulsante di opzione Crea da file verrà selezionato inizialmente quando viene chiamata la finestra di dialogo. Impossibile utilizzare con IOF_SELECTCREATENEW.

• IOF_CHECKLINK Specifica che la casella di controllo Collegamento verrà selezionata inizialmente quando viene chiamata la finestra di dialogo.

• IOF_DISABLELINK Specifica che la casella di controllo Collegamento verrà disabilitata quando viene chiamata la finestra di dialogo.

• IOF_CHECKDISPLAYASICON Specifica che la casella di controllo Visualizza come icona verrà selezionata inizialmente, verrà visualizzata l'icona corrente e il pulsante Cambia icona verrà abilitato quando viene chiamata la finestra di dialogo.

• IOF_VERIFYSERVERSEXIST Specifica che la finestra di dialogo deve convalidare le classi aggiunte alla casella di riepilogo verificando che i server specificati nel database di registrazione esistano prima della visualizzazione della finestra di dialogo. L'impostazione di questo flag può compromettere significativamente le prestazioni.

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

Osservazioni:

Per visualizzare la finestra di dialogo, chiamare la funzione DoModal .

COleInsertDialog::CreateItem

Chiamare questa funzione per creare un oggetto di tipo COleClientItem solo se DoModal restituisce IDOK.

BOOL CreateItem(COleClientItem* pItem);

Parametri

pItem
Punta all'elemento da creare.

Valore restituito

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

Osservazioni:

È necessario allocare l'oggetto COleClientItem prima di poter chiamare questa funzione.

COleInsertDialog::D oModal

Chiamare questa funzione per visualizzare la finestra di dialogo Ole Insert Object .Call this function to display the OLE Insert Object dialog box.

virtual INT_PTR
    DoModal();

INT_PTR
    DoModal(DWORD  dwFlags);

Parametri

dwFlags
Uno dei valori seguenti:

COleInsertDialog::DocObjectsOnly inserisce solo DocObjects.

COleInsertDialog::ControlsOnly inserisce solo controlli ActiveX.

Zero inserisce né un oggetto DocObject né un controllo ActiveX. Questo valore comporta la stessa implementazione del primo prototipo elencato in precedenza.

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 funzione membro COleDialog::GetLastError per ottenere altre informazioni sul tipo di errore che si è verificato. Per un elenco dei possibili errori, vedere la funzione OleUIInsertObject in Windows SDK.

Osservazioni:

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

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

COleInsertDialog::GetClassID

Chiamare questa funzione per ottenere il CLSID associato all'elemento selezionato solo se DoModal restituisce IDOK e il tipo di selezione è COleInsertDialog::createNewItem.

REFCLSID GetClassID() const;

Valore restituito

Restituisce il CLSID associato all'elemento selezionato.

Osservazioni:

Per altre informazioni, vedere Chiave CLSID in Windows SDK.

COleInsertDialog::GetDrawAspect

Chiamare questa funzione per determinare 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 è selezionata.

• DVASPECT_ICON Restituito se è stata selezionata la casella di controllo Visualizza come icona.

Osservazioni:

Chiamare questa funzione solo se DoModal restituisce IDOK.

Per altre informazioni sull'aspetto del disegno, vedere Struttura dei dati FORMATETC in Windows SDK.

COleInsertDialog::GetIconicMetafile

Chiamare questa funzione per ottenere un handle al metafile che contiene l'aspetto iconico dell'elemento selezionato.

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.

COleInsertDialog::GetPathName

Chiamare questa funzione per ottenere il percorso completo del file selezionato solo se DoModal restituisce IDOK e il tipo di selezione non COleInsertDialog::createNewItemè .

CString GetPathName() const;

Valore restituito

Percorso completo del file selezionato nella finestra di dialogo. Se il tipo di selezione è createNewItem, questa funzione restituisce un valore senza significato CString in modalità di rilascio o provoca un'asserzione in modalità di debug.

COleInsertDialog::GetSelectionType

Chiamare questa funzione per ottenere il tipo di selezione scelto quando la finestra di dialogo Inserisci oggetto è stata chiusa scegliendo OK.

UINT GetSelectionType() const;

Valore restituito

Tipo di selezione effettuata.

Osservazioni:

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

enum Selection {
    createNewItem,
    insertFromFile,
    linkToFile
    };

Di seguito sono riportate brevi descrizioni di questi valori:

• COleInsertDialog::createNewItem È stato selezionato il pulsante di opzione Crea nuovo.

• COleInsertDialog::insertFromFile È stato selezionato il pulsante di opzione Crea da file e la casella di controllo Collegamento non è selezionata.

• COleInsertDialog::linkToFile Il pulsante di opzione Crea da file è stato selezionato e la casella di controllo Collegamento è stata selezionata.

COleInsertDialog::m_io

Struttura di tipo OLEUIINSERTOBJECT utilizzata per controllare il comportamento della finestra di dialogo Inserisci oggetto .

OLEUIINSERTOBJECT m_io;

Osservazioni:

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

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

Vedi anche

OCLIENT di esempio MFC
Classe COleDialog
Grafico della gerarchia
Classe COleDialog