OLEUICHANGEICONA-Struktur (oledlg.h)

Enthält Informationen, die die OLE-Benutzeroberflächenbibliothek verwendet, um das Dialogfeld Symbol ändern zu initialisieren, und enthält Speicherplatz für die Bibliothek, um Informationen zurückzugeben, wenn das Dialogfeld geschlossen wird.

Syntax

typedef struct tagOLEUICHANGEICONA {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCSTR        lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCSTR        lpszTemplate;
  HRSRC         hResource;
  HGLOBAL       hMetaPict;
  CLSID         clsid;
  CHAR          szIconExe[MAX_PATH];
  int           cchIconExe;
} OLEUICHANGEICONA, *POLEUICHANGEICONA, *LPOLEUICHANGEICONA;

Member

cbStruct

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

dwFlags

Gibt bei der Eingabe die Initialisierungs- und Erstellungsflags an. Beim Beenden werden die Optionen des Benutzers angegeben. Dies kann eine Kombination der folgenden Flags sein.

Wert	Bedeutung
CIF_SHOWHELP	Im Dialogfeld wird eine Hilfeschaltfläche angezeigt.
CIF_SELECTCURRENT	Wählt bei der Eingabe das Optionsfeld Aktuell bei der Initialisierung aus. Gibt beim Beenden an, dass der Benutzer Aktuell ausgewählt hat.
CIF_SELECTDEFAULT	Wählt bei der Eingabe das Optionsfeld Standard bei der Initialisierung aus. Gibt beim Beenden an, dass der Benutzer Standard ausgewählt hat.
CIF_SELECTFROMFILE	Wählt bei der Eingabe das Optionsfeld Aus Datei bei der Initialisierung aus. Gibt beim Beenden an, dass der Benutzer Aus Datei ausgewählt hat.
CIF_USEICONEXE	Nur Eingabe. Extrahiert das Symbol aus der ausführbaren Datei, die im szIconExe-Member angegeben ist, anstatt es aus der Klasse abzurufen. Dies ist nützlich für OLE-Einbetten oder Verknüpfen mit Nicht-OLE-Dateien.

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 Das Symbol ändern.

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 OLEUICHANGEICON-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 lpTemplateName-Element angegeben wird.

lpszTemplate

Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen der Ressourcendatei für die Dialogfeldvorlage angibt, die durch die Dialogfeldvorlage Ändern symbol der Bibliothek ersetzt werden soll.

hResource

Angepasstes Vorlagenhandle.

hMetaPict

Aktuelles und endgültiges Bild. Die Quelle des Symbols ist in die Metadatei selbst eingebettet.

clsid

Nur Eingabe. Die Klasse, die zum Abrufen des Standardsymbols verwendet werden soll.

szIconExe[MAX_PATH]

Nur Eingabe. Zeiger auf die ausführbare Datei, aus der das Standardsymbol extrahiert werden soll. Dieser Member wird ignoriert, es sei denn, CIF_USEICONEXE im dwFlags-Element enthalten ist, und ein Versuch, das Klassensymbol aus der angegebenen CLSID abzurufen, schlägt fehl.

cchIconExe

Nur Eingabe. Die Anzahl der Zeichen in szIconExe. Dieses Element wird ignoriert, es sei denn, CIF_USEICONEXE ist im dwFlags-Element enthalten.

Hinweise

Hinweis

Der oledlg.h-Header definiert OLEUICHANGEICON 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 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 10 Build 20348
Unterstützte Mindestversion (Server)	Windows 10 Build 20348
Kopfzeile	oledlg.h