Condividi tramite

Struttura OLEUICONVERTW (oledlg.h)

  • Articolo

Contiene informazioni usate dalla libreria dell'interfaccia utente OLE per inizializzare la finestra di dialogo Converti e spazio per la libreria per restituire informazioni quando la finestra di dialogo viene ignorata.

Sintassi

typedef struct tagOLEUICONVERTW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  CLSID         clsid;
  CLSID         clsidConvertDefault;
  CLSID         clsidActivateDefault;
  CLSID         clsidNew;
  DWORD         dvAspect;
  WORD          wFormat;
  BOOL          fIsLinkedObject;
  HGLOBAL       hMetaPict;
  LPWSTR        lpszUserType;
  BOOL          fObjectsIconChanged;
  LPWSTR        lpszDefLabel;
  UINT          cClsidExclude;
  LPCLSID       lpClsidExclude;
} OLEUICONVERTW, *POLEUICONVERTW, *LPOLEUICONVERTW;

Members

cbStruct

Dimensioni della struttura, in byte. Questo membro deve essere compilato in input.

dwFlags

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

Valore Significato
CF_SHOWHELPBUTTON
 Nella finestra di dialogo verrà visualizzato un pulsante Della Guida . Questo flag viene impostato sull'input.
CF_SETCONVERTDEFAULT
 La classe CLSID specificata da clsidConvertDefault verrà usata come selezione predefinita. Questa selezione viene visualizzata nella casella di riepilogo della classe quando viene selezionato il pulsante di opzione Converti in . Questo flag viene impostato sull'input.
CF_SETACTIVATEDEFAULT
 La classe CLSID specificata da clsidActivateDefault verrà usata 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
 In input, questo flag specifica che Convert To verrà inizialmente selezionato (comportamento predefinito). Questo flag viene impostato sull'output se Convert To è stato selezionato quando l'utente ha ignorato la finestra di dialogo.
CF_SELECTACTIVATEAS
 In input, questo flag specifica che Attiva come verrà selezionato inizialmente. 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 per l'inizializzazione.
CF_DISABLEACTIVATEAS
 Il pulsante di opzione Attiva come verrà disabilitato per l'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 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 nella procedura 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 risorsa per il modello di finestra di dialogo che deve essere sostituito per il modello di finestra di dialogo Converti della libreria.

hResource

Handle di risorse 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 usare come classe predefinita quando si seleziona Convert To . 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 as . 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 in input, viene selezionata la casella Visualizza come icona e viene visualizzata l'icona dell'oggetto. Questo membro è 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 è 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 recupera il nome del tipo 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 del tipo utente breve. 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.

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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