OLEUICONVERTW-Struktur (oledlg.h)
Enthält Informationen, die die OLE-Benutzeroberflächenbibliothek verwendet, um das Dialogfeld Konvertieren zu initialisieren, und Speicherplatz für die Bibliothek, um Informationen zurückzugeben, wenn das Dialogfeld geschlossen wird.
Syntax
typedef struct tagOLEUICONVERTW {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCWSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCWSTR lpszTemplate;
HRSRC hResource;
CLSID clsid;
CLSID clsidConvertDefault;
CLSID clsidActivateDefault;
CLSID clsidNew;
DWORD dvAspect;
WORD wFormat;
BOOL fIsLinkedObject;
HGLOBAL hMetaPict;
LPWSTR lpszUserType;
BOOL fObjectsIconChanged;
LPWSTR lpszDefLabel;
UINT cClsidExclude;
LPCLSID lpClsidExclude;
} OLEUICONVERTW, *POLEUICONVERTW, *LPOLEUICONVERTW;
Member
cbStruct
Die Größe der Struktur in Bytes. Dieses Element muss bei der Eingabe ausgefüllt werden.
dwFlags
Bei der Eingabe gibt dieses Feld die Initialisierungs- und Erstellungsflags an. Beim Beenden werden die Optionen 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 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 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-ElementNULL oder ungültig ist.
lpszTemplate
Zeiger auf eine null-beendete 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 mit dem Namen des lpszTemplate-Members .
clsid
Die CLSID des zu konvertierenden oder zu aktivierenden Objekts. Dieses Element 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 nicht CF_SETCONVERTDEFAULT enthält. Dieses Element 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 nicht CF_SETACTIVATEDEFAULT enthält. Dieses Element wird bei der Eingabe festgelegt.
clsidNew
Die CLSID der ausgewählten Klasse. Dieses Element wird bei der 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 Objektsymbol wird angezeigt. Dieses Element 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. Dieses Element wird bei der Eingabe festgelegt.
hMetaPict
Die METAFILEPICT enthält den ikonischen Aspekt. Dieses Element wird für Eingabe und Ausgabe festgelegt.
lpszUserType
Zeiger auf den Benutzernamennamen 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 Objektsymbol geändert hat. (das heißt, wenn OleUIChangeIcon aufgerufen und nicht abgebrochen wurde.). Dieses Element wird bei der Ausgabe festgelegt.
lpszDefLabel
Zeiger auf die Standardbezeichnung, die für das Symbol verwendet werden soll. Bei NULL wird der kurze Benutzername verwendet. Wenn es sich bei dem Objekt um einen Link handelt, 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
Hinweis
Der oledlg.h-Header definiert OLEUICONVERT 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 |