OLEUIINSERTOBJECTA-Struktur (oledlg.h)

Enthält Informationen, die die OLE-Benutzeroberflächenbibliothek verwendet, um das Dialogfeld Objekt einfügen zu initialisieren, und Leerzeichen 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;

Angehörige

cbStruct

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

dwFlags

Gibt bei eingaben die Initialisierungs- und Erstellungskennzeichnungen an. Gibt beim Beenden die Auswahlmöglichkeiten des Benutzers an. Dies kann eine Kombination aus den folgenden Flags sein.

Wert	Bedeutung
IOF_SHOWHELP	Im Dialogfeld wird eine Schaltfläche Hilfe angezeigt.
IOF_SELECTCREATENEW	Das Optionsfeld "Neue 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 Verknüpfung 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 aktiviert.
IOF_CREATENEWOBJECT	Ein neues Objekt sollte erstellt werden, wenn der Benutzer OK auswählt, um das Dialogfeld zu schließen, und das Optionsfeld "Neue 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 Optionsfeld 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 hat das Kontrollkästchen Link aktiviert.
IOF_DISABLELINK	Das Kontrollkästchen Verknüpfung 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 erheblicher 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. Dieses Element sollte nicht NULL-sein.

lpszCaption

Zeigen Sie auf eine Zeichenfolge, die als Titel des Dialogfelds verwendet werden soll. Wenn NULL-, verwendet die Bibliothek Insert Object.

lpfnHook

Zeiger auf eine Hook-Funktion, die Nachrichten verarbeitet, die für das Dialogfeld vorgesehen sind. Die Hook-Funktion muss null zurückgeben, um eine Meldung zu übergeben, dass sie nicht wieder an die Dialogfeldprozedur in der Bibliothek verarbeitet wurde. Die Hook-Funktion muss einen Wert ungleich Null zurückgeben, um zu verhindern, dass die Dialogfeldprozedur der Bibliothek eine bereits verarbeitete Nachricht verarbeitet.

lCustData

Anwendungsdefinierte Daten, auf die die Bibliothek an die Hook-Funktion übergibt, auf die vom lpfnHook Member verwiesen wird. Die Bibliothek übergibt einen Zeiger an 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 Member angegeben wird.

lpszTemplate

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen der Ressourcendatei für die Dialogfeldvorlage angibt, die durch die Dialogfeldvorlage "Objekt einfügen" der Bibliothek ersetzt werden soll.

hResource

Angepasster Vorlagenhandle.

clsid

CLSID für die Klasse des einzufügenden Objekts. Auf Ausgabe gefüllt.

lpszFile

Zeigen Sie auf den Namen der Datei, die verknüpft oder eingebettet werden soll. Auf Ausgabe gefüllt.

cchFile

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

cClsidExclude

Die Anzahl der CLSIDs, die in der liste lpClsidExcl ude enthalten sind. Ausgefüllt auf Eingabe.

lpClsidExclude

Zeigen Sie auf eine Liste der 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 beim Erstellen des Objekts die Renderingoption ausgewählt. Dieser Parameter wird ignoriert, wenn OleUIInsertObject- das Objekt nicht erstellt.

lpFormatEtc

Gewünschtes Format. Wenn OleUIInsertObject das Objekt erstellt, wird das Format beim Erstellen des Objekts markiert. Dieser Parameter wird ignoriert, wenn OleUIInsertObject- das Objekt nicht erstellt.

lpIOleClientSite

Zeiger auf die Clientwebsite, die 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 der Erstellung von Aufrufen. Dieser Parameter wird ignoriert, wenn OleUIInsertObject- das Objekt nicht erstellt.

hMetaPict

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

Bemerkungen

Anmerkung

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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	oledlg.h

Siehe auch

OleUIInsertObject-