OLEUICONVERTA-Struktur (oledlg.h)

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

Syntax

typedef struct tagOLEUICONVERTA {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCSTR        lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCSTR        lpszTemplate;
  HRSRC         hResource;
  CLSID         clsid;
  CLSID         clsidConvertDefault;
  CLSID         clsidActivateDefault;
  CLSID         clsidNew;
  DWORD         dvAspect;
  WORD          wFormat;
  BOOL          fIsLinkedObject;
  HGLOBAL       hMetaPict;
  LPSTR         lpszUserType;
  BOOL          fObjectsIconChanged;
  LPSTR         lpszDefLabel;
  UINT          cClsidExclude;
  LPCLSID       lpClsidExclude;
} OLEUICONVERTA, *POLEUICONVERTA, *LPOLEUICONVERTA;

Member

cbStruct

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

dwFlags

Bei der Eingabe gibt dieses Feld die Initialisierungs- und Erstellungsflags an. Beim Beenden wird die Auswahl des Benutzers angegeben. 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 Convert.

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 OLEUICONVERT-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 lpszTemplate-Element angegeben wird. Dieser Member wird ignoriert, wenn das lpszTemplate-ElementNULL oder ungültig ist.

lpszTemplate

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen der Ressourcendatei für die Dialogfeldvorlage angibt, die durch die Dialogfeldvorlage Konvertieren der Bibliothek ersetzt werden soll.

hResource

Ressourcenhandle für ein benutzerdefiniertes Dialogfeld. Wenn dieser Member NULL ist, verwendet die Bibliothek die Standardmäßige Dialogfeldvorlage Konvertieren oder, wenn sie gültig ist, die Vorlage, die vom lpszTemplate-Element benannt ist.

clsid

Die CLSID des zu konvertierenden oder zu aktivierenden Objekts. Dieser Member wird bei der Eingabe festgelegt.

clsidConvertDefault

Die CLSID, die als Standardklasse verwendet werden soll, wenn Konvertieren in ausgewählt ist. Dieser Member wird ignoriert, wenn der dwFlags-Member keine CF_SETCONVERTDEFAULT enthält. Dieser Member wird bei der Eingabe festgelegt.

clsidActivateDefault

Die CLSID, die als Standardklasse verwendet werden soll, wenn Aktivieren als ausgewählt ist. Dieser Member wird ignoriert, wenn der dwFlags-Member keine CF_SETACTIVATEDEFAULT enthält. Dieser Member wird bei der Eingabe festgelegt.

clsidNew

Die CLSID der ausgewählten Klasse. Dieser Member wird für die Ausgabe festgelegt.

dvAspect

Aspekt des -Objekts. Dies muss entweder DVASPECT_CONTENT oder DVASPECT_ICON sein. Wenn dvAspect bei der Eingabe DVASPECT_ICON ist, wird das Feld Als Symbol anzeigen aktiviert, und das Symbol des Objekts wird angezeigt. Dieser Member wird für Eingabe und Ausgabe festgelegt. Weitere Informationen finden Sie unter DVASPECT.

wFormat

Datenformat des zu konvertierenden oder zu aktivierenden Objekts.

fIsLinkedObject

TRUE , wenn das Objekt verknüpft ist. Dieser Member wird bei der Eingabe festgelegt.

hMetaPict

Die METAFILEPICT mit dem ikonischen Aspekt. Dieser Member wird für Eingabe und Ausgabe festgelegt.

lpszUserType

Zeiger auf den Benutzertypnamen des zu konvertierenden oder zu aktivierenden Objekts. Wenn dieser Wert NULL ist, ruft das Dialogfeld den Benutzernamennamen aus der Registrierung ab. Diese Zeichenfolge wird beim Beenden freigegeben.

fObjectsIconChanged

TRUE , wenn sich das Symbol des Objekts geändert hat. (d. h., wenn OleUIChangeIcon aufgerufen und nicht abgebrochen wurde.) Dieser Member wird für die Ausgabe festgelegt.

lpszDefLabel

Zeiger auf die Standardbezeichnung, die für das Symbol verwendet werden soll. Wenn NULL, wird der kurze Benutzertypname verwendet. Wenn das Objekt ein Link ist, sollte der Aufrufer den Anzeigenamen der Linkquelle übergeben. Dies wird beim Beenden freigegeben.

cClsidExclude

Anzahl der CLSIDs in lpClsidExclude.

lpClsidExclude

Zeiger auf die Liste der CLSIDs, die aus der Liste ausgeschlossen werden sollen.

Hinweise

Anforderungen

Weitere Informationen

OleUIChangeIcon

OleUIConvert