]> git.saurik.com Git - wxWidgets.git/blob - wxPython/src/misc2.i
Beginning of bitmap updates
[wxWidgets.git] / wxPython / src / misc2.i
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: misc2.i
3 // Purpose: Definitions of miscelaneous functions and classes that need
4 // to know about wxWindow. (So they can't be in misc.i or an
5 // import loop will happen.)
6 //
7 // Author: Robin Dunn
8 //
9 // Created: 18-June-1999
10 // RCS-ID: $Id$
11 // Copyright: (c) 1998 by Total Control Software
12 // Licence: wxWindows license
13 /////////////////////////////////////////////////////////////////////////////
14
15 %module misc2
16
17 %{
18 #include "helpers.h"
19 #include <wx/resource.h>
20 #include <wx/tooltip.h>
21 #include <wx/caret.h>
22 #include <wx/fontenum.h>
23 #include <wx/tipdlg.h>
24 #include <wx/process.h>
25 #include <wx/joystick.h>
26 %}
27
28 //----------------------------------------------------------------------
29
30 %include typemaps.i
31 %include my_typemaps.i
32
33 // Import some definitions of other classes, etc.
34 %import _defs.i
35 %import windows.i
36 %import misc.i
37 %import gdi.i
38 %import events.i
39 %import streams.i
40
41 //---------------------------------------------------------------------------
42 // Dialog Functions
43
44 wxString wxFileSelector(char* message,
45 char* default_path = NULL,
46 char* default_filename = NULL,
47 char* default_extension = NULL,
48 char* wildcard = "*.*",
49 int flags = 0,
50 wxWindow *parent = NULL,
51 int x = -1, int y = -1);
52
53 wxString wxGetTextFromUser(const wxString& message,
54 const wxString& caption = wxPyEmptyStr,
55 const wxString& default_value = wxPyEmptyStr,
56 wxWindow *parent = NULL,
57 int x = -1, int y = -1,
58 bool centre = TRUE);
59
60
61 // TODO: Need to custom wrap this one...
62 // int wxGetMultipleChoice(char* message, char* caption,
63 // int LCOUNT, char** choices,
64 // int nsel, int *selection,
65 // wxWindow *parent = NULL, int x = -1, int y = -1,
66 // bool centre = TRUE, int width=150, int height=200);
67
68
69 wxString wxGetSingleChoice(const wxString& message, const wxString& caption,
70 int LCOUNT, wxString* choices,
71 wxWindow *parent = NULL,
72 int x = -1, int y = -1,
73 bool centre = TRUE,
74 int width=150, int height=200);
75
76 int wxGetSingleChoiceIndex(const wxString& message, const wxString& caption,
77 int LCOUNT, wxString* choices,
78 wxWindow *parent = NULL,
79 int x = -1, int y = -1,
80 bool centre = TRUE,
81 int width=150, int height=200);
82
83
84 int wxMessageBox(const wxString& message,
85 const wxString& caption = wxPyEmptyStr,
86 int style = wxOK | wxCENTRE,
87 wxWindow *parent = NULL,
88 int x = -1, int y = -1);
89
90 long wxGetNumberFromUser(const wxString& message,
91 const wxString& prompt,
92 const wxString& caption,
93 long value,
94 long min = 0, long max = 100,
95 wxWindow *parent = NULL,
96 const wxPoint& pos = wxPyDefaultPosition);
97
98 //---------------------------------------------------------------------------
99 // GDI Functions
100
101 bool wxColourDisplay();
102 int wxDisplayDepth();
103 void wxSetCursor(wxCursor& cursor);
104
105 //----------------------------------------------------------------------
106 // Miscellaneous functions
107
108 wxWindow * wxFindWindowByLabel(const wxString& label, wxWindow *parent=NULL);
109 wxWindow * wxFindWindowByName(const wxString& name, wxWindow *parent=NULL);
110
111 void wxBeginBusyCursor(wxCursor *cursor = wxHOURGLASS_CURSOR);
112 wxWindow * wxGetActiveWindow();
113
114
115 //---------------------------------------------------------------------------
116 // Resource System
117
118 bool wxResourceAddIdentifier(char *name, int value);
119 void wxResourceClear(void);
120 wxBitmap wxResourceCreateBitmap(char *resource);
121 wxIcon wxResourceCreateIcon(char *resource);
122 wxMenuBar * wxResourceCreateMenuBar(char *resource);
123 int wxResourceGetIdentifier(char *name);
124 bool wxResourceParseData(char *resource, wxResourceTable *table = NULL);
125 bool wxResourceParseFile(char *filename, wxResourceTable *table = NULL);
126 bool wxResourceParseString(char *resource, wxResourceTable *table = NULL);
127
128 //---------------------------------------------------------------------------
129 // System Settings
130
131 enum {
132 wxSYS_WHITE_BRUSH,
133 wxSYS_LTGRAY_BRUSH,
134 wxSYS_GRAY_BRUSH,
135 wxSYS_DKGRAY_BRUSH,
136 wxSYS_BLACK_BRUSH,
137 wxSYS_NULL_BRUSH,
138 wxSYS_HOLLOW_BRUSH,
139 wxSYS_WHITE_PEN,
140 wxSYS_BLACK_PEN,
141 wxSYS_NULL_PEN,
142 wxSYS_OEM_FIXED_FONT,
143 wxSYS_ANSI_FIXED_FONT,
144 wxSYS_ANSI_VAR_FONT,
145 wxSYS_SYSTEM_FONT,
146 wxSYS_DEVICE_DEFAULT_FONT,
147 wxSYS_DEFAULT_PALETTE,
148 wxSYS_SYSTEM_FIXED_FONT,
149 wxSYS_DEFAULT_GUI_FONT,
150
151 wxSYS_COLOUR_SCROLLBAR,
152 wxSYS_COLOUR_BACKGROUND,
153 wxSYS_COLOUR_ACTIVECAPTION,
154 wxSYS_COLOUR_INACTIVECAPTION,
155 wxSYS_COLOUR_MENU,
156 wxSYS_COLOUR_WINDOW,
157 wxSYS_COLOUR_WINDOWFRAME,
158 wxSYS_COLOUR_MENUTEXT,
159 wxSYS_COLOUR_WINDOWTEXT,
160 wxSYS_COLOUR_CAPTIONTEXT,
161 wxSYS_COLOUR_ACTIVEBORDER,
162 wxSYS_COLOUR_INACTIVEBORDER,
163 wxSYS_COLOUR_APPWORKSPACE,
164 wxSYS_COLOUR_HIGHLIGHT,
165 wxSYS_COLOUR_HIGHLIGHTTEXT,
166 wxSYS_COLOUR_BTNFACE,
167 wxSYS_COLOUR_BTNSHADOW,
168 wxSYS_COLOUR_GRAYTEXT,
169 wxSYS_COLOUR_BTNTEXT,
170 wxSYS_COLOUR_INACTIVECAPTIONTEXT,
171 wxSYS_COLOUR_BTNHIGHLIGHT,
172
173 wxSYS_COLOUR_3DDKSHADOW,
174 wxSYS_COLOUR_3DLIGHT,
175 wxSYS_COLOUR_INFOTEXT,
176 wxSYS_COLOUR_INFOBK,
177
178 wxSYS_COLOUR_DESKTOP,
179 wxSYS_COLOUR_3DFACE,
180 wxSYS_COLOUR_3DSHADOW,
181 wxSYS_COLOUR_3DHIGHLIGHT,
182 wxSYS_COLOUR_3DHILIGHT,
183 wxSYS_COLOUR_BTNHILIGHT,
184
185 wxSYS_MOUSE_BUTTONS,
186 wxSYS_BORDER_X,
187 wxSYS_BORDER_Y,
188 wxSYS_CURSOR_X,
189 wxSYS_CURSOR_Y,
190 wxSYS_DCLICK_X,
191 wxSYS_DCLICK_Y,
192 wxSYS_DRAG_X,
193 wxSYS_DRAG_Y,
194 wxSYS_EDGE_X,
195 wxSYS_EDGE_Y,
196 wxSYS_HSCROLL_ARROW_X,
197 wxSYS_HSCROLL_ARROW_Y,
198 wxSYS_HTHUMB_X,
199 wxSYS_ICON_X,
200 wxSYS_ICON_Y,
201 wxSYS_ICONSPACING_X,
202 wxSYS_ICONSPACING_Y,
203 wxSYS_WINDOWMIN_X,
204 wxSYS_WINDOWMIN_Y,
205 wxSYS_SCREEN_X,
206 wxSYS_SCREEN_Y,
207 wxSYS_FRAMESIZE_X,
208 wxSYS_FRAMESIZE_Y,
209 wxSYS_SMALLICON_X,
210 wxSYS_SMALLICON_Y,
211 wxSYS_HSCROLL_Y,
212 wxSYS_VSCROLL_X,
213 wxSYS_VSCROLL_ARROW_X,
214 wxSYS_VSCROLL_ARROW_Y,
215 wxSYS_VTHUMB_Y,
216 wxSYS_CAPTION_Y,
217 wxSYS_MENU_Y,
218 wxSYS_NETWORK_PRESENT,
219 wxSYS_PENWINDOWS_PRESENT,
220 wxSYS_SHOW_SOUNDS,
221 wxSYS_SWAP_BUTTONS,
222 };
223
224
225
226 %inline %{
227
228 wxColour wxSystemSettings_GetSystemColour(int index) {
229 return wxSystemSettings::GetSystemColour(index);
230 }
231
232 wxFont wxSystemSettings_GetSystemFont(int index) {
233 return wxSystemSettings::GetSystemFont(index);
234 }
235
236 int wxSystemSettings_GetSystemMetric(int index) {
237 return wxSystemSettings::GetSystemMetric(index);
238 }
239 %}
240
241 //---------------------------------------------------------------------------
242 // wxToolTip
243
244 class wxToolTip {
245 public:
246 wxToolTip(const wxString &tip);
247
248 void SetTip(const wxString& tip);
249 wxString GetTip();
250 // *** Not in the "public" interface void SetWindow(wxWindow *win);
251 wxWindow *GetWindow();
252 };
253
254
255 %inline %{
256 void wxToolTip_Enable(bool flag) {
257 wxToolTip::Enable(flag);
258 }
259
260 void wxToolTip_SetDelay(long milliseconds) {
261 wxToolTip::SetDelay(milliseconds);
262 }
263 %}
264
265 //----------------------------------------------------------------------
266
267 class wxCaret {
268 public:
269 wxCaret(wxWindow* window, const wxSize& size);
270 ~wxCaret();
271
272 bool IsOk();
273 bool IsVisible();
274 %name(GetPositionTuple)void GetPosition(int *OUTPUT, int *OUTPUT);
275 wxPoint GetPosition();
276 %name(GetSizeTuple)void GetSize(int *OUTPUT, int *OUTPUT);
277 wxSize GetSize();
278 wxWindow *GetWindow();
279 %name(MoveXY)void Move(int x, int y);
280 void Move(const wxPoint& pt);
281 %name(SetSizeWH) void SetSize(int width, int height);
282 void SetSize(const wxSize& size);
283 void Show(int show = TRUE);
284 void Hide();
285 };
286
287 %inline %{
288 int wxCaret_GetBlinkTime() {
289 return wxCaret::GetBlinkTime();
290 }
291
292 void wxCaret_SetBlinkTime(int milliseconds) {
293 wxCaret::SetBlinkTime(milliseconds);
294 }
295 %}
296
297 //----------------------------------------------------------------------
298
299 %{
300 class wxPyFontEnumerator : public wxFontEnumerator {
301 public:
302 wxPyFontEnumerator() {}
303 ~wxPyFontEnumerator() {}
304
305 DEC_PYCALLBACK_BOOL_STRING(OnFacename);
306 DEC_PYCALLBACK_BOOL_STRINGSTRING(OnFontEncoding);
307
308 PYPRIVATE;
309 };
310
311 IMP_PYCALLBACK_BOOL_STRING(wxPyFontEnumerator, wxFontEnumerator, OnFacename);
312 IMP_PYCALLBACK_BOOL_STRINGSTRING(wxPyFontEnumerator, wxFontEnumerator, OnFontEncoding);
313
314 %}
315
316 %name(wxFontEnumerator) class wxPyFontEnumerator {
317 public:
318 wxPyFontEnumerator();
319 ~wxPyFontEnumerator();
320 void _setSelf(PyObject* self, PyObject* _class);
321 %pragma(python) addtomethod = "__init__:self._setSelf(self, wxFontEnumerator)"
322
323 bool EnumerateFacenames(
324 wxFontEncoding encoding = wxFONTENCODING_SYSTEM, // all
325 bool fixedWidthOnly = FALSE);
326 bool EnumerateEncodings(const char* facename = "");
327
328 //wxArrayString* GetEncodings();
329 //wxArrayString* GetFacenames();
330 %addmethods {
331 PyObject* GetEncodings() {
332 wxArrayString* arr = self->GetEncodings();
333 PyObject* list = PyList_New(0);
334 for (size_t x=0; x<arr->GetCount(); x++)
335 PyList_Append(list, PyString_FromString((*arr)[x]));
336 return list;
337 }
338
339 PyObject* GetFacenames() {
340 wxArrayString* arr = self->GetFacenames();
341 PyObject* list = PyList_New(0);
342 for (size_t x=0; x<arr->GetCount(); x++)
343 PyList_Append(list, PyString_FromString((*arr)[x]));
344 return list;
345 }
346 }
347 };
348
349 //----------------------------------------------------------------------
350
351 class wxBusyCursor {
352 public:
353 wxBusyCursor(wxCursor* cursor = wxHOURGLASS_CURSOR);
354 ~wxBusyCursor();
355 };
356
357 //----------------------------------------------------------------------
358
359 class wxWindowDisabler {
360 public:
361 wxWindowDisabler(wxWindow *winToSkip = NULL);
362 ~wxWindowDisabler();
363 };
364
365 //----------------------------------------------------------------------
366
367 void wxPostEvent(wxEvtHandler *dest, wxEvent& event);
368 void wxWakeUpIdle();
369
370 bool wxSafeYield(wxWindow* win=NULL);
371
372 //----------------------------------------------------------------------
373
374
375 class wxTipProvider
376 {
377 public:
378 // wxTipProvider(size_t currentTip); **** Abstract base class
379 ~wxTipProvider();
380
381 virtual wxString GetTip() = 0;
382 size_t GetCurrentTip();
383
384 };
385
386
387 // The C++ version of wxPyTipProvider
388 %{
389 class wxPyTipProvider : public wxTipProvider {
390 public:
391 wxPyTipProvider(size_t currentTip)
392 : wxTipProvider(currentTip) {}
393
394 DEC_PYCALLBACK_STRING__pure(GetTip);
395
396 PYPRIVATE;
397 };
398
399 IMP_PYCALLBACK_STRING__pure( wxPyTipProvider, wxTipProvider, GetTip);
400
401 %}
402
403
404 // Now let SWIG know about it
405 class wxPyTipProvider : public wxTipProvider {
406 public:
407 wxPyTipProvider(size_t currentTip);
408 };
409
410
411
412 bool wxShowTip(wxWindow *parent, wxTipProvider *tipProvider, bool showAtStartup = TRUE);
413 %new wxTipProvider * wxCreateFileTipProvider(const wxString& filename, size_t currentTip);
414
415
416 //----------------------------------------------------------------------
417
418 %{
419 #include <wx/generic/dragimgg.h>
420 static wxPoint wxPyNullPoint;
421 %}
422
423 %name (wxDragImage) class wxGenericDragImage
424 {
425 public:
426
427 wxGenericDragImage(const wxBitmap& image,
428 const wxCursor& cursor = wxNullCursor,
429 const wxPoint& hotspot = wxPyNullPoint);
430 ~wxGenericDragImage();
431
432 bool BeginDrag(const wxPoint& hotspot, wxWindow* window,
433 bool fullScreen = FALSE, wxRect* rect = NULL);
434
435 %name(BeginDrag2) bool BeginDrag(const wxPoint& hotspot, wxWindow* window,
436 wxWindow* fullScreenRect);
437
438 bool EndDrag();
439 bool Move(const wxPoint& pt);
440 bool Show();
441 bool Hide();
442
443 wxRect GetImageRect(const wxPoint& pos) const;
444 bool RedrawImage(const wxPoint& oldPos, const wxPoint& newPos,
445 bool eraseOld, bool drawNew);
446 };
447
448
449 // Alternate Constructors
450 %new wxGenericDragImage* wxDragIcon(const wxIcon& image,
451 const wxCursor& cursor = wxNullCursor,
452 const wxPoint& hotspot = wxPyNullPoint);
453
454 %new wxGenericDragImage* wxDragString(const wxString& str,
455 const wxCursor& cursor = wxNullCursor,
456 const wxPoint& hotspot = wxPyNullPoint);
457
458 %new wxGenericDragImage* wxDragTreeItem(const wxTreeCtrl& treeCtrl, wxTreeItemId& id);
459
460 %new wxGenericDragImage* wxDragListItem(const wxListCtrl& listCtrl, long id);
461
462
463 %{
464
465 wxGenericDragImage* wxDragIcon(const wxIcon& image,
466 const wxCursor& cursor,
467 const wxPoint& hotspot) {
468 return new wxGenericDragImage(image, cursor, hotspot);
469 }
470
471 wxGenericDragImage* wxDragString(const wxString& str,
472 const wxCursor& cursor,
473 const wxPoint& hotspot) {
474 return new wxGenericDragImage(str, cursor, hotspot);
475 }
476
477 wxGenericDragImage* wxDragTreeItem(const wxTreeCtrl& treeCtrl, wxTreeItemId& id) {
478 return new wxGenericDragImage(treeCtrl, id);
479 }
480
481 wxGenericDragImage* wxDragListItem(const wxListCtrl& listCtrl, long id) {
482 return new wxGenericDragImage(listCtrl, id);
483 }
484
485 %}
486
487
488
489 //----------------------------------------------------------------------
490
491 class wxPyTimer {
492 public:
493 wxPyTimer(PyObject* notify);
494 ~wxPyTimer();
495 int GetInterval();
496 bool IsOneShot();
497 bool IsRunning();
498 void SetOwner(wxEvtHandler *owner, int id = -1);
499 void Start(int milliseconds=-1, int oneShot=FALSE);
500 void Stop();
501 };
502
503 //----------------------------------------------------------------------
504 //----------------------------------------------------------------------
505
506
507 enum
508 {
509 wxLOG_FatalError, // program can't continue, abort immediately
510 wxLOG_Error, // a serious error, user must be informed about it
511 wxLOG_Warning, // user is normally informed about it but may be ignored
512 wxLOG_Message, // normal message (i.e. normal output of a non GUI app)
513 wxLOG_Info, // informational message (a.k.a. 'Verbose')
514 wxLOG_Status, // informational: might go to the status line of GUI app
515 wxLOG_Debug, // never shown to the user, disabled in release mode
516 wxLOG_Trace, // trace messages are also only enabled in debug mode
517 wxLOG_Progress, // used for progress indicator (not yet)
518 wxLOG_User = 100 // user defined levels start here
519 };
520
521
522 class wxLog
523 {
524 public:
525 wxLog();
526
527 static bool IsEnabled();
528 static bool EnableLogging(bool doIt = TRUE);
529 static void OnLog(wxLogLevel level, const char *szString, int t=0);
530
531 virtual void Flush();
532 bool HasPendingMessages() const;
533
534 static void FlushActive();
535 static wxLog *GetActiveTarget();
536 static wxLog *SetActiveTarget(wxLog *pLogger);
537
538 static void Suspend();
539 static void Resume();
540
541 void SetVerbose(bool bVerbose = TRUE);
542
543 static void DontCreateOnDemand();
544 static void SetTraceMask(wxTraceMask ulMask);
545 static void AddTraceMask(const wxString& str);
546 static void RemoveTraceMask(const wxString& str);
547
548 bool GetVerbose() const { return m_bVerbose; }
549
550 static wxTraceMask GetTraceMask();
551 static bool IsAllowedTraceMask(const char *mask);
552
553 };
554
555
556 class wxLogStderr : public wxLog
557 {
558 public:
559 wxLogStderr(/* TODO: FILE *fp = (FILE *) NULL*/);
560 };
561
562
563 class wxLogTextCtrl : public wxLog
564 {
565 public:
566 wxLogTextCtrl(wxTextCtrl *pTextCtrl);
567 };
568
569
570 class wxLogGui : public wxLog
571 {
572 public:
573 wxLogGui();
574 };
575
576 class wxLogWindow : public wxLog
577 {
578 public:
579 wxLogWindow(wxFrame *pParent, // the parent frame (can be NULL)
580 const char *szTitle, // the title of the frame
581 bool bShow = TRUE, // show window immediately?
582 bool bPassToOld = TRUE); // pass log messages to the old target?
583
584 void Show(bool bShow = TRUE);
585 wxFrame *GetFrame() const;
586 wxLog *GetOldLog() const;
587 bool IsPassingMessages() const;
588 void PassMessages(bool bDoPass) { m_bPassMessages = bDoPass; }
589 };
590
591
592 class wxLogNull
593 {
594 public:
595 wxLogNull();
596 ~wxLogNull();
597 };
598
599
600 unsigned long wxSysErrorCode();
601 const char* wxSysErrorMsg(unsigned long nErrCode = 0);
602 void wxLogFatalError(const char *szFormat);
603 void wxLogError(const char *szFormat);
604 void wxLogWarning(const char *szFormat);
605 void wxLogMessage(const char *szFormat);
606 void wxLogInfo(const char *szFormat);
607 void wxLogVerbose(const char *szFormat);
608 void wxLogStatus(const char *szFormat);
609 %name(wxLogStatusFrame)void wxLogStatus(wxFrame *pFrame, const char *szFormat);
610 void wxLogSysError(const char *szFormat);
611
612
613
614 //----------------------------------------------------------------------
615
616 class wxProcessEvent : public wxEvent {
617 public:
618 wxProcessEvent(int id = 0, int pid = 0, int exitcode = 0);
619 int GetPid();
620 int GetExitCode();
621 int m_pid, m_exitcode;
622 };
623
624
625
626
627 %{ // C++ version of wxProcess derived class
628
629 class wxPyProcess : public wxProcess {
630 public:
631 wxPyProcess(wxEvtHandler *parent = NULL, int id = -1)
632 : wxProcess(parent, id)
633 {}
634
635 DEC_PYCALLBACK_VOID_INTINT(OnTerminate);
636
637 PYPRIVATE;
638 };
639
640 IMP_PYCALLBACK_VOID_INTINT( wxPyProcess, wxProcess, OnTerminate);
641 %}
642
643
644 %name(wxProcess)class wxPyProcess : public wxEvtHandler {
645 public:
646 wxPyProcess(wxEvtHandler *parent = NULL, int id = -1);
647 %addmethods { void Destroy() { delete self; } }
648
649 void _setSelf(PyObject* self, PyObject* _class);
650 %pragma(python) addtomethod = "__init__:self._setSelf(self, wxProcess)"
651
652 void base_OnTerminate(int pid, int status);
653
654 void Redirect();
655 bool IsRedirected();
656 void Detach();
657
658 wxInputStream *GetInputStream();
659 wxInputStream *GetErrorStream();
660 wxOutputStream *GetOutputStream();
661
662 void CloseOutput();
663 };
664
665
666
667 long wxExecute(const wxString& command,
668 int sync = FALSE,
669 wxPyProcess *process = NULL);
670
671 //----------------------------------------------------------------------
672
673 #ifdef __WXMSW__
674 class wxJoystick {
675 public:
676 wxJoystick(int joystick = wxJOYSTICK1);
677 wxPoint GetPosition();
678 int GetZPosition();
679 int GetButtonState();
680 int GetPOVPosition();
681 int GetPOVCTSPosition();
682 int GetRudderPosition();
683 int GetUPosition();
684 int GetVPosition();
685 int GetMovementThreshold();
686 void SetMovementThreshold(int threshold) ;
687
688 bool IsOk(void);
689 int GetNumberJoysticks();
690 int GetManufacturerId();
691 int GetProductId();
692 wxString GetProductName();
693 int GetXMin();
694 int GetYMin();
695 int GetZMin();
696 int GetXMax();
697 int GetYMax();
698 int GetZMax();
699 int GetNumberButtons();
700 int GetNumberAxes();
701 int GetMaxButtons();
702 int GetMaxAxes();
703 int GetPollingMin();
704 int GetPollingMax();
705 int GetRudderMin();
706 int GetRudderMax();
707 int GetUMin();
708 int GetUMax();
709 int GetVMin();
710 int GetVMax();
711
712 bool HasRudder();
713 bool HasZ();
714 bool HasU();
715 bool HasV();
716 bool HasPOV();
717 bool HasPOV4Dir();
718 bool HasPOVCTS();
719
720 bool SetCapture(wxWindow* win, int pollingFreq = 0);
721 bool ReleaseCapture();
722 };
723 #endif
724
725 //----------------------------------------------------------------------
726 //----------------------------------------------------------------------
727