Struttura OLEUICHANGESOURCEA (oledlg.h)

Articolo
03/01/2024

Contiene informazioni usate 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 file diverso per il collegamento o eventualmente la modifica del riferimento all'elemento all'interno del file, ad esempio modificando l'intervallo di 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;

Members

cbStruct

Dimensioni della struttura, in byte.

dwFlags

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

Valore	Significato
CSF_SHOWHELP	Abilita o mostra il pulsante Della Guida.
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 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 nella procedura 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 risorsa per il modello di finestra di dialogo che deve essere sostituito per il modello di finestra di dialogo Converti della libreria.

hResource

Handle di risorse 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 usate dal sistema operativo per inizializzare le finestre di dialogo Open o Save As 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 usa questa opzione per consentire 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 file di lpszDisplayName.

lpszFrom

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

lpszTo

Puntatore al prefisso dell'origine da modificare.

Commenti

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	oledlg.h

Vedi anche

IOleUILinkContainer

OleUIChangeSource

Condividi tramite