Struttura OLEUIINSERTOBJECTA (oledlg.h)

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

Sintassi

typedef struct tagOLEUIINSERTOBJECTA {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCSTR          lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCSTR          lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPSTR           lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTA, *POLEUIINSERTOBJECTA, *LPOLEUIINSERTOBJECTA;

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.

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 Insert Object.

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 OLEUIINSERTOBJECT 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 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 finestra di dialogo Inserisci oggetto della libreria.

hResource

Handle di modello personalizzato.

clsid

CLSID per la classe dell'oggetto da inserire. Riempito in base all'output.

lpszFile

Puntatore al nome del file da collegare o incorporare. Riempito in base all'output.

cchFile

Dimensioni del buffer lpszFile; non supererà MAX_PATH.

cClsidExclude

Numero di CLSID inclusi nell'elenco lpClsidExclude. Riempito in base all'input.

lpClsidExclude

Puntatore a un elenco di CLSID da escludere dall'elenco.

iid

Identificatore dell'interfaccia richiesta. Se OleUIInsertObject crea l'oggetto , restituirà un puntatore a questa interfaccia. Questo parametro viene ignorato se oleUIInsertObject non crea l'oggetto.

oleRender

Opzione di rendering. Se OleUIInsertObject crea l'oggetto, seleziona l'opzione di rendering quando crea l'oggetto. Questo parametro viene ignorato se oleUIInsertObject non crea l'oggetto.

lpFormatEtc

Formato desiderato. Se OleUIInsertObject crea l'oggetto, seleziona il formato quando crea l'oggetto. Questo parametro viene ignorato se oleUIInsertObject non crea l'oggetto.

lpIOleClientSite

Puntatore al sito client da utilizzare per l'oggetto . Questo parametro viene ignorato se oleUIInsertObject non crea l'oggetto.

lpIStorage

Puntatore alla risorsa di archiviazione da usare per l'oggetto . Questo parametro viene ignorato se oleUIInsertObject non crea l'oggetto.

ppvObj

Indirizzo della variabile del puntatore di output contenente il puntatore dell'interfaccia per l'oggetto inserito. Questo parametro viene ignorato se oleUIInsertObject non crea l'oggetto.

sc

Risultato delle chiamate di creazione. Questo parametro viene ignorato se oleUIInsertObject non crea l'oggetto.

hMetaPict

Struttura MetafilePict contenente l'aspetto iconico, se non è stata inserita nella cache dell'oggetto.

Osservazioni

Fabbisogno

Vedere anche

OleUIInsertObject