OLEUICHANGESOURCEA-Struktur (oledlg.h)

Artikel
03/01/2024

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 innerhalb der Datei umfassen, z. B. das Ändern des Zielbereichs von Zellen innerhalb der Tabelle, zu der der Link gehört.

Syntax

typedef struct tagOLEUICHANGESOURCEA {
  DWORD                 cbStruct;
  DWORD                 dwFlags;
  HWND                  hWndOwner;
  LPCSTR                lpszCaption;
  LPFNOLEUIHOOK         lpfnHook;
  LPARAM                lCustData;
  HINSTANCE             hInstance;
  LPCSTR                lpszTemplate;
  HRSRC                 hResource;
  OPENFILENAMEA         *lpOFN;
  DWORD                 dwReserved1[4];
  LPOLEUILINKCONTAINERA lpOleUILinkContainer;
  DWORD                 dwLink;
  LPSTR                 lpszDisplayName;
  ULONG                 nFileLength;
  LPSTR                 lpszFrom;
  LPSTR                 lpszTo;
} OLEUICHANGESOURCEA, *POLEUICHANGESOURCEA, *LPOLEUICHANGESOURCEA;

Member

cbStruct

Die Größe der Struktur in Bytes.

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
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 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 die OLEUICHANGEICON-Struktur im lParam-Parameter der WM_INITDIALOG Meldung verweist; 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.

lpOFN

Zeiger auf die OPENFILENAME-Struktur , die Informationen enthält, die vom Betriebssystem zum Initialisieren der systemdefinierte Dialogfelder Öffnen oder Speichern unter verwendet werden.

dwReserved1[4]

Dieser Member ist reserviert.

lpOleUILinkContainer

Zeiger auf die Implementierung der IOleUILinkContainer-Schnittstelle im Container, die zum Überprüfen der Linkquelle verwendet wird. Im Dialogfeld Links 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 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

IOleUILinkContainer

OleUIChangeSource

Share via