OLEUICONVERTW-Struktur (oledlg.h)

Artikel
08/25/2023

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.

Wert	Bedeutung
CF_SHOWHELPBUTTON	Im Dialogfeld wird eine Hilfeschaltfläche angezeigt. Dieses Flag wird bei der Eingabe festgelegt.
CF_SETCONVERTDEFAULT	Klasse, deren CLSID von clsidConvertDefault angegeben wird, wird als Standardauswahl verwendet. Diese Auswahl wird im Listenfeld Klasse angezeigt, wenn das Optionsfeld Konvertieren in ausgewählt ist. Dieses Flag wird bei der Eingabe festgelegt.
CF_SETACTIVATEDEFAULT	Klasse, deren CLSID von clsidActivateDefault angegeben wird, wird als Standardauswahl verwendet. Diese Auswahl wird im Listenfeld Klasse angezeigt, wenn das Optionsfeld Aktivieren als ausgewählt ist. Dieses Flag wird bei der Eingabe festgelegt.
CF_SELECTCONVERTTO	Bei der Eingabe gibt dieses Flag an, dass Zuerst Konvertieren in ausgewählt wird (Standardverhalten). Dieses Flag wird bei der Ausgabe festgelegt, wenn Konvertieren in ausgewählt wurde, als der Benutzer das Dialogfeld geschlossen hat.
CF_SELECTACTIVATEAS	Bei der Eingabe gibt dieses Flag an, dass "Aktivieren unter" zunächst ausgewählt wird. Dieses Flag wird bei der Ausgabe festgelegt, wenn Aktivieren unter ausgewählt wurde, als der Benutzer das Dialogfeld geschlossen hat.
CF_DISABLEDISPLAYASICON	Die Schaltfläche Anzeige als Symbol wird bei der Initialisierung deaktiviert.
CF_DISABLEACTIVATEAS	Das Optionsfeld Aktivieren unter wird bei der Initialisierung deaktiviert.
CF_HIDECHANGEICON	Die Schaltfläche Symbol ändern wird im Dialogfeld Konvertieren ausgeblendet.
CF_CONVERTONLY	Das Optionsfeld Aktivieren als wird im Dialogfeld Konvertieren deaktiviert.

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

Weitere Informationen

OleUIChangeIcon

OleUIConvert

Share via