Classe COleConvertDialog

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

Sintassi

class COleConvertDialog : public COleDialog

Membri

Costruttori pubblici

Metodi pubblici

Membri dati pubblici

Osservazioni:

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

COleConvertDialog

Requisiti

Intestazione: afxodlgs.h

COleConvertDialog::COleConvertDialog

Costruisce solo un COleConvertDialog oggetto .

explicit COleConvertDialog (
    COleClientItem* pItem,
    DWORD dwFlags = CF_SELECTCONVERTTO,
    CLSID* pClassID = NULL,
    CWnd* pParentWnd = NULL);

Parametri

pItem
Punta all'elemento da convertire o attivare.

dwFlags
Flag di creazione, che contiene un numero qualsiasi dei valori seguenti combinati usando l'operatore bit per bit o :

• CF_SELECTCONVERTTO Specifica che il pulsante di opzione Converti in verrà selezionato inizialmente quando viene chiamata la finestra di dialogo. Si tratta dell'impostazione predefinita.

• CF_SELECTACTIVATEAS Specifica che il pulsante di opzione Attiva come verrà selezionato inizialmente quando viene chiamata la finestra di dialogo.

• CF_SETCONVERTDEFAULT Specifica che la classe il cui CLSID è specificato dal clsidConvertDefault membro della m_cv struttura verrà utilizzata come selezione predefinita nella casella di riepilogo della classe quando è selezionato il pulsante di opzione Converti in .

• CF_SETACTIVATEDEFAULT Specifica che la classe il cui CLSID viene specificato dal clsidActivateDefault membro della struttura verrà utilizzata come selezione predefinita nella casella di m_cv riepilogo della classe quando è selezionato il pulsante di opzione Attiva come.

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

pClassID
Punta al CLSID dell'elemento da convertire o attivare. Se NULL, verrà usato il CLSID associato a pItem .

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:

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

Per altre informazioni, vedere Chiave CLSID e struttura OLEUICONVERT .

COleConvertDialog::D oConvert

Chiamare questa funzione, dopo aver restituito correttamente da DoModal, per convertire o attivare un oggetto di tipo COleClientItem.

BOOL DoConvert(COleClientItem* pItem);

Parametri

pItem
Punta all'elemento da convertire o attivare. Non può essere NULL.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

L'elemento viene convertito o attivato in base alle informazioni selezionate dall'utente nella finestra di dialogo Converti.

COleConvertDialog::D oModal

Chiamare questa funzione per visualizzare la finestra di dialogo Conversione OLE.

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

Osservazioni:

Se si desidera inizializzare i vari controlli della finestra di dialogo impostando i membri della struttura m_cv , è 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 le informazioni immesse dall'utente nella finestra di dialogo.

COleConvertDialog::GetClassID

Chiamare questa funzione per ottenere il CLSID associato all'elemento selezionato dall'utente nella finestra di dialogo Converti.

REFCLSID GetClassID() const;

Valore restituito

CLSID associato all'elemento selezionato nella finestra di dialogo Converti.

Osservazioni:

Chiamare questa funzione solo dopo che DoModal restituisce IDOK.

Per altre informazioni, vedere Chiave CLSID in Windows SDK.

COleConvertDialog::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 dopo che DoModal restituisce IDOK.

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

COleConvertDialog::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.

COleConvertDialog::GetSelectionType

Chiamare questa funzione per determinare il tipo di conversione selezionato nella finestra di dialogo Converti.

UINT GetSelectionType() const;

Valore restituito

Tipo di selezione effettuata.

Osservazioni:

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

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

Di seguito sono riportate brevi descrizioni di questi valori:

• COleConvertDialog::noConversion Restituito se la finestra di dialogo è stata annullata o l'utente non ha selezionato alcuna conversione. Se COleConvertDialog::DoModal restituito IDOK, è possibile che l'utente ha selezionato un'icona diversa da quella selezionata in precedenza.

• COleConvertDialog::convertItem Restituito se il pulsante di opzione Converti in è stato selezionato, l'utente ha selezionato un elemento diverso in cui eseguire la conversione e DoModal ha restituito IDOK.

• COleConvertDialog::activateAs Restituito se il pulsante di opzione Attiva come è stato selezionato, l'utente ha selezionato un elemento diverso da attivare e DoModal ha restituito IDOK.

COleConvertDialog::m_cv

Struttura di tipo OLEUICONVERT utilizzata per controllare il comportamento della finestra di dialogo Converti.

OLEUICONVERT m_cv;

Osservazioni:

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

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

Vedi anche

Classe COleDialog
Grafico della gerarchia
Classe COleDialog