CX_SelectItemsStruct struct

Structure that contains the input/output parameters for CX_SelectItems.

Syntax

struct CX_SelectItemsStruct
{
   CX_SelectItemsStruct() {
      cbSize = sizeof(*this); dwFlags = 0; hwndParent = NULL; pFilter = NULL; hglSeqCur = NULL;
      pszDlgTitle = NULL; nMinSize = 0; nMaxSize = -1; *szLastFolder = L'\0'; hglSeqNew = NULL;
   };

   UINT cbSize;
   DWORD dwFlags;
   HWND hwndParent;
   CX_FilterSpec* pFilter;
   HGLOBAL hglSeqCur;
   const wchar_t* pszDlgTitle;
   int nMinSize;
   int nMaxSize;
   wchar_t szLastFolder[MAX_PATH];
   HGLOBAL hglSeqNew;
};

Members

cbSize

Type: UINT

(in) Size of this structure, in byte

dwFlags

Type: DWORD

(in) Flags (set to 0)

hwndParent

Type: HWND

(in) Parent window for dialog box.

pFilter

Type: CX_FilterSpec*

(in) Filter to enforce when selecting images, or NULL for no filter.

hglSeqCur

Type: HGLOBAL

(in) Current image sequence. Can be NULL (Allocated with GlobalAlloc()).

pszDlgTitle

Type: const wchar_t*

(in) Dialog box title, or NULL for default.

nMinSize

Type: int

(in) Minimum number of items in the returned sequence

nMaxSize

Type: int

(in) Maximum number of items in the returned sequence (or -1 for no limit)

szLastFolder

Type: wchar_t[MAX_PATH]

(i/o) Folder last used for selecting candidate items

hglSeqNew

Type: HGLOBAL

(out) Modified image sequence. Can be NULL (Freed with GlobalFree()).

Remarks

hglSeqCur and hglSeqNew each reference a buffer containing a double null-terminated list of fully-qualified file paths. The plug-in is responsible for freeing hglSeqCur and hglSeqNew using GlobalFree() (used in the CX_SelectItems callback function).

Requirements

Header: CX_PlugIn.h

See also: