OLEUIINSERTOBJECTA-Struktur (oledlg.h)

Enthält Informationen, die von der OLE-Benutzeroberflächenbibliothek zum Initialisieren des Dialogfelds Objekt einfügen verwendet werden, sowie Platz für die Bibliothek, um Informationen zurückzugeben, wenn das Dialogfeld geschlossen wird.

Syntax

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;

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 Auswahl 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 ist.
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 Link aktiviert hat.
IOF_DISABLELINK	Das Kontrollkästchen Link wird bei der Initialisierung deaktiviert.
IOF_VERIFYSERVERSEXIST	Das Dialogfeld sollte die Klassen überprüfen, die dem Listenfeld hinzugefügt werden, 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 Insert Object.

lpfnHook

Zeiger auf eine Hookfunktion, die nachrichten verarbeitet, die für das Dialogfeld vorgesehen sind. Die Hookfunktion muss null zurückgeben, um eine Meldung, die sie nicht verarbeitet hat, an die Dialogfeldprozedur in der Bibliothek zurückzugeben. Die Hookfunktion muss einen Wert ungleich null 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 der lpfnHook-Member verweist. Die Bibliothek übergibt einen Zeiger auf die OLEUIINSERTOBJECT-Struktur im lParam-Parameter der WM_INITDIALOG Meldung. 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-endende 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. Wird bei der Ausgabe ausgefüllt.

lpszFile

Zeiger auf den Namen der Datei, die verknüpft oder eingebettet werden soll. Wird bei der 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, wird die Renderingoption ausgewählt, 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 die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, 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