Struttura OLEUIINSERTOBJECTW (oledlg.h)

Articolo
08/25/2023

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

Sintassi

typedef struct tagOLEUIINSERTOBJECTW {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCWSTR         lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCWSTR         lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPWSTR          lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTW, *POLEUIINSERTOBJECTW, *LPOLEUIINSERTOBJECTW;

Members

cbStruct

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

dwFlags

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

Valore	Significato
IOF_SHOWHELP	La finestra di dialogo visualizzerà un pulsante Della Guida .
IOF_SELECTCREATENEW	Il pulsante di opzione Crea nuovo verrà inizialmente controllato. Impossibile usare questa operazione con IOF_SELECTCREATEFROMFILE.
IOF_SELECTCREATEFROMFILE	Il pulsante di opzione Crea da file verrà inizialmente selezionato. Impossibile usare questa opzione con IOF_SELECTCREATENEW.
IOF_CHECKLINK	La casella di controllo Collegamento verrà inizialmente selezionata.
IOF_CHECKDISPLAYASICON	La casella di controllo Visualizza come icona verrà inizialmente selezionata, l'icona corrente verrà visualizzata e verrà abilitato il pulsante Cambia icona .
IOF_CREATENEWOBJECT	Un nuovo oggetto deve essere creato quando l'utente seleziona OK per ignorare la finestra di dialogo e il pulsante di opzione Crea nuovo è stato selezionato.
IOF_CREATEFILEOBJECT	Un nuovo oggetto deve essere creato dal file specificato quando l'utente seleziona OK per ignorare la finestra di dialogo e il pulsante di opzione Crea da file è stato selezionato.
IOF_CREATELINKOBJECT	È necessario creare un nuovo oggetto collegato quando l'utente seleziona OK per ignorare la finestra di dialogo e l'utente ha selezionato la casella di controllo Collegamento .
IOF_DISABLELINK	La casella di controllo Collegamento verrà disabilitata per l'inizializzazione.
IOF_VERIFYSERVERSEXIST	La finestra di dialogo deve convalidare le classi aggiunte alla casella di riepilogo assicurando che il server specificato nel database di registrazione esista. Si tratta di un fattore di prestazioni significativo.
IOF_DISABLEDISPLAYASICON	Nella casella di controllo Visualizza icona verrà disabilitata l'inizializzazione.
IOF_HIDECHANGEICON	Il pulsante Modifica icona verrà nascosto nella finestra di dialogo Inserisci oggetto .
IOF_SHOWINSERTCONTROL	Visualizza il pulsante di opzione Inserisci controllo .
IOF_SELECTCREATECONTROL	Visualizza il pulsante di opzione Crea controllo .

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 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 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 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 risorsa per il modello di finestra di dialogo che deve essere sostituito per il modello di finestra di dialogo Inserisci oggetto della libreria.

hResource

Handle modello personalizzato.

clsid

CLSID per la classe dell'oggetto da inserire. Riempimento dell'output.

lpszFile

Puntatore al nome del file da collegare o incorporato. Riempimento dell'output.

cchFile

Dimensioni del buffer lpszFile ; non supererà MAX_PATH.

cClsidExclude

Numero di CLSID inclusi nell'elenco lpClsidExclude . Riempito in 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 usare per l'oggetto. Questo parametro viene ignorato se OleUIInsertObject non crea l'oggetto.

lpIStorage

Puntatore all'archiviazione da usare per l'oggetto. Questo parametro viene ignorato se OleUIInsertObject non crea l'oggetto.

ppvObj

Indirizzo della variabile 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.

Commenti

Nota

L'intestazione oledlg.h definisce OLEUIINSERTOBJECT 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

OleUIInsertObject

Condividi tramite