Struttura OLEUICHANGESOURCEA (oledlg.h)

Contiene informazioni utilizzate per inizializzare la finestra di dialogo origine delle modifiche 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 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 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;

Membri

cbStruct

Dimensione 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.

Valore	Significato
CSF_SHOWHELP	Abilita o visualizza il pulsante ?
CSF_VALIDSOURCE	Indica che il collegamento è stato convalidato.
CSF_ONLYGETSOURCE	Disabilita la convalida automatica dell'origine del collegamento quando l'utente preme OK. Se si specifica questo flag, è necessario convalidare l'origine quando la finestra di dialogo restituisce OK.

hWndOwner

Finestra proprietaria della finestra di dialogo.

lpszCaption

Puntatore a una stringa da usare come titolo della finestra di dialogo. Se null, la libreria usa Modifica origine.

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 di nuovo 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 di 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 standard converti finestra di dialogo oppure, 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 consente al contenitore di modificare i collegamenti.

dwLink

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

lpszDisplayName

Puntatore al nome visualizzato di origine completo.

nFileLength

Parte del moniker di file di lpszDisplayName.

lpszFrom

Puntatore al prefisso dell'origine da cui è stato modificato.

lpszTo

Puntatore al prefisso dell'origine in cui modificare.

Osservazioni

Nota

L'intestazione oledlg.h definisce OLEUICHANGESOURCE come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	oledlg.h

Vedere anche

IOleUILinkContainer

OleUIChangeSource