OLEUICHANGEICONW-Struktur (oledlg.h)

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

Syntax

typedef struct tagOLEUICHANGEICONW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  HGLOBAL       hMetaPict;
  CLSID         clsid;
  WCHAR         szIconExe[MAX_PATH];
  int           cchIconExe;
} OLEUICHANGEICONW, *POLEUICHANGEICONW, *LPOLEUICHANGEICONW;

Angehörige

cbStruct

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

dwFlags

Gibt bei eingaben die Initialisierungs- und Erstellungskennzeichnungen an. Beim Beenden gibt es die Auswahlmöglichkeiten des Benutzers an. Dies kann eine Kombination aus den folgenden Flags sein.

Wert	Bedeutung
CIF_SHOWHELP	Im Dialogfeld wird eine Schaltfläche Hilfe- angezeigt.
CIF_SELECTCURRENT	Wählt bei der Eingabe das Optionsfeld Aktuelle bei der Initialisierung aus. Gibt beim Beenden an, dass der Benutzer Currentausgewä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 Dateiausgewä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-Einbettungen oder Verknüpfungen mit Nicht-OLE-Dateien.

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

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 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 Member angegeben wird.

lpszTemplate

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

hResource

Angepasster Vorlagenhandle.

hMetaPict

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

clsid

Nur Eingabe. Die Klasse, die zum Abrufen des Symbols Standard- verwendet werden soll.

szIconExe[MAX_PATH]

Nur Eingabe. Zeigen Sie auf die ausführbare Datei, um das Standardsymbol zu extrahieren. Dieses Element wird ignoriert, es sei denn, CIF_USEICONEXE im dwFlags Member 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 Mitglied enthalten.

Bemerkungen

Anmerkung

Der oledlg.h-Header definiert OLEUICHANGEICON 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 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
mindestens unterstützte Client-	Windows 10 Build 20348
mindestens unterstützte Server-	Windows 10 Build 20348
Header-	oledlg.h