OLEUICHANGESOURCEA-Struktur (oledlg.h)

Enthält Informationen, die verwendet werden, um das Standarddialogfeld ändern zu initialisieren. Er ermöglicht es dem Benutzer, das Ziel oder die Quelle eines Links zu ändern. Dies kann einfach dazu führen, einen anderen Dateinamen für den Link auszuwählen, oder möglicherweise den Elementverweis innerhalb der Datei zu ändern, z. B. das Ändern des Zielbereichs von Zellen innerhalb der Kalkulationstabelle, 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;

Angehörige

cbStruct

Die Größe der Struktur in Byte.

dwFlags

Bei eingaben gibt dieses Feld die Initialisierungs- und Erstellungskennzeichnungen an. Beim Beenden gibt es die Auswahlmöglichkeiten des Benutzers an. Es kann eine Kombination der folgenden Flags sein.

hWndOwner

Das Fenster, das das Dialogfeld besitzt.

lpszCaption

Zeigen Sie auf eine Zeichenfolge, die als Titel des Dialogfelds verwendet werden soll. Wenn NULL-, verwendet die Bibliothek Change Source.

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 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 Member NULL- oder ungültig ist.

lpszTemplate

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

hResource

Ressourcenhandle für ein benutzerdefiniertes Dialogfeld. Wenn dieses Element NULL-ist, verwendet die Bibliothek die standardvorlage Dialogfeld "Konvertieren" oder wenn es gültig ist, die Vorlage, die vom lpszTemplate Member benannt wurde.

lpOFN

Zeigen Sie auf die OPENFILENAME- Struktur, die Informationen enthält, die vom Betriebssystem verwendet werden, um die vom System definierten Öffnen oder Dialogfelder "Speichern unter" zu initialisieren.

dwReserved1[4]

Dieses Mitglied ist reserviert.

lpOleUILinkContainer

Zeiger auf die Implementierung des IOleUILinkContainer Schnittstelle des Containers, die zum Überprüfen der Verknüpfungsquelle 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 lpOleUILinkContainerverwendet.

lpszDisplayName

Zeigen Sie auf den vollständigen Anzeigenamen der Quelle.

nFileLength

Datei moniker Teil von lpszDisplayName.

lpszFrom

Zeigen Sie auf das Präfix der Quelle, von der sie geändert wurde.

lpszTo

Zeigen Sie auf das Präfix der Quelle, in das sie geändert werden soll.

Bemerkungen

Anforderungen

Siehe auch

IOleUILinkContainer-

OleUIChangeSource-