OLEUICHANGEICONW-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 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;
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 |