home *** CD-ROM | disk | FTP | other *** search
/ Tools / WinSN5.0Ver.iso / NETSCAP.50 / WIN1998.ZIP / ns / cmd / winfe / prefs / nsprefui / public / ippageex.h next >
Encoding:
C/C++ Source or Header  |  1998-04-08  |  2.6 KB  |  73 lines
  1. /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
  2.  *
  3.  * The contents of this file are subject to the Netscape Public License
  4.  * Version 1.0 (the "NPL"); you may not use this file except in
  5.  * compliance with the NPL.  You may obtain a copy of the NPL at
  6.  * http://www.mozilla.org/NPL/
  7.  *
  8.  * Software distributed under the NPL is distributed on an "AS IS" basis,
  9.  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
  10.  * for the specific language governing rights and limitations under the
  11.  * NPL.
  12.  *
  13.  * The Initial Developer of this code under the NPL is Netscape
  14.  * Communications Corporation.  Portions created by Netscape are
  15.  * Copyright (C) 1998 Netscape Communications Corporation.  All Rights
  16.  * Reserved.
  17.  */
  18.  
  19. #ifndef __PPAGEEX_H_
  20. #define __PPAGEEX_H_
  21.  
  22. /////////////////////////////////////////////////////////////////////////////
  23. // IPropertyPageEx interface
  24.  
  25. #ifdef __cplusplus
  26. interface IPropertyPageEx;
  27. #else
  28. typedef interface IPropertyPageEx IPropertyPageEx;
  29. #endif
  30.  
  31. typedef IPropertyPageEx FAR* LPPROPERTYPAGEEX;
  32.  
  33. #undef  INTERFACE
  34. #define INTERFACE IPropertyPageEx
  35.  
  36. // IPropertyPageEx adds method PageChanging() which notifies a page that it
  37. // is about to lose the activation because another page is being activated.
  38. // The property page should validate the information the user has typed, and
  39. // return S_OK to allow the page change
  40. //
  41. // Return S_FALSE to prevent the page from losing the activation. Display
  42. // a dialog box to explain the problem, and set the focus to the control that
  43. // didn't validate
  44. //
  45. // NOTE: The use of IPropertyPageEx is optional, and you can use IPropertyPage
  46. // if you like
  47. DECLARE_INTERFACE_(IPropertyPageEx, IPropertyPage)
  48. {
  49.     // IUnknown methods
  50.     STDMETHOD(QueryInterface)(THIS_ REFIID riid, LPVOID FAR* ppvObj) PURE;
  51.     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
  52.     STDMETHOD_(ULONG,Release)(THIS) PURE;
  53.  
  54.     // IPropertyPage methods
  55.     STDMETHOD(SetPageSite)(THIS_ LPPROPERTYPAGESITE pPageSite) PURE;
  56.     STDMETHOD(Activate)(THIS_ HWND hwndParent, LPCRECT lprc, BOOL bModal) PURE;
  57.     STDMETHOD(Deactivate)(THIS) PURE;
  58.     STDMETHOD(GetPageInfo)(THIS_ LPPROPPAGEINFO pPageInfo) PURE;
  59.     STDMETHOD(SetObjects)(THIS_ ULONG cObjects, LPUNKNOWN FAR* ppunk) PURE;
  60.     STDMETHOD(Show)(THIS_ UINT nCmdShow) PURE;
  61.     STDMETHOD(Move)(THIS_ LPCRECT prect) PURE;
  62.     STDMETHOD(IsPageDirty)(THIS) PURE;
  63.     STDMETHOD(Apply)(THIS) PURE;
  64.     STDMETHOD(Help)(THIS_ LPCOLESTR lpszHelpDir) PURE;
  65.     STDMETHOD(TranslateAccelerator)(THIS_ LPMSG lpMsg) PURE;
  66.  
  67.     // IPropertyPageEx methods
  68.     STDMETHOD(PageChanging)(THIS_ LPPROPERTYPAGE pNewPage) PURE;
  69. };
  70.  
  71. #endif /* __PPAGEEX_H_ */
  72.  
  73.