Classe COleChangeIconDialog

Utilizzato per la finestra di dialogo di modifica dell'icona OLE.

Sintassi

class COleChangeIconDialog : public COleDialog

Membri

Costruttori pubblici

Metodi pubblici

Membri dati pubblici

Osservazioni:

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

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

COleChangeIconDialog

Requisiti

Intestazione: afxodlgs.h

COleChangeIconDialog::COleChangeIconDialog

Questa funzione costruisce solo un COleChangeIconDialog oggetto .

explicit COleChangeIconDialog(
    COleClientItem* pItem,
    DWORD dwFlags = CIF_SELECTCURRENT,
    CWnd* pParentWnd = NULL);

Parametri

pItem
Punta all'elemento da convertire.

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

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

• CIF_SELECTDEFAULT Specifica che il pulsante di opzione Predefinito verrà selezionato inizialmente quando viene chiamata la finestra di dialogo.

• CIF_SELECTFROMFILE Specifica che il pulsante di opzione Da file verrà selezionato inizialmente quando viene chiamata la finestra di dialogo.

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

• CIF_USEICONEXE Specifica che l'icona deve essere estratta dal file eseguibile specificato nel szIconExe campo di m_ci anziché recuperata dal tipo. Ciò è utile per l'incorporamento o il collegamento a file non OLE.

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 verrà impostata sulla finestra principale dell'applicazione.

Osservazioni:

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

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

COleChangeIconDialog::D oChangeIcon

Chiamare questa funzione per modificare l'icona che rappresenta l'elemento a quello selezionato nella finestra di dialogo dopo che DoModal restituisce IDOK.

BOOL DoChangeIcon(COleClientItem* pItem);

Parametri

pItem
Punta all'elemento la cui icona viene modificata.

Valore restituito

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

COleChangeIconDialog::D oModal

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

Osservazioni:

Se si desidera inizializzare i vari controlli della finestra di dialogo impostando i membri della struttura m_ci , è 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.

COleChangeIconDialog::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 della nuova icona, se la finestra di dialogo è stata chiusa scegliendo OK. In caso contrario, l'icona così come era prima della visualizzazione della finestra di dialogo.

COleChangeIconDialog::m_ci

Struttura di tipo OLEUICHANGEICON utilizzata per controllare il comportamento della finestra di dialogo Cambia icona.

OLEUICHANGEICON m_ci;

Osservazioni:

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

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

Vedi anche

Classe COleDialog
Grafico della gerarchia
Classe COleDialog