OLEUIINSERTOBJECTW-Struktur (oledlg.h)

Artikel
08/25/2023

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.

Wert	Bedeutung
IOF_SHOWHELP	Im Dialogfeld wird eine Hilfeschaltfläche angezeigt.
IOF_SELECTCREATENEW	Das Optionsfeld Neu erstellen wird zunächst aktiviert. Dies kann nicht mit IOF_SELECTCREATEFROMFILE verwendet werden.
IOF_SELECTCREATEFROMFILE	Das Optionsfeld Aus Datei erstellen wird zunächst aktiviert. Dies kann nicht mit IOF_SELECTCREATENEW verwendet werden.
IOF_CHECKLINK	Das Kontrollkästchen Link wird zunächst aktiviert.
IOF_CHECKDISPLAYASICON	Das Kontrollkästchen Als Symbol anzeigen wird zunächst aktiviert, das aktuelle Symbol wird angezeigt, und die Schaltfläche Symbol ändern wird aktiviert.
IOF_CREATENEWOBJECT	Ein neues Objekt sollte erstellt werden, wenn der Benutzer OK auswählt, um das Dialogfeld zu schließen und das Optionsfeld Neu erstellen ausgewählt wurde.
IOF_CREATEFILEOBJECT	Ein neues Objekt sollte aus der angegebenen Datei erstellt werden, wenn der Benutzer OK auswählt, um das Dialogfeld zu schließen und das Optionsfeld Aus Datei erstellen ausgewählt wurde.
IOF_CREATELINKOBJECT	Ein neues verknüpftes Objekt sollte erstellt werden, wenn der Benutzer OK auswählt, um das Dialogfeld zu schließen, und der Benutzer das Kontrollkästchen Verknüpfen aktiviert hat.
IOF_DISABLELINK	Das Kontrollkästchen Link wird bei der Initialisierung deaktiviert.
IOF_VERIFYSERVERSEXIST	Das Dialogfeld sollte die Klassen überprüfen, die es dem Listenfeld hinzufügt, indem sichergestellt wird, dass der in der Registrierungsdatenbank angegebene Server vorhanden ist. Dies ist ein wichtiger Leistungsfaktor.
IOF_DISABLEDISPLAYASICON	Das Kontrollkästchen Als Symbol anzeigen wird bei der Initialisierung deaktiviert.
IOF_HIDECHANGEICON	Die Schaltfläche Symbol ändern wird im Dialogfeld Objekt einfügen ausgeblendet.
IOF_SHOWINSERTCONTROL	Zeigt das Optionsfeld Steuerelement einfügen an.
IOF_SELECTCREATECONTROL	Zeigt das Optionsfeld Steuerelement erstellen an.

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

Hinweis

Der oledlg.h-Header definiert OLEUIINSERTOBJECT als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	oledlg.h

Weitere Informationen

OleUIInsertObject