Struttura OLEUICHANGESOURCEW (oledlg.h)

Contiene informazioni utilizzate per inizializzare la finestra di dialogo Modifica origine standard. Consente all'utente di modificare la destinazione o l'origine di un collegamento. Ciò può comportare semplicemente la selezione di un nome di file diverso per il collegamento o eventualmente la modifica del riferimento all'elemento all'interno del file, ad esempio modificando l'intervallo di destinazione delle celle all'interno del foglio di calcolo a cui si trova il collegamento.

Sintassi

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;

Members

cbStruct

Dimensioni della struttura, in byte.

dwFlags

In input, questo campo specifica i flag di inizializzazione e creazione. All'uscita, specifica le scelte dell'utente. Può trattarsi di una combinazione dei flag seguenti.

hWndOwner

Finestra proprietaria della finestra di dialogo.

lpszCaption

Puntatore a una stringa da utilizzare come titolo della finestra di dialogo. Se NULL, la libreria usa Change Source.

lpfnHook

Puntatore a una funzione hook che elabora i messaggi destinati alla finestra di dialogo. La funzione hook deve restituire zero per passare un messaggio che non è stato elaborato nuovamente alla routine della finestra di dialogo nella libreria. La funzione hook deve restituire un valore diverso da zero per impedire alla routine della finestra di dialogo della libreria di elaborare un messaggio già elaborato.

lCustData

Dati definiti dall'applicazione che la libreria passa alla funzione hook a cui punta la struttura OLEUICHANGEICON nel parametro lParam del messaggio WM_INITDIALOG; questo puntatore può essere usato per recuperare il membro lCustData .

hInstance

Istanza che contiene un modello di finestra di dialogo specificato dal membro lpszTemplate . Questo membro viene ignorato se il membro lpszTemplate è NULL o non valido.

lpszTemplate

Puntatore a una stringa con terminazione Null che specifica il nome del file di risorse per il modello di finestra di dialogo da sostituire con il modello di finestra di dialogo Converti della libreria.

hResource

Handle di risorsa per una finestra di dialogo personalizzata. Se questo membro è NULL, la libreria usa il modello di finestra di dialogo Converti standard o, se è valido, il modello denominato dal membro lpszTemplate .

lpOFN

Puntatore alla struttura OPENFILENAME , che contiene informazioni utilizzate dal sistema operativo per inizializzare le finestre di dialogo Apri o Salva con nome definite dal sistema.

dwReserved1[4]

Questo membro è riservato.

lpOleUILinkContainer

Puntatore all'implementazione del contenitore dell'interfaccia IOleUILinkContainer , usata per convalidare l'origine del collegamento. La finestra di dialogo Modifica collegamenti utilizza questa opzione per consentire al contenitore di modificare i relativi collegamenti.

dwLink

Identificatore di collegamento univoco definito dal contenitore usato per convalidare le origini di collegamento. Usato da lpOleUILinkContainer.

lpszDisplayName

Puntatore al nome visualizzato completo dell'origine.

nFileLength

Parte del moniker file di lpszDisplayName.

lpszFrom

Puntatore al prefisso dell'origine da cui è stata modificata.

lpszTo

Puntatore al prefisso dell'origine in cui modificare.

Commenti

Requisiti

Vedi anche

IOleUILinkContainer

OleUIChangeSource