Condividi tramite


Struttura OLEUICONVERTA (oledlg.h)

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;

Members

cbStruct

Dimensioni della struttura, in byte. Questo membro deve essere compilato all'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 ? Questo flag viene impostato sull'input.
CF_SETCONVERTDEFAULT
La classe il cui CLSID è specificato da clsidConvertDefault verrà usata 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
La classe il cui CLSID è specificato da clsidActivateDefault verrà usato come selezione predefinita. Questa selezione viene visualizzata nella casella di riepilogo della classe quando è selezionato il pulsante di opzione Attiva come . Questo flag viene impostato sull'input.
CF_SELECTCONVERTTO
In 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
In input, questo flag specifica che ActivateAs verrà inizialmente selezionato. Questo flag viene impostato sull'output se l'opzione Attiva come è stata selezionata 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 Cambia 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 utilizzare come titolo della finestra di dialogo. Se NULL, la libreria usa Convert.

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 nuovamente 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 OLEUICONVERT nel parametro lParam del messaggio 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 di finestra di dialogo Converti standard o, 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 si seleziona Converti in . Questo membro viene ignorato se il membro dwFlags non include CF_SETCONVERTDEFAULT. Questo membro viene impostato sull'input.

clsidActivateDefault

CLSID da utilizzare come classe predefinita quando si seleziona ActivateAs . 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 è DVASPECT_ICON all'input, viene selezionata la casella Visualizza come icona e viene visualizzata l'icona dell'oggetto. Questo membro viene impostato sull'input e sull'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

METAFILEPICT contenente l'aspetto iconico. Questo membro viene impostato sull'input e sull'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 utente dal Registro di sistema. Questa stringa viene liberata all'uscita.

fObjectsIconChanged

TRUE se l'icona dell'oggetto è stata modificata. 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. Questo viene liberato all'uscita.

cClsidExclude

Numero di CLSID in lpClsidExclude.

lpClsidExclude

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

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione oledlg.h

Vedi anche

OleUIChangeIcon

OleUIConvert