Condividi tramite

Struttura OLEUICONVERTA (oledlg.h)

  • Articolo

Contiene informazioni utilizzate dalla libreria dell'interfaccia utente OLE per inizializzare la finestra di dialogo converti e lo spazio per la libreria per restituire informazioni quando la finestra di dialogo viene chiusa.

Sintassi

typedef struct tagOLEUICONVERTA {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCSTR        lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCSTR        lpszTemplate;
  HRSRC         hResource;
  CLSID         clsid;
  CLSID         clsidConvertDefault;
  CLSID         clsidActivateDefault;
  CLSID         clsidNew;
  DWORD         dvAspect;
  WORD          wFormat;
  BOOL          fIsLinkedObject;
  HGLOBAL       hMetaPict;
  LPSTR         lpszUserType;
  BOOL          fObjectsIconChanged;
  LPSTR         lpszDefLabel;
  UINT          cClsidExclude;
  LPCLSID       lpClsidExclude;
} OLEUICONVERTA, *POLEUICONVERTA, *LPOLEUICONVERTA;

Membri

cbStruct

Dimensione della struttura, in byte. Questo membro deve essere compilato nell'input.

dwFlags

In input, questo campo specifica i flag di inizializzazione e creazione. All'uscita, specifica le scelte dell'utente. Può trattarsi di una combinazione dei flag seguenti.

Valore Significato
CF_SHOWHELPBUTTON
 Nella finestra di dialogo verrà visualizzato un pulsante guida . Questo flag viene impostato sull'input.
CF_SETCONVERTDEFAULT
 Classe il cui CLSID viene specificato da clsidConvertDefault verrà usato come selezione predefinita. Questa selezione viene visualizzata nella casella di riepilogo della classe quando è selezionato il pulsante di opzione Converti in . Questo flag viene impostato sull'input.
CF_SETACTIVATEDEFAULT
 Classe il cui CLSID è specificato da clsidActivateDefault verrà usato come selezione predefinita. Questa selezione viene visualizzata nella casella di riepilogo della classe quando viene selezionato il pulsante di opzione Attiva come . Questo flag viene impostato sull'input.
CF_SELECTCONVERTTO
 All'input, questo flag specifica che Converti in verrà inizialmente selezionato (comportamento predefinito). Questo flag viene impostato sull'output se è stata selezionata l'opzione Converti in quando l'utente ha ignorato la finestra di dialogo.
CF_SELECTACTIVATEAS
 All'input, questo flag specifica che Attiva come verrà inizialmente selezionato. Questo flag viene impostato sull'output se attiva come è stato selezionato quando l'utente ha ignorato la finestra di dialogo.
CF_DISABLEDISPLAYASICON
 Il pulsante visualizza come icona verrà disabilitato all'inizializzazione.
CF_DISABLEACTIVATEAS
 Il pulsante di opzione Attiva come verrà disabilitato all'inizializzazione.
CF_HIDECHANGEICON
 Il pulsante modifica icona verrà nascosto nella finestra di dialogo Converti .
CF_CONVERTONLY
 Il pulsante di opzione Attiva come verrà disabilitato nella finestra di dialogo Converti.

hWndOwner

Finestra proprietaria della finestra di dialogo. Questo membro non deve essere NULL.

lpszCaption

Puntatore a una stringa da usare come titolo della finestra di dialogo. Se null, la libreria usa Converti.

lpfnHook

Puntatore a una funzione hook che elabora i messaggi destinati alla finestra di dialogo. La funzione hook deve restituire zero per passare un messaggio che non è stato elaborato di nuovo alla routine della finestra di dialogo nella libreria. La funzione hook deve restituire un valore diverso da zero per impedire alla routine della finestra di dialogo della libreria di elaborare un messaggio già elaborato.

lCustData

Dati definiti dall'applicazione che la libreria passa alla funzione hook a cui punta il membro lpfnHook. La libreria passa un puntatore alla struttura di OLEUICONVERT nel parametro lParam del messaggio di WM_INITDIALOG; questo puntatore può essere usato per recuperare il membro lCustData.

hInstance

Istanza che contiene un modello di finestra di dialogo specificato dal membro lpszTemplate. Questo membro viene ignorato se il membro lpszTemplate è NULL o non valido.

lpszTemplate

Puntatore a una stringa con terminazione Null che specifica il nome del file di risorse per il modello di finestra di dialogo da sostituire con il modello di finestra di dialogo converti della libreria.

hResource

Handle di risorsa per una finestra di dialogo personalizzata. Se questo membro è null, la libreria usa il modello standard converti finestra di dialogo oppure, se è valido, il modello denominato dal membro lpszTemplate.

clsid

CLSID dell'oggetto da convertire o attivare. Questo membro viene impostato sull'input.

clsidConvertDefault

CLSID da utilizzare come classe predefinita quando viene selezionato Converti in. Questo membro viene ignorato se il membro dwFlags non include CF_SETCONVERTDEFAULT. Questo membro viene impostato sull'input.

clsidActivateDefault

CLSID da usare come classe predefinita quando si seleziona Attiva come. Questo membro viene ignorato se il membro dwFlags non include CF_SETACTIVATEDEFAULT. Questo membro viene impostato sull'input.

clsidNew

CLSID della classe selezionata. Questo membro viene impostato sull'output.

dvAspect

Aspetto dell'oggetto . Deve essere DVASPECT_CONTENT o DVASPECT_ICON. Se dvAspect viene DVASPECT_ICON all'input, viene selezionata la casella Visualizza come icona e viene visualizzata l'icona dell'oggetto. Questo membro viene impostato in base all'input e all'output. Per altre informazioni, vedere DVASPECT.

wFormat

Formato dati dell'oggetto da convertire o attivare.

fIsLinkedObject

true se l'oggetto è collegato. Questo membro viene impostato sull'input.

hMetaPict

Il METAFILEPICT contenente l'aspetto iconico. Questo membro viene impostato in base all'input e all'output.

lpszUserType

Puntatore al nome tipo utente dell'oggetto da convertire o attivare. Se questo valore è NULL, la finestra di dialogo recupererà il nome del tipo di utente dal Registro di sistema. Questa stringa viene liberata all'uscita.

fObjectsIconChanged

TRUE se l'icona dell'oggetto è cambiata. (ovvero, se OleUIChangeIcon è stato chiamato e non annullato. Questo membro viene impostato sull'output.

lpszDefLabel

Puntatore all'etichetta predefinita da usare per l'icona. Se NULL, verrà usato il nome breve del tipo di utente. Se l'oggetto è un collegamento, il chiamante deve passare il nome visualizzato dell'origine del collegamento. Questa operazione viene liberata all'uscita.

cClsidExclude

Numero di CLSID in lpClsidExclude.

lpClsidExclude

Puntatore all'elenco di CLSID da escludere dall'elenco.

Osservazioni

Nota

L'intestazione oledlg.h definisce OLEUICONVERT come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
intestazione oledlg.h

Vedere anche

OleUIChangeIcon

OleUIConvert