OLEUICHANGESOURCEW-Struktur (oledlg.h)

Artikel
08/25/2023

Enthält Informationen, die zum Initialisieren des Standardmäßigen Dialogfelds Quelle ändern verwendet werden. Es ermöglicht dem Benutzer, das Ziel oder die Quelle eines Links zu ändern. Dies kann einfach die Auswahl eines anderen Dateinamens für den Link oder das Ändern des Elementverweis in der Datei umfassen, z. B. das Ändern des Zielbereichs von Zellen innerhalb der Tabelle, an die der Link gesendet wird.

Syntax

typedef struct tagOLEUICHANGESOURCEW {
  DWORD                 cbStruct;
  DWORD                 dwFlags;
  HWND                  hWndOwner;
  LPCWSTR               lpszCaption;
  LPFNOLEUIHOOK         lpfnHook;
  LPARAM                lCustData;
  HINSTANCE             hInstance;
  LPCWSTR               lpszTemplate;
  HRSRC                 hResource;
  OPENFILENAMEW         *lpOFN;
  DWORD                 dwReserved1[4];
  LPOLEUILINKCONTAINERW lpOleUILinkContainer;
  DWORD                 dwLink;
  LPWSTR                lpszDisplayName;
  ULONG                 nFileLength;
  LPWSTR                lpszFrom;
  LPWSTR                lpszTo;
} OLEUICHANGESOURCEW, *POLEUICHANGESOURCEW, *LPOLEUICHANGESOURCEW;

Member

cbStruct

Die Größe der Struktur in Bytes.

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
CSF_SHOWHELP	Aktiviert oder zeigt die Schaltfläche Hilfe an.
CSF_VALIDSOURCE	Gibt an, dass der Link überprüft wurde.
CSF_ONLYGETSOURCE	Deaktiviert die automatische Überprüfung der Linkquelle, wenn der Benutzer OK drückt. Wenn Sie dieses Flag angeben, sollten Sie die Quelle überprüfen, wenn das Dialogfeld OK zurückgibt.

hWndOwner

Das Fenster, das das Dialogfeld besitzt.

lpszCaption

Zeiger auf eine Zeichenfolge, die als Titel des Dialogfelds verwendet werden soll. Wenn NULL, verwendet die Bibliothek Quelle ä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 die OLEUICHANGEICON-Struktur im lParam-Parameter der WM_INITDIALOG-Nachricht verweist; 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 .

lpOFN

Zeiger auf die OPENFILENAME-Struktur , die Informationen enthält, die vom Betriebssystem verwendet werden, um die systemdefinierte Dialogfelder Öffnen oder Speichern unter zu initialisieren.

dwReserved1[4]

Dieses Element ist reserviert.

lpOleUILinkContainer

Zeiger auf die Implementierung der IOleUILinkContainer-Schnittstelle im Container, die zum Überprüfen der Linkquelle verwendet wird. Im Dialogfeld Verknüpfungen bearbeiten wird dies verwendet, damit der Container seine Verknüpfungen bearbeiten kann.

dwLink

Containerdefinierter eindeutiger Linkbezeichner, der zum Überprüfen von Linkquellen verwendet wird. Wird von lpOleUILinkContainer verwendet.

lpszDisplayName

Zeiger auf den vollständigen Quellanzeigenamen.

nFileLength

Dateimonikerteil von lpszDisplayName.

lpszFrom

Zeiger auf das Präfix der Quelle, von der geändert wurde.

lpszTo

Zeiger auf das Präfix der Quelle, in die geändert werden soll.

Hinweise

Hinweis

Der oledlg.h-Header definiert OLEUICHANGESOURCE 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 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	oledlg.h

Weitere Informationen

IOleUILinkContainer

OleUIChangeSource

Freigeben über