OLEUIINSERTOBJECTW-Struktur (oledlg.h)

Enthält Informationen, die die OLE-Benutzeroberflächenbibliothek verwendet, um das Dialogfeld Objekt einfügen zu initialisieren, und Platz für die Bibliothek, um Informationen zurückzugeben, wenn das Dialogfeld geschlossen wird.

Syntax

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;

Member

cbStruct

Die Größe der Struktur in Bytes. Dieses Feld muss bei der Eingabe ausgefüllt werden.

dwFlags

Gibt bei der Eingabe die Initialisierungs- und Erstellungsflags an. Gibt beim Beenden die Optionen des Benutzers an. Dies kann eine Kombination der folgenden Flags sein.

hWndOwner

Das Fenster, das das Dialogfeld besitzt. Dieser Member sollte nicht NULL sein.

lpszCaption

Zeiger auf eine Zeichenfolge, die als Titel des Dialogfelds verwendet werden soll. Wenn NULL, verwendet die Bibliothek Objekt einfügen.

lpfnHook

Zeiger auf eine Hookfunktion, die nachrichten verarbeitet, die für das Dialogfeld vorgesehen sind. Die Hookfunktion muss null zurückgeben, um eine Nachricht, die sie nicht verarbeitet hat, an die Dialogfeldprozedur in der Bibliothek zurückzugeben. Die Hookfunktion muss einen Wert ohne Zero zurückgeben, um zu verhindern, dass die Dialogfeldprozedur der Bibliothek eine bereits verarbeitete Nachricht verarbeitet.

lCustData

Anwendungsdefinierte Daten, die die Bibliothek an die Hookfunktion übergibt, auf die das lpfnHook-Element verweist. Die Bibliothek übergibt einen Zeiger auf die OLEUIINSERTOBJECT-Struktur im lParam-Parameter der WM_INITDIALOG Nachricht. Dieser Zeiger kann verwendet werden, um das lCustData-Element abzurufen.

hInstance

Instanz, die eine Dialogfeldvorlage enthält, die vom lpTemplateName-Element angegeben wird.

lpszTemplate

Zeiger auf eine NULL-Zeichenfolge, die den Namen der Ressourcendatei für die Dialogfeldvorlage angibt, die durch die Dialogfeldvorlage "Objekt einfügen" der Bibliothek ersetzt werden soll.

hResource

Angepasstes Vorlagenhandle.

clsid

CLSID für die Klasse des einzufügenden Objekts. Bei Ausgabe ausgefüllt.

lpszFile

Zeiger auf den Namen der Datei, die verknüpft oder eingebettet werden soll. Bei Ausgabe ausgefüllt.

cchFile

Größe des lpszFile-Puffers ; wird MAX_PATH nicht überschritten.

cClsidExclude

Anzahl der CLSIDs, die in der lpClsidExclude-Liste enthalten sind. Bei Eingabe ausgefüllt.

lpClsidExclude

Zeiger auf eine Liste von CLSIDs, die von der Auflistung ausgeschlossen werden sollen.

iid

Bezeichner der angeforderten Schnittstelle. Wenn OleUIInsertObject das -Objekt erstellt, wird ein Zeiger auf diese Schnittstelle zurückgegeben. Dieser Parameter wird ignoriert, wenn OleUIInsertObject das Objekt nicht erstellt.

oleRender

Renderingoption. Wenn OleUIInsertObject das Objekt erstellt, wählt es die Renderingoption aus, wenn das Objekt erstellt wird. Dieser Parameter wird ignoriert, wenn OleUIInsertObject das Objekt nicht erstellt.

lpFormatEtc

Gewünschtes Format. Wenn OleUIInsertObject das Objekt erstellt, wählt es das Format aus, wenn das Objekt erstellt wird. Dieser Parameter wird ignoriert, wenn OleUIInsertObject das Objekt nicht erstellt.

lpIOleClientSite

Zeiger auf den Clientstandort, der für das Objekt verwendet werden soll. Dieser Parameter wird ignoriert, wenn OleUIInsertObject das Objekt nicht erstellt.

lpIStorage

Zeiger auf den Speicher, der für das Objekt verwendet werden soll. Dieser Parameter wird ignoriert, wenn OleUIInsertObject das Objekt nicht erstellt.

ppvObj

Adresse der Ausgabezeigervariable, die den Schnittstellenzeiger für das eingefügte Objekt enthält. Dieser Parameter wird ignoriert, wenn OleUIInsertObject das Objekt nicht erstellt.

sc

Ergebnis von Erstellungsaufrufen. Dieser Parameter wird ignoriert, wenn OleUIInsertObject das Objekt nicht erstellt.

hMetaPict

MetafilePict-Struktur, die den ikonischen Aspekt enthält, wenn sie nicht im Cache des Objekts platziert wurde.

Hinweise

Anforderungen

Weitere Informationen

OleUIInsertObject