Struttura OLEUICHANGEICONA (oledlg.h)

Contiene informazioni utilizzate dalla libreria dell'interfaccia utente OLE per inizializzare la finestra di dialogo modifica icona e contiene spazio per la raccolta per restituire informazioni quando la finestra di dialogo viene chiusa.

Sintassi

typedef struct tagOLEUICHANGEICONA {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCSTR        lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCSTR        lpszTemplate;
  HRSRC         hResource;
  HGLOBAL       hMetaPict;
  CLSID         clsid;
  CHAR          szIconExe[MAX_PATH];
  int           cchIconExe;
} OLEUICHANGEICONA, *POLEUICHANGEICONA, *LPOLEUICHANGEICONA;

Membri

cbStruct

Dimensione della struttura, in byte. Questo campo deve essere compilato in base all'input.

dwFlags

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

Valore	Significato
CIF_SHOWHELP	Nella finestra di dialogo verrà visualizzato un pulsante guida .
CIF_SELECTCURRENT	In input selezionare il pulsante di opzione Corrente all'inizializzazione. All'uscita specifica che l'utente ha selezionato corrente.
CIF_SELECTDEFAULT	In input selezionare il pulsante di opzione predefinito all'inizializzazione. All'uscita, specifica che l'utente ha selezionato Default.
CIF_SELECTFROMFILE	In input selezionare il pulsante di opzione Da file all'inizializzazione. All'uscita, specifica che l'utente ha selezionato Da file.
CIF_USEICONEXE	Solo input. Estrae l'icona dal file eseguibile specificato nella membro szIconExe anziché recuperarla dalla classe . Ciò è utile per l'incorporamento OLE o il collegamento a file non OLE.

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 Modifica icona.

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 OLEUICHANGEICON 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 lpTemplateName.

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 modifica icona della libreria modello di finestra di dialogo.

hResource

Handle di modello personalizzato.

hMetaPict

Immagine corrente e finale. L'origine dell'icona è incorporata nel metafile stesso.

clsid

Solo input. Classe da usare per ottenere l'icona predefinita .

szIconExe[MAX_PATH]

Solo input. Puntatore al file eseguibile da cui estrarre l'icona predefinita. Questo membro viene ignorato a meno che CIF_USEICONEXE non sia incluso nel membro dwFlags e un tentativo di recuperare l'icona della classe dal CLSID specificato non riesce.

cchIconExe

Solo input. Numero di caratteri in szIconExe. Questo membro viene ignorato a meno che CIF_USEICONEXE non sia incluso nel membro dwFlags.

Osservazioni

Nota

L'intestazione oledlg.h definisce OLEUICHANGEICON 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 10 Build 20348
server minimo supportato	Windows 10 Build 20348
intestazione	oledlg.h