Condividi tramite

Classe COleConvertDialog

  • Articolo

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

Sintassi

class COleConvertDialog : public COleDialog

Membri

Costruttori pubblici

Nome Descrizione
COleConvertDialog::COleConvertDialog Costruisce un oggetto COleConvertDialog.

Metodi pubblici

Nome Descrizione
COleConvertDialog::D oConvert Esegue la conversione specificata nella finestra di dialogo.
COleConvertDialog::D oModal Visualizza la finestra di dialogo Modifica elemento OLE.
COleConvertDialog::GetClassID Ottiene il CLSID associato all'elemento scelto.
COleConvertDialog::GetDrawAspect Specifica se disegnare un elemento come icona.
COleConvertDialog::GetIconicMetafile Ottiene un handle per il metafile associato alla forma iconica di questo elemento.
COleConvertDialog::GetSelectionType Ottiene il tipo di selezione scelto.

Membri dati pubblici

Nome Descrizione
COleConvertDialog::m_cv Struttura che controlla il comportamento della finestra di dialogo.

Osservazioni:

Nota

Il codice del contenitore generato dalla procedura guidata dell'applicazione usa questa classe.

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_edizione Standard LECTCONVERTTO Specifica che il pulsante di opzione Converti in verrà selezionato inizialmente quando viene chiamata la finestra di dialogo. Si tratta dell'impostazione predefinita.

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

  • CF_edizione Standard TCONVERTDEFAULT 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_edizione Standard TACTIVATEDEFAULT Specifica che la classe il cui CLSID è specificato dal clsidActivateDefault membro della m_cv struttura verrà utilizzata come selezione predefinita nella casella di 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