OLEUICHANGESOURCE - OLE Programmer's Reference

Custom Search

OLEUICHANGESOURCE

This structure is used to initialize the standard Change Source dialog box. It allows the user to modify the destination or source of a link. This may simply entail selecting a different file name for the link, or possibly changing the item reference within the file, for example, changing the destination range of cells within spreadsheet that the link is to.

typedef struct tagOLEUICHANGESOURCEW

{

// These IN fields are standard across all OLEUI dialog functions. DWORD cbStruct;

DWORDT dwFlags;

HWND hWndOwner;

LPCWSTR lpszCaption;

LPFNOLEUIHOOK lpfnHook;

LPARAM lCustData;

HINSTANCE hInstance;

LPCWSTR lpszTemplate;

HRSRC hResource;

// INTERNAL ONLY: do not modify these members

OPENFILENAMEW* lpOFN;

DWORD dwReserved1[4];

// Specifics for OLEUICHANGESOURCE.

LPOLEUILINKCONTAINERW lpOleUILinkContainer;

DWORD dwLink;

LPTSTR lpszDisplayName;

ULONG nFileLength;

LPTSTR lpszFrom;

LPTSTR lpszTo;

} OLEUICHANGESOURCEW, *POLEUICHANGESOURCEW, FAR *LPOLEUICHANGESOURCEW;

Members
cbStruct
The size of the structure in bytes.

dwFlags
On input, this field specifies the initialization and creation flags. On exit, it specifies the user's choices. It may be a combination of the following flags:

CSF_SHOWHELP

Enables or shows the Help button.

CSF_VALIDSOURCE

Indicates that the link was validated.

CSF_ONLYGETSOURCE

Disables automatic validation of the link source when the user presses OK. If you specify this flag, you should validate the source when the dialog box returns OK.

hWndOwner
Identifies the window that owns the dialog box.

lpszCaption
Points to a string to be used as the title of the dialog box. If NULL, then the library uses Change Source.

lpfnHook
Points to a hook function that processes messages intended for the dialog box. The hook function must return zero to pass a message that it didn't process back to the dialog box procedure in the library. The hook function must return a non zero value to prevent the library's dialog box procedure from processing a message it has already processed.

lCustData
Specifies application-defined data that the library passes to the hook function pointed to by the lpfnHook member. The library passes a pointer to the OLEUICHANGEICON structure in the lParam parameter of the WM_INITDIALOG message; this pointer can be used to retrieve the lCustData member.

hInstance
Identifies a instance that contains a dialog box template specified by the lpszTemplate member. This member is ignored if the lpszTemplate member is NULL or invalid.

lpszTemplate

Points to a null-terminated string that specifies the name of the resource file for the dialog box template that is to be substituted for the library's Convert dialog box template.

hResource

The resource handle for a custom dialog. If this member is NULL, then the library uses the standard Convert dialog template, or if it is valid, the template named by the lpszTemplate member.

lpOFN
Points to the OPENFILENAME structure, which contains information used by the operating system to initialize the system-defined Open or Save As dialog boxes.

dwReserved1[4]
Reserved for future use.

lpOleUILinkContainer
Pointsto the container's implementation of the IOleUILinkContainer Interface; used to validate the link source. The Edit Links dialog uses this to allow the container to manipulate its links.

dwLink
A container-defined unique 32-bit link identifier used to validate link sources. Used by lpOleUILinkContainer.

lpszDisplayName
Points to the complete source display name.

nFileLength
This is the file moniker portion of lpszDisplayName.

lpszFrom
The prefix of the source that was changed from.

lpszTo
The prefix of the source to be changed to.

See Also
IOleUILinkContainer, OleUIChangeSource

Last news from Greatis Software

    Nostalgia .Net     .Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More »

Recommended software for developers

    Ultimate Pack     Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More »

    Form Designer .Net     Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More »

    Print Suite .Net     Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More »

    Gradient Controls .Net     Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More »

    Greatis iGrid     iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More »

All the contacts and projects

Dmitry Vasiliev (just.dmitry)

More Online Helps

Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages

greatis just4fun network