OLEUICONVERTA-Struktur (oledlg.h)

Enthält Informationen, die von der OLE-Benutzeroberflächenbibliothek zum Initialisieren des Dialogfelds Konvertieren verwendet werden, sowie 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;

Angehörige

cbStruct

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

dwFlags

Bei eingaben gibt dieses Feld die Initialisierungs- und Erstellungskennzeichnungen an. Beim Beenden gibt es die Auswahlmöglichkeiten des Benutzers an. Es kann eine Kombination der folgenden Flags sein.

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 Convert.

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

lpszTemplate

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

hResource

Ressourcenhandle für ein benutzerdefiniertes Dialogfeld. Wenn dieses Element NULL-ist, verwendet die Bibliothek die standardvorlage Dialogfeld "Konvertieren" oder wenn es gültig ist, die Vorlage, die vom lpszTemplate Member benannt wurde.

clsid

Die CLSID des objekts, das konvertiert oder aktiviert werden soll. Dieses Element wird für eingaben festgelegt.

clsidConvertDefault

Die CLSID, die als Standardklasse verwendet werden soll, wenn "In konvertieren" ausgewählt ist. Dieses Element wird ignoriert, wenn das dwFlags Member nicht CF_SETCONVERTDEFAULT enthält. Dieses Element wird für eingaben festgelegt.

clsidActivateDefault

Die CLSID, die als Standardklasse verwendet werden soll, wenn Aktivieren unter ausgewählt ist. Dieses Element wird ignoriert, wenn das dwFlags Member nicht CF_SETACTIVATEDEFAULT enthält. Dieses Element wird für eingaben festgelegt.

clsidNew

Die CLSID der ausgewählten Klasse. Dieses Element wird für die Ausgabe festgelegt.

dvAspect

Aspekt des Objekts. Dies muss entweder DVASPECT_CONTENT oder DVASPECT_ICON sein. Wenn dvAspect bei eingaben DVASPECT_ICON ist, wird das Kontrollkästchen Als Symbol anzeigen aktiviert, und das Objektsymbol wird angezeigt. Dieses Element wird für Eingabe und Ausgabe festgelegt. Weitere Informationen finden Sie unter DVASPECT.

wFormat

Datenformat des objekts, das konvertiert oder aktiviert werden soll.

fIsLinkedObject

TRUE, wenn das Objekt verknüpft ist. Dieses Element wird für eingaben festgelegt.

hMetaPict

Das METAFILEPICT-, das den iconicn Aspekt enthält. Dieses Element wird für Eingabe und Ausgabe festgelegt.

lpszUserType

Zeigen Sie auf den Benutzernamen des Objekts, das konvertiert oder aktiviert werden soll. Wenn dieser Wert NULL-ist, ruft das Dialogfeld den Benutzernamen aus der Registrierung ab. Diese Zeichenfolge wird beim Beenden freigegeben.

fObjectsIconChanged

TRUE, wenn sich das Objektsymbol geändert hat. (d. h., wenn OleUIChangeIcon- aufgerufen und nicht abgebrochen wurde.) Dieses Element wird für die Ausgabe festgelegt.

lpszDefLabel

Zeigen Sie auf die Standardbezeichnung, die für das Symbol verwendet werden soll. Wenn NULL-, wird der kurze Benutzername 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

Zeigen Sie auf die Liste der CLSIDs, die aus der Liste ausgeschlossen werden sollen.

Bemerkungen

Anforderungen

Siehe auch

OleUIChangeIcon

OleUIConvert-