| 1 | /* ***** BEGIN LICENSE BLOCK *****
|
|---|
| 2 | * Version: CDDL 1.0/LGPL 2.1
|
|---|
| 3 | *
|
|---|
| 4 | * The contents of this file are subject to the COMMON DEVELOPMENT AND
|
|---|
| 5 | * DISTRIBUTION LICENSE (CDDL) Version 1.0 (the "License"); you may not use
|
|---|
| 6 | * this file except in compliance with the License. You may obtain a copy of
|
|---|
| 7 | * the License at http://www.sun.com/cddl/
|
|---|
| 8 | *
|
|---|
| 9 | * Software distributed under the License is distributed on an "AS IS" basis,
|
|---|
| 10 | * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|---|
| 11 | * for the specific language governing rights and limitations under the
|
|---|
| 12 | * License.
|
|---|
| 13 | *
|
|---|
| 14 | * The Original Code is "NOM" Netlabs Object Model
|
|---|
| 15 | *
|
|---|
| 16 | * The Initial Developer of the Original Code is
|
|---|
| 17 | * netlabs.org: Chris Wohlgemuth <cinc-ml@netlabs.org>.
|
|---|
| 18 | * Portions created by the Initial Developer are Copyright (C) 2005-2006
|
|---|
| 19 | * the Initial Developer. All Rights Reserved.
|
|---|
| 20 | *
|
|---|
| 21 | * Contributor(s):
|
|---|
| 22 | *
|
|---|
| 23 | * Alternatively, the contents of this file may be used under the terms of
|
|---|
| 24 | * the GNU Lesser General Public License Version 2.1 (the "LGPL"), in which
|
|---|
| 25 | * case the provisions of the LGPL are applicable instead of those above. If
|
|---|
| 26 | * you wish to allow use of your version of this file only under the terms of
|
|---|
| 27 | * the LGPL, and not to allow others to use your version of this file under
|
|---|
| 28 | * the terms of the CDDL, indicate your decision by deleting the provisions
|
|---|
| 29 | * above and replace them with the notice and other provisions required by the
|
|---|
| 30 | * LGPL. If you do not delete the provisions above, a recipient may use your
|
|---|
| 31 | * version of this file under the terms of any one of the CDDL or the LGPL.
|
|---|
| 32 | *
|
|---|
| 33 | * ***** END LICENSE BLOCK ***** */
|
|---|
| 34 |
|
|---|
| 35 | #ifndef WPWINDOW_IDL_INCLUDED
|
|---|
| 36 | #define WPWINDOW_IDL_INCLUDED
|
|---|
| 37 |
|
|---|
| 38 | #if 0
|
|---|
| 39 | #ifndef WPObject_defined
|
|---|
| 40 | #define WPObject_defined
|
|---|
| 41 | native PWPObject;
|
|---|
| 42 | #endif
|
|---|
| 43 | #endif
|
|---|
| 44 |
|
|---|
| 45 | #include <nomobj.idl>
|
|---|
| 46 | #include "nomwindow.idl"
|
|---|
| 47 | #include "nomstring.idl"
|
|---|
| 48 |
|
|---|
| 49 | NOMCLASSNAME(WPWindow);
|
|---|
| 50 |
|
|---|
| 51 | #if 1
|
|---|
| 52 | #ifndef WPOBJECT_IDL_INCLUDED
|
|---|
| 53 | native PWPObject;
|
|---|
| 54 | #endif
|
|---|
| 55 | #else
|
|---|
| 56 | #include "wpobject.idl"
|
|---|
| 57 | #endif
|
|---|
| 58 |
|
|---|
| 59 | interface WPWindow : NOMWindow
|
|---|
| 60 | {
|
|---|
| 61 | NOMCLASSVERSION(1, 0);
|
|---|
| 62 |
|
|---|
| 63 | /**
|
|---|
| 64 | Instances of the WPWindow class (or subclasses of WPWindow) are usually created
|
|---|
| 65 | by desktop classes. For example WPFolderWindow instances (folder views) or
|
|---|
| 66 | WPNoteBook instances (settings notebooks). This method is used so the desktop class
|
|---|
| 67 | can save a pointer to itself for use from within the WPWindow class code.
|
|---|
| 68 |
|
|---|
| 69 | \remark Note that this method is \b not a wrapper around
|
|---|
| 70 | \code
|
|---|
| 71 | g_object_set_data(G_OBJECT(window), NOMOBJECT_KEY_STRING, nomSelf);
|
|---|
| 72 | \endcode
|
|---|
| 73 | That call is used internally by the WPWindow class to connect a WPWindow instance
|
|---|
| 74 | (nomSelf in this call) with a GTK window.
|
|---|
| 75 |
|
|---|
| 76 | \par How to override:
|
|---|
| 77 | This method is usually not overriden.
|
|---|
| 78 |
|
|---|
| 79 | \param wpObject The desktop object this window belongs to.
|
|---|
| 80 |
|
|---|
| 81 | \par Example:
|
|---|
| 82 | The follwing code is a method implementation of class WPFolder. It creates a new
|
|---|
| 83 | folder window (of class WPFolderWindow) and uses wpSetWPObject() to connect the folder
|
|---|
| 84 | object (nomSelf) with the folder window.
|
|---|
| 85 | \include wpsetwpobject.c
|
|---|
| 86 |
|
|---|
| 87 | \sa wpQueryWPObject()
|
|---|
| 88 | */
|
|---|
| 89 | void wpSetWPObject(in PWPObject wpObject);
|
|---|
| 90 |
|
|---|
| 91 | /**
|
|---|
| 92 | Query the desktop object this window belongs to.
|
|---|
| 93 |
|
|---|
| 94 | \remark Note that this method is \b not a wrapper around
|
|---|
| 95 | \code
|
|---|
| 96 | g_object_get_data(G_OBJECT(window), NOMOBJECT_KEY_STRING);
|
|---|
| 97 | \endcode
|
|---|
| 98 | Using that call one queries the window object (\b not the desktop object) from
|
|---|
| 99 | a GTK toplevel window.
|
|---|
| 100 |
|
|---|
| 101 | \par How to override:
|
|---|
| 102 | This method is usually not overriden.
|
|---|
| 103 |
|
|---|
| 104 | \sa wpSetWPObject()
|
|---|
| 105 | */
|
|---|
| 106 | PWPObject wpQueryWPObject();
|
|---|
| 107 | void wpSetWindowTitle(in PNOMString newTitle);
|
|---|
| 108 | NOMINSTANCEVAR(PWPObject wpObject);
|
|---|
| 109 | };
|
|---|
| 110 |
|
|---|
| 111 | #endif /* WPWINDOW_IDL_INCLUDED */
|
|---|
| 112 |
|
|---|
| 113 |
|
|---|
| 114 |
|
|---|
| 115 |
|
|---|
