OLEUICONVERTA-Struktur (oledlg.h)

Artikel
08/25/2023

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.

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 Klassenlistenfeld 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 Klassenlistenfeld 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 zunächst Aktivieren als ausgewählt wird. Dieses Flag wird bei der Ausgabe festgelegt, wenn Aktivieren als ausgewählt wurde, als der Benutzer das Dialogfeld geschlossen hat.
CF_DISABLEDISPLAYASICON	Die Schaltfläche Symbol anzeigen wird bei der Initialisierung deaktiviert.
CF_DISABLEACTIVATEAS	Das Optionsfeld Aktivieren als 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 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

Hinweis

Der oledlg.h-Header definiert OLEUICONVERT 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
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