widget/src/xpwidgets/nsBaseWidget.cpp

   1 /* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* ***** BEGIN LICENSE BLOCK *****
   3  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
   4  *
   5  * The contents of this file are subject to the Mozilla Public License Version
   6  * 1.1 (the "License"); you may not use this file except in compliance with
   7  * the License. You may obtain a copy of the License at
   8  * http://www.mozilla.org/MPL/
   9  *
  10  * Software distributed under the License is distributed on an "AS IS" basis,
  11  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
  12  * for the specific language governing rights and limitations under the
  13  * License.
  14  *
  15  * The Original Code is mozilla.org code.
  16  *
  17  * The Initial Developer of the Original Code is
  18  * Netscape Communications Corporation.
  19  * Portions created by the Initial Developer are Copyright (C) 1998
  20  * the Initial Developer. All Rights Reserved.
  21  *
  22  * Contributor(s):
  23  *   Dean Tessman <dean_tessman@hotmail.com>
  24  *
  25  * Alternatively, the contents of this file may be used under the terms of
  26  * either the GNU General Public License Version 2 or later (the "GPL"), or
  27  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
  28  * in which case the provisions of the GPL or the LGPL are applicable instead
  29  * of those above. If you wish to allow use of your version of this file only
  30  * under the terms of either the GPL or the LGPL, and not to allow others to
  31  * use your version of this file under the terms of the MPL, indicate your
  32  * decision by deleting the provisions above and replace them with the notice
  33  * and other provisions required by the GPL or the LGPL. If you do not delete
  34  * the provisions above, a recipient may use your version of this file under
  35  * the terms of any one of the MPL, the GPL or the LGPL.
  36  *
  37  * ***** END LICENSE BLOCK ***** */
  38
  39 #include "nsBaseWidget.h"
  40 #include "nsIDeviceContext.h"
  41 #include "nsCOMPtr.h"
  42 #include "nsGfxCIID.h"
  43 #include "nsWidgetsCID.h"
  44 #include "nsIFullScreen.h"
  45 #include "nsServiceManagerUtils.h"
  46 #include "nsIScreenManager.h"
  47 #include "nsAppDirectoryServiceDefs.h"
  48 #include "nsISimpleEnumerator.h"
  49 #include "nsIContent.h"
  50
  51 #ifdef DEBUG
  52 #include "nsIServiceManager.h"
  53 #include "nsIPrefService.h"
  54 #include "nsIPrefBranch2.h"
  55 #include "nsIObserver.h"
  56
  57 static void debug_RegisterPrefCallbacks();
  58
  59 static PRBool debug_InSecureKeyboardInputMode = PR_FALSE;
  60 #endif
  61
  62 #ifdef NOISY_WIDGET_LEAKS
  63 static PRInt32 gNumWidgets;
  64 #endif
  65
  66 nsIContent* nsBaseWidget::mLastRollup = nsnull;
  67
  68 // nsBaseWidget
  69 NS_IMPL_ISUPPORTS1(nsBaseWidget, nsIWidget)
  70
  71
  72 nsAutoRollup::nsAutoRollup()
  73 {
  74   // remember if mLastRollup was null, and only clear it upon destruction
  75   // if so. This prevents recursive usage of nsAutoRollup from clearing
  76   // mLastRollup when it shouldn't.
  77   wasClear = !nsBaseWidget::mLastRollup;
  78 }
  79
  80 nsAutoRollup::~nsAutoRollup()
  81 {
  82   if (nsBaseWidget::mLastRollup && wasClear) {
  83     NS_RELEASE(nsBaseWidget::mLastRollup);
  84   }
  85 }
  86
  87 //-------------------------------------------------------------------------
  88 //
  89 // nsBaseWidget constructor
  90 //
  91 //-------------------------------------------------------------------------
  92
  93 nsBaseWidget::nsBaseWidget()
  94 : mClientData(nsnull)
  95 , mEventCallback(nsnull)
  96 , mContext(nsnull)
  97 , mToolkit(nsnull)
  98 , mEventListener(nsnull)
  99 , mCursor(eCursor_standard)
 100 , mWindowType(eWindowType_child)
 101 , mBorderStyle(eBorderStyle_none)
 102 , mIsShiftDown(PR_FALSE)
 103 , mIsControlDown(PR_FALSE)
 104 , mIsAltDown(PR_FALSE)
 105 , mIsDestroying(PR_FALSE)
 106 , mOnDestroyCalled(PR_FALSE)
 107 , mBounds(0,0,0,0)
 108 , mOriginalBounds(nsnull)
 109 , mZIndex(0)
 110 , mSizeMode(nsSizeMode_Normal)
 111 {
 112 #ifdef NOISY_WIDGET_LEAKS
 113   gNumWidgets++;
 114   printf("WIDGETS+ = %d\n", gNumWidgets);
 115 #endif
 116
 117 #ifdef DEBUG
 118     debug_RegisterPrefCallbacks();
 119 #endif
 120 }
 121
 122
 123 //-------------------------------------------------------------------------
 124 //
 125 // nsBaseWidget destructor
 126 //
 127 //-------------------------------------------------------------------------
 128 nsBaseWidget::~nsBaseWidget()
 129 {
 130 #ifdef NOISY_WIDGET_LEAKS
 131   gNumWidgets--;
 132   printf("WIDGETS- = %d\n", gNumWidgets);
 133 #endif
 134
 135   NS_IF_RELEASE(mToolkit);
 136   NS_IF_RELEASE(mContext);
 137   if (mOriginalBounds)
 138     delete mOriginalBounds;
 139 }
 140
 141
 142 //-------------------------------------------------------------------------
 143 //
 144 // Basic create.
 145 //
 146 //-------------------------------------------------------------------------
 147 void nsBaseWidget::BaseCreate(nsIWidget *aParent,
 148                               const nsRect &aRect,
 149                               EVENT_CALLBACK aHandleEventFunction,
 150                               nsIDeviceContext *aContext,
 151                               nsIAppShell *aAppShell,
 152                               nsIToolkit *aToolkit,
 153                               nsWidgetInitData *aInitData)
 154 {
 155   if (nsnull == mToolkit) {
 156     if (nsnull != aToolkit) {
 157       mToolkit = (nsIToolkit*)aToolkit;
 158       NS_ADDREF(mToolkit);
 159     }
 160     else {
 161       if (nsnull != aParent) {
 162         mToolkit = aParent->GetToolkit();
 163         NS_IF_ADDREF(mToolkit);
 164       }
 165       // it's some top level window with no toolkit passed in.
 166       // Create a default toolkit with the current thread
 167 #if !defined(USE_TLS_FOR_TOOLKIT)
 168       else {
 169         static NS_DEFINE_CID(kToolkitCID, NS_TOOLKIT_CID);
 170
 171         nsresult res;
 172         res = CallCreateInstance(kToolkitCID, &mToolkit);
 173         NS_ASSERTION(NS_SUCCEEDED(res), "Can not create a toolkit in nsBaseWidget::Create");
 174         if (mToolkit)
 175           mToolkit->Init(PR_GetCurrentThread());
 176       }
 177 #else /* USE_TLS_FOR_TOOLKIT */
 178       else {
 179         nsresult rv;
 180
 181         rv = NS_GetCurrentToolkit(&mToolkit);
 182       }
 183 #endif /* USE_TLS_FOR_TOOLKIT */
 184     }
 185
 186   }
 187
 188   // save the event callback function
 189   mEventCallback = aHandleEventFunction;
 190
 191   // keep a reference to the device context
 192   if (aContext) {
 193     mContext = aContext;
 194     NS_ADDREF(mContext);
 195   }
 196   else {
 197     nsresult  res;
 198
 199     static NS_DEFINE_CID(kDeviceContextCID, NS_DEVICE_CONTEXT_CID);
 200
 201     res = CallCreateInstance(kDeviceContextCID, &mContext);
 202
 203     if (NS_SUCCEEDED(res))
 204       mContext->Init(nsnull);
 205   }
 206
 207   if (nsnull != aInitData) {
 208     PreCreateWidget(aInitData);
 209   }
 210
 211   if (aParent) {
 212     aParent->AddChild(this);
 213   }
 214 }
 215
 216 NS_IMETHODIMP nsBaseWidget::CaptureMouse(PRBool aCapture)
 217 {
 218   return NS_OK;
 219 }
 220
 221 NS_IMETHODIMP nsBaseWidget::Validate()
 222 {
 223   return NS_OK;
 224 }
 225
 226 NS_IMETHODIMP nsBaseWidget::InvalidateRegion(const nsIRegion *aRegion, PRBool aIsSynchronous)
 227 {
 228   return NS_ERROR_FAILURE;
 229 }
 230
 231 //-------------------------------------------------------------------------
 232 //
 233 // Accessor functions to get/set the client data
 234 //
 235 //-------------------------------------------------------------------------
 236
 237 NS_IMETHODIMP nsBaseWidget::GetClientData(void*& aClientData)
 238 {
 239   aClientData = mClientData;
 240   return NS_OK;
 241 }
 242
 243 NS_IMETHODIMP nsBaseWidget::SetClientData(void* aClientData)
 244 {
 245   mClientData = aClientData;
 246   return NS_OK;
 247 }
 248
 249 //-------------------------------------------------------------------------
 250 //
 251 // Close this nsBaseWidget
 252 //
 253 //-------------------------------------------------------------------------
 254 NS_METHOD nsBaseWidget::Destroy()
 255 {
 256   // Just in case our parent is the only ref to us
 257   nsCOMPtr<nsIWidget> kungFuDeathGrip(this);
 258
 259   // disconnect from the parent
 260   nsIWidget *parent = GetParent();
 261   if (parent) {
 262     parent->RemoveChild(this);
 263   }
 264   // disconnect listeners.
 265   NS_IF_RELEASE(mEventListener);
 266
 267   return NS_OK;
 268 }
 269
 270
 271 //-------------------------------------------------------------------------
 272 //
 273 // Set this nsBaseWidget's parent
 274 //
 275 //-------------------------------------------------------------------------
 276 NS_IMETHODIMP nsBaseWidget::SetParent(nsIWidget* aNewParent)
 277 {
 278   return NS_ERROR_NOT_IMPLEMENTED;
 279 }
 280
 281
 282 //-------------------------------------------------------------------------
 283 //
 284 // Get this nsBaseWidget parent
 285 //
 286 //-------------------------------------------------------------------------
 287 nsIWidget* nsBaseWidget::GetParent(void)
 288 {
 289   return nsnull;
 290 }
 291
 292 //-------------------------------------------------------------------------
 293 //
 294 // Get this nsBaseWidget top level widget
 295 //
 296 //-------------------------------------------------------------------------
 297 nsIWidget* nsBaseWidget::GetTopLevelWidget(PRInt32* aLevelsUp)
 298 {
 299   nsIWidget *topLevelWidget = nsnull, *widget = this;
 300   if (aLevelsUp)
 301     *aLevelsUp = -1;
 302   while (widget) {
 303     topLevelWidget = widget;
 304     widget = widget->GetParent();
 305     if (aLevelsUp)
 306       ++*aLevelsUp;
 307   }
 308   return topLevelWidget;
 309 }
 310
 311 //-------------------------------------------------------------------------
 312 //
 313 // Get this nsBaseWidget's top (non-sheet) parent (if it's a sheet)
 314 //
 315 //-------------------------------------------------------------------------
 316 nsIWidget* nsBaseWidget::GetSheetWindowParent(void)
 317 {
 318   return nsnull;
 319 }
 320
 321 //-------------------------------------------------------------------------
 322 //
 323 // Add a child to the list of children
 324 //
 325 //-------------------------------------------------------------------------
 326 void nsBaseWidget::AddChild(nsIWidget* aChild)
 327 {
 328   NS_PRECONDITION(!aChild->GetNextSibling() && !aChild->GetPrevSibling(),
 329                   "aChild not properly removed from its old child list");
 330
 331   if (!mFirstChild) {
 332     mFirstChild = mLastChild = aChild;
 333   } else {
 334     // append to the list
 335     NS_ASSERTION(mLastChild, "Bogus state");
 336     NS_ASSERTION(!mLastChild->GetNextSibling(), "Bogus state");
 337     mLastChild->SetNextSibling(aChild);
 338     aChild->SetPrevSibling(mLastChild);
 339     mLastChild = aChild;
 340   }
 341 }
 342
 343
 344 //-------------------------------------------------------------------------
 345 //
 346 // Remove a child from the list of children
 347 //
 348 //-------------------------------------------------------------------------
 349 void nsBaseWidget::RemoveChild(nsIWidget* aChild)
 350 {
 351   NS_ASSERTION(aChild->GetParent() == this, "Not one of our kids!");
 352
 353   if (mLastChild == aChild) {
 354     mLastChild = mLastChild->GetPrevSibling();
 355   }
 356   if (mFirstChild == aChild) {
 357     mFirstChild = mFirstChild->GetNextSibling();
 358   }
 359
 360   // Now remove from the list.  Make sure that we pass ownership of the tail
 361   // of the list correctly before we have aChild let go of it.
 362   nsIWidget* prev = aChild->GetPrevSibling();
 363   nsIWidget* next = aChild->GetNextSibling();
 364   if (prev) {
 365     prev->SetNextSibling(next);
 366   }
 367   if (next) {
 368     next->SetPrevSibling(prev);
 369   }
 370
 371   aChild->SetNextSibling(nsnull);
 372   aChild->SetPrevSibling(nsnull);
 373 }
 374
 375
 376 //-------------------------------------------------------------------------
 377 //
 378 // Sets widget's position within its parent's child list.
 379 //
 380 //-------------------------------------------------------------------------
 381 NS_IMETHODIMP nsBaseWidget::SetZIndex(PRInt32 aZIndex)
 382 {
 383   // Hold a ref to ourselves just in case, since we're going to remove
 384   // from our parent.
 385   nsCOMPtr<nsIWidget> kungFuDeathGrip(this);
 386
 387   mZIndex = aZIndex;
 388
 389   // reorder this child in its parent's list.
 390   nsBaseWidget* parent = static_cast<nsBaseWidget*>(GetParent());
 391   if (parent) {
 392     parent->RemoveChild(this);
 393     // Scope sib outside the for loop so we can check it afterward
 394     nsIWidget* sib = parent->GetFirstChild();
 395     for ( ; sib; sib = sib->GetNextSibling()) {
 396       PRInt32 childZIndex;
 397       if (NS_SUCCEEDED(sib->GetZIndex(&childZIndex))) {
 398         if (aZIndex < childZIndex) {
 399           // Insert ourselves before sib
 400           nsIWidget* prev = sib->GetPrevSibling();
 401           mNextSibling = sib;
 402           mPrevSibling = prev;
 403           sib->SetPrevSibling(this);
 404           if (prev) {
 405             prev->SetNextSibling(this);
 406           } else {
 407             NS_ASSERTION(sib == parent->mFirstChild, "Broken child list");
 408             // We've taken ownership of sib, so it's safe to have parent let
 409             // go of it
 410             parent->mFirstChild = this;
 411           }
 412           PlaceBehind(eZPlacementBelow, sib, PR_FALSE);
 413           break;
 414         }
 415       }
 416     }
 417     // were we added to the list?
 418     if (!sib) {
 419       parent->AddChild(this);
 420     }
 421   }
 422   return NS_OK;
 423 }
 424
 425 //-------------------------------------------------------------------------
 426 //
 427 // Gets widget's position within its parent's child list.
 428 //
 429 //-------------------------------------------------------------------------
 430 NS_IMETHODIMP nsBaseWidget::GetZIndex(PRInt32* aZIndex)
 431 {
 432   *aZIndex = mZIndex;
 433   return NS_OK;
 434 }
 435
 436 //-------------------------------------------------------------------------
 437 //
 438 // Places widget behind the given widget (platforms must override)
 439 //
 440 //-------------------------------------------------------------------------
 441 NS_IMETHODIMP nsBaseWidget::PlaceBehind(nsTopLevelWidgetZPlacement aPlacement,
 442                                         nsIWidget *aWidget, PRBool aActivate)
 443 {
 444   return NS_OK;
 445 }
 446
 447 //-------------------------------------------------------------------------
 448 //
 449 // Maximize, minimize or restore the window. The BaseWidget implementation
 450 // merely stores the state.
 451 //
 452 //-------------------------------------------------------------------------
 453 NS_IMETHODIMP nsBaseWidget::SetSizeMode(PRInt32 aMode) {
 454
 455   if (aMode == nsSizeMode_Normal || aMode == nsSizeMode_Minimized ||
 456       aMode == nsSizeMode_Maximized) {
 457
 458     mSizeMode = (nsSizeMode) aMode;
 459     return NS_OK;
 460   }
 461   return NS_ERROR_ILLEGAL_VALUE;
 462 }
 463
 464 //-------------------------------------------------------------------------
 465 //
 466 // Get the size mode (minimized, maximized, that sort of thing...)
 467 //
 468 //-------------------------------------------------------------------------
 469 NS_IMETHODIMP nsBaseWidget::GetSizeMode(PRInt32* aMode) {
 470
 471   *aMode = mSizeMode;
 472   return NS_OK;
 473 }
 474
 475 //-------------------------------------------------------------------------
 476 //
 477 // Get the foreground color
 478 //
 479 //-------------------------------------------------------------------------
 480 nscolor nsBaseWidget::GetForegroundColor(void)
 481 {
 482   return mForeground;
 483 }
 484
 485
 486 //-------------------------------------------------------------------------
 487 //
 488 // Set the foreground color
 489 //
 490 //-------------------------------------------------------------------------
 491 NS_METHOD nsBaseWidget::SetForegroundColor(const nscolor &aColor)
 492 {
 493   mForeground = aColor;
 494   return NS_OK;
 495 }
 496
 497
 498 //-------------------------------------------------------------------------
 499 //
 500 // Get the background color
 501 //
 502 //-------------------------------------------------------------------------
 503 nscolor nsBaseWidget::GetBackgroundColor(void)
 504 {
 505   return mBackground;
 506 }
 507
 508 //-------------------------------------------------------------------------
 509 //
 510 // Set the background color
 511 //
 512 //-------------------------------------------------------------------------
 513 NS_METHOD nsBaseWidget::SetBackgroundColor(const nscolor &aColor)
 514 {
 515   mBackground = aColor;
 516   return NS_OK;
 517 }
 518
 519 //-------------------------------------------------------------------------
 520 //
 521 // Get this component cursor
 522 //
 523 //-------------------------------------------------------------------------
 524 nsCursor nsBaseWidget::GetCursor()
 525 {
 526   return mCursor;
 527 }
 528
 529 NS_METHOD nsBaseWidget::SetCursor(nsCursor aCursor)
 530 {
 531   mCursor = aCursor;
 532   return NS_OK;
 533 }
 534
 535 NS_IMETHODIMP nsBaseWidget::SetCursor(imgIContainer* aCursor,
 536                                       PRUint32 aHotspotX, PRUint32 aHotspotY)
 537 {
 538   return NS_ERROR_NOT_IMPLEMENTED;
 539 }
 540
 541 //-------------------------------------------------------------------------
 542 //
 543 // Get the window type for this widget
 544 //
 545 //-------------------------------------------------------------------------
 546 NS_IMETHODIMP nsBaseWidget::GetWindowType(nsWindowType& aWindowType)
 547 {
 548   aWindowType = mWindowType;
 549   return NS_OK;
 550 }
 551
 552 NS_IMETHODIMP nsBaseWidget::SetWindowType(nsWindowType aWindowType)
 553 {
 554   mWindowType = aWindowType;
 555   return NS_OK;
 556 }
 557
 558 //-------------------------------------------------------------------------
 559 //
 560 // Window transparency methods
 561 //
 562 //-------------------------------------------------------------------------
 563
 564 void nsBaseWidget::SetTransparencyMode(nsTransparencyMode aMode) {
 565 }
 566
 567 nsTransparencyMode nsBaseWidget::GetTransparencyMode() {
 568   return eTransparencyOpaque;
 569 }
 570
 571 //-------------------------------------------------------------------------
 572 //
 573 // Set window shadow style
 574 //
 575 //-------------------------------------------------------------------------
 576
 577 NS_IMETHODIMP nsBaseWidget::SetWindowShadowStyle(PRInt32 aMode)
 578 {
 579   return NS_ERROR_NOT_IMPLEMENTED;
 580 }
 581
 582 //-------------------------------------------------------------------------
 583 //
 584 // Hide window borders/decorations for this widget
 585 //
 586 //-------------------------------------------------------------------------
 587 NS_IMETHODIMP nsBaseWidget::HideWindowChrome(PRBool aShouldHide)
 588 {
 589   return NS_ERROR_NOT_IMPLEMENTED;
 590 }
 591
 592 //-------------------------------------------------------------------------
 593 //
 594 // Put the window into full-screen mode
 595 //
 596 //-------------------------------------------------------------------------
 597 NS_IMETHODIMP nsBaseWidget::MakeFullScreen(PRBool aFullScreen)
 598 {
 599   HideWindowChrome(aFullScreen);
 600
 601   nsCOMPtr<nsIFullScreen> fullScreen = do_GetService("@mozilla.org/browser/fullscreen;1");
 602
 603   if (aFullScreen) {
 604     if (!mOriginalBounds)
 605       mOriginalBounds = new nsRect();
 606     GetScreenBounds(*mOriginalBounds);
 607
 608     // Move to top-left corner of screen and size to the screen dimensions
 609     nsCOMPtr<nsIScreenManager> screenManager;
 610     screenManager = do_GetService("@mozilla.org/gfx/screenmanager;1");
 611     NS_ASSERTION(screenManager, "Unable to grab screenManager.");
 612     if (screenManager) {
 613       nsCOMPtr<nsIScreen> screen;
 614       screenManager->ScreenForRect(mOriginalBounds->x, mOriginalBounds->y,
 615                                    mOriginalBounds->width, mOriginalBounds->height,
 616                                    getter_AddRefs(screen));
 617       if (screen) {
 618         PRInt32 left, top, width, height;
 619         if (NS_SUCCEEDED(screen->GetRect(&left, &top, &width, &height))) {
 620           SetSizeMode(nsSizeMode_Normal);
 621           Resize(left, top, width, height, PR_TRUE);
 622
 623           // Hide all of the OS chrome
 624           if (fullScreen)
 625             fullScreen->HideAllOSChrome();
 626         }
 627       }
 628     }
 629
 630   } else if (mOriginalBounds) {
 631     Resize(mOriginalBounds->x, mOriginalBounds->y, mOriginalBounds->width,
 632            mOriginalBounds->height, PR_TRUE);
 633
 634     // Show all of the OS chrome
 635     if (fullScreen)
 636       fullScreen->ShowAllOSChrome();
 637   }
 638
 639   return NS_OK;
 640 }
 641
 642 //-------------------------------------------------------------------------
 643 //
 644 // Create a rendering context from this nsBaseWidget
 645 //
 646 //-------------------------------------------------------------------------
 647 nsIRenderingContext* nsBaseWidget::GetRenderingContext()
 648 {
 649   nsresult                      rv;
 650   nsCOMPtr<nsIRenderingContext> renderingCtx;
 651
 652   if (mOnDestroyCalled)
 653     return nsnull;
 654
 655   rv = mContext->CreateRenderingContextInstance(*getter_AddRefs(renderingCtx));
 656   if (NS_SUCCEEDED(rv)) {
 657     gfxASurface* surface = GetThebesSurface();
 658     NS_ENSURE_TRUE(surface, nsnull);
 659     rv = renderingCtx->Init(mContext, surface);
 660     if (NS_SUCCEEDED(rv)) {
 661       nsIRenderingContext *ret = renderingCtx;
 662       /* Increment object refcount that the |ret| object is still a valid one
 663        * after we leave this function... */
 664       NS_ADDREF(ret);
 665       return ret;
 666     }
 667     else {
 668       NS_WARNING("GetRenderingContext: nsIRenderingContext::Init() failed.");
 669     }
 670   }
 671   else {
 672     NS_WARNING("GetRenderingContext: Cannot create RenderingContext.");
 673   }
 674
 675   return nsnull;
 676 }
 677
 678 //-------------------------------------------------------------------------
 679 //
 680 // Return the toolkit this widget was created on
 681 //
 682 //-------------------------------------------------------------------------
 683 nsIToolkit* nsBaseWidget::GetToolkit()
 684 {
 685   return mToolkit;
 686 }
 687
 688
 689 //-------------------------------------------------------------------------
 690 //
 691 // Return the used device context
 692 //
 693 //-------------------------------------------------------------------------
 694 nsIDeviceContext* nsBaseWidget::GetDeviceContext()
 695 {
 696   return mContext;
 697 }
 698
 699 //-------------------------------------------------------------------------
 700 //
 701 // Get the thebes surface
 702 //
 703 //-------------------------------------------------------------------------
 704 gfxASurface *nsBaseWidget::GetThebesSurface()
 705 {
 706   // in theory we should get our parent's surface,
 707   // clone it, and set a device offset before returning
 708   return nsnull;
 709 }
 710
 711
 712 //-------------------------------------------------------------------------
 713 //
 714 // Destroy the window
 715 //
 716 //-------------------------------------------------------------------------
 717 void nsBaseWidget::OnDestroy()
 718 {
 719   // release references to device context, toolkit, and app shell
 720   NS_IF_RELEASE(mContext);
 721   NS_IF_RELEASE(mToolkit);
 722 }
 723
 724 NS_METHOD nsBaseWidget::SetWindowClass(const nsAString& xulWinType)
 725 {
 726   return NS_ERROR_NOT_IMPLEMENTED;
 727 }
 728
 729 NS_METHOD nsBaseWidget::SetBorderStyle(nsBorderStyle aBorderStyle)
 730 {
 731   mBorderStyle = aBorderStyle;
 732   return NS_OK;
 733 }
 734
 735
 736 /**
 737 * Sets the event listener for a widget
 738 *
 739 **/
 740 NS_METHOD nsBaseWidget::AddEventListener(nsIEventListener * aListener)
 741 {
 742   NS_PRECONDITION(mEventListener == nsnull, "Null event listener");
 743   NS_IF_RELEASE(mEventListener);
 744   NS_ADDREF(aListener);
 745   mEventListener = aListener;
 746   return NS_OK;
 747 }
 748
 749 /**
 750 * If the implementation of nsWindow supports borders this method MUST be overridden
 751 *
 752 **/
 753 NS_METHOD nsBaseWidget::GetClientBounds(nsRect &aRect)
 754 {
 755   return GetBounds(aRect);
 756 }
 757
 758 /**
 759 * If the implementation of nsWindow supports borders this method MUST be overridden
 760 *
 761 **/
 762 NS_METHOD nsBaseWidget::GetBounds(nsRect &aRect)
 763 {
 764   aRect = mBounds;
 765   return NS_OK;
 766 }
 767
 768 /**
 769 * If the implementation of nsWindow uses a local coordinate system within the window,
 770 * this method must be overridden
 771 *
 772 **/
 773 NS_METHOD nsBaseWidget::GetScreenBounds(nsRect &aRect)
 774 {
 775   return GetBounds(aRect);
 776 }
 777
 778 /**
 779 *
 780 *
 781 **/
 782 NS_METHOD nsBaseWidget::SetBounds(const nsRect &aRect)
 783 {
 784   mBounds = aRect;
 785
 786   return NS_OK;
 787 }
 788
 789
 790
 791 /**
 792 * Calculates the border width and height
 793 *
 794 **/
 795 NS_METHOD nsBaseWidget::GetBorderSize(PRInt32 &aWidth, PRInt32 &aHeight)
 796 {
 797   nsRect rectWin;
 798   nsRect rect;
 799   GetBounds(rectWin);
 800   GetClientBounds(rect);
 801
 802   aWidth  = (rectWin.width - rect.width) / 2;
 803   aHeight = (rectWin.height - rect.height) / 2;
 804
 805   return NS_OK;
 806 }
 807
 808 NS_IMETHODIMP nsBaseWidget::ScrollWidgets(PRInt32 aDx, PRInt32 aDy)
 809 {
 810   return NS_ERROR_FAILURE;
 811 }
 812
 813 NS_IMETHODIMP nsBaseWidget::ScrollRect(nsRect &aRect, PRInt32 aDx, PRInt32 aDy)
 814 {
 815   return NS_ERROR_FAILURE;
 816 }
 817
 818 NS_METHOD nsBaseWidget::EnableDragDrop(PRBool aEnable)
 819 {
 820   return NS_OK;
 821 }
 822
 823 NS_METHOD nsBaseWidget::SetModal(PRBool aModal)
 824 {
 825   return NS_ERROR_FAILURE;
 826 }
 827
 828 // generic xp assumption is that events should be processed
 829 NS_METHOD nsBaseWidget::ModalEventFilter(PRBool aRealEvent, void *aEvent,
 830                             PRBool *aForWindow)
 831 {
 832   *aForWindow = PR_TRUE;
 833   return NS_OK;
 834 }
 835
 836 NS_IMETHODIMP
 837 nsBaseWidget::GetAttention(PRInt32 aCycleCount) {
 838     return NS_OK;
 839 }
 840
 841 NS_IMETHODIMP
 842 nsBaseWidget::GetLastInputEventTime(PRUint32& aTime) {
 843     return NS_ERROR_NOT_IMPLEMENTED;
 844 }
 845
 846 NS_IMETHODIMP
 847 nsBaseWidget::SetIcon(const nsAString&)
 848 {
 849   return NS_OK;
 850 }
 851
 852 NS_IMETHODIMP
 853 nsBaseWidget::BeginSecureKeyboardInput()
 854 {
 855 #ifdef DEBUG
 856   NS_ASSERTION(!debug_InSecureKeyboardInputMode, "Attempting to nest call to BeginSecureKeyboardInput!");
 857   debug_InSecureKeyboardInputMode = PR_TRUE;
 858 #endif
 859   return NS_OK;
 860 }
 861
 862 NS_IMETHODIMP
 863 nsBaseWidget::EndSecureKeyboardInput()
 864 {
 865 #ifdef DEBUG
 866   NS_ASSERTION(debug_InSecureKeyboardInputMode, "Calling EndSecureKeyboardInput when it hasn't been enabled!");
 867   debug_InSecureKeyboardInputMode = PR_FALSE;
 868 #endif
 869   return NS_OK;
 870 }
 871
 872 NS_IMETHODIMP
 873 nsBaseWidget::SetWindowTitlebarColor(nscolor aColor, PRBool aActive)
 874 {
 875   return NS_ERROR_NOT_IMPLEMENTED;
 876 }
 877
 878 PRBool
 879 nsBaseWidget::ShowsResizeIndicator(nsIntRect* aResizerRect)
 880 {
 881   return PR_FALSE;
 882 }
 883
 884
 885 /**
 886  * Modifies aFile to point at an icon file with the given name and suffix.  The
 887  * suffix may correspond to a file extension with leading '.' if appropriate.
 888  * Returns true if the icon file exists and can be read.
 889  */
 890 static PRBool
 891 ResolveIconNameHelper(nsILocalFile *aFile,
 892                       const nsAString &aIconName,
 893                       const nsAString &aIconSuffix)
 894 {
 895   aFile->Append(NS_LITERAL_STRING("icons"));
 896   aFile->Append(NS_LITERAL_STRING("default"));
 897   aFile->Append(aIconName + aIconSuffix);
 898
 899   PRBool readable;
 900   return NS_SUCCEEDED(aFile->IsReadable(&readable)) && readable;
 901 }
 902
 903 /**
 904  * Resolve the given icon name into a local file object.  This method is
 905  * intended to be called by subclasses of nsBaseWidget.  aIconSuffix is a
 906  * platform specific icon file suffix (e.g., ".ico" under Win32).
 907  *
 908  * If no file is found matching the given parameters, then null is returned.
 909  */
 910 void
 911 nsBaseWidget::ResolveIconName(const nsAString &aIconName,
 912                               const nsAString &aIconSuffix,
 913                               nsILocalFile **aResult)
 914 {
 915   *aResult = nsnull;
 916
 917   nsCOMPtr<nsIProperties> dirSvc = do_GetService(NS_DIRECTORY_SERVICE_CONTRACTID);
 918   if (!dirSvc)
 919     return;
 920
 921   // first check auxilary chrome directories
 922
 923   nsCOMPtr<nsISimpleEnumerator> dirs;
 924   dirSvc->Get(NS_APP_CHROME_DIR_LIST, NS_GET_IID(nsISimpleEnumerator),
 925               getter_AddRefs(dirs));
 926   if (dirs) {
 927     PRBool hasMore;
 928     while (NS_SUCCEEDED(dirs->HasMoreElements(&hasMore)) && hasMore) {
 929       nsCOMPtr<nsISupports> element;
 930       dirs->GetNext(getter_AddRefs(element));
 931       if (!element)
 932         continue;
 933       nsCOMPtr<nsILocalFile> file = do_QueryInterface(element);
 934       if (!file)
 935         continue;
 936       if (ResolveIconNameHelper(file, aIconName, aIconSuffix)) {
 937         NS_ADDREF(*aResult = file);
 938         return;
 939       }
 940     }
 941   }
 942
 943   // then check the main app chrome directory
 944
 945   nsCOMPtr<nsILocalFile> file;
 946   dirSvc->Get(NS_APP_CHROME_DIR, NS_GET_IID(nsILocalFile),
 947               getter_AddRefs(file));
 948   if (file && ResolveIconNameHelper(file, aIconName, aIconSuffix))
 949     NS_ADDREF(*aResult = file);
 950 }
 951
 952 NS_IMETHODIMP
 953 nsBaseWidget::BeginResizeDrag(nsGUIEvent* aEvent, PRInt32 aHorizontal, PRInt32 aVertical)
 954 {
 955   return NS_ERROR_NOT_IMPLEMENTED;
 956 }
 957
 958 #ifdef DEBUG
 959 //////////////////////////////////////////////////////////////
 960 //
 961 // Convert a GUI event message code to a string.
 962 // Makes it a lot easier to debug events.
 963 //
 964 // See gtk/nsWidget.cpp and windows/nsWindow.cpp
 965 // for a DebugPrintEvent() function that uses
 966 // this.
 967 //
 968 //////////////////////////////////////////////////////////////
 969 /* static */ nsAutoString
 970 nsBaseWidget::debug_GuiEventToString(nsGUIEvent * aGuiEvent)
 971 {
 972   NS_ASSERTION(nsnull != aGuiEvent,"cmon, null gui event.");
 973
 974   nsAutoString eventName(NS_LITERAL_STRING("UNKNOWN"));
 975
 976 #define _ASSIGN_eventName(_value,_name)\
 977 case _value: eventName.AssignWithConversion(_name) ; break
 978
 979   switch(aGuiEvent->message)
 980   {
 981     _ASSIGN_eventName(NS_BLUR_CONTENT,"NS_BLUR_CONTENT");
 982     _ASSIGN_eventName(NS_CONTROL_CHANGE,"NS_CONTROL_CHANGE");
 983     _ASSIGN_eventName(NS_CREATE,"NS_CREATE");
 984     _ASSIGN_eventName(NS_DESTROY,"NS_DESTROY");
 985     _ASSIGN_eventName(NS_DRAGDROP_GESTURE,"NS_DND_GESTURE");
 986     _ASSIGN_eventName(NS_DRAGDROP_DROP,"NS_DND_DROP");
 987     _ASSIGN_eventName(NS_DRAGDROP_ENTER,"NS_DND_ENTER");
 988     _ASSIGN_eventName(NS_DRAGDROP_EXIT,"NS_DND_EXIT");
 989     _ASSIGN_eventName(NS_DRAGDROP_OVER,"NS_DND_OVER");
 990     _ASSIGN_eventName(NS_FOCUS_CONTENT,"NS_FOCUS_CONTENT");
 991     _ASSIGN_eventName(NS_FORM_SELECTED,"NS_FORM_SELECTED");
 992     _ASSIGN_eventName(NS_FORM_CHANGE,"NS_FORM_CHANGE");
 993     _ASSIGN_eventName(NS_FORM_INPUT,"NS_FORM_INPUT");
 994     _ASSIGN_eventName(NS_FORM_RESET,"NS_FORM_RESET");
 995     _ASSIGN_eventName(NS_FORM_SUBMIT,"NS_FORM_SUBMIT");
 996     _ASSIGN_eventName(NS_GOTFOCUS,"NS_GOTFOCUS");
 997     _ASSIGN_eventName(NS_IMAGE_ABORT,"NS_IMAGE_ABORT");
 998     _ASSIGN_eventName(NS_LOAD_ERROR,"NS_LOAD_ERROR");
 999     _ASSIGN_eventName(NS_KEY_DOWN,"NS_KEY_DOWN");
1000     _ASSIGN_eventName(NS_KEY_PRESS,"NS_KEY_PRESS");
1001     _ASSIGN_eventName(NS_KEY_UP,"NS_KEY_UP");
1002     _ASSIGN_eventName(NS_LOSTFOCUS,"NS_LOSTFOCUS");
1003     _ASSIGN_eventName(NS_MENU_SELECTED,"NS_MENU_SELECTED");
1004     _ASSIGN_eventName(NS_MOUSE_ENTER,"NS_MOUSE_ENTER");
1005     _ASSIGN_eventName(NS_MOUSE_EXIT,"NS_MOUSE_EXIT");
1006     _ASSIGN_eventName(NS_MOUSE_BUTTON_DOWN,"NS_MOUSE_BUTTON_DOWN");
1007     _ASSIGN_eventName(NS_MOUSE_BUTTON_UP,"NS_MOUSE_BUTTON_UP");
1008     _ASSIGN_eventName(NS_MOUSE_CLICK,"NS_MOUSE_CLICK");
1009     _ASSIGN_eventName(NS_MOUSE_DOUBLECLICK,"NS_MOUSE_DBLCLICK");
1010     _ASSIGN_eventName(NS_MOUSE_MOVE,"NS_MOUSE_MOVE");
1011     _ASSIGN_eventName(NS_MOVE,"NS_MOVE");
1012     _ASSIGN_eventName(NS_LOAD,"NS_LOAD");
1013     _ASSIGN_eventName(NS_PAGE_UNLOAD,"NS_PAGE_UNLOAD");
1014     _ASSIGN_eventName(NS_PAINT,"NS_PAINT");
1015     _ASSIGN_eventName(NS_XUL_BROADCAST, "NS_XUL_BROADCAST");
1016     _ASSIGN_eventName(NS_XUL_COMMAND_UPDATE, "NS_XUL_COMMAND_UPDATE");
1017     _ASSIGN_eventName(NS_SCROLLBAR_LINE_NEXT,"NS_SB_LINE_NEXT");
1018     _ASSIGN_eventName(NS_SCROLLBAR_LINE_PREV,"NS_SB_LINE_PREV");
1019     _ASSIGN_eventName(NS_SCROLLBAR_PAGE_NEXT,"NS_SB_PAGE_NEXT");
1020     _ASSIGN_eventName(NS_SCROLLBAR_PAGE_PREV,"NS_SB_PAGE_PREV");
1021     _ASSIGN_eventName(NS_SCROLLBAR_POS,"NS_SB_POS");
1022     _ASSIGN_eventName(NS_SIZE,"NS_SIZE");
1023
1024 #undef _ASSIGN_eventName
1025
1026   default:
1027     {
1028       char buf[32];
1029
1030       sprintf(buf,"UNKNOWN: %d",aGuiEvent->message);
1031
1032       eventName.AssignWithConversion(buf);
1033     }
1034     break;
1035   }
1036
1037   return nsAutoString(eventName);
1038 }
1039 //////////////////////////////////////////////////////////////
1040 //
1041 // Code to deal with paint and event debug prefs.
1042 //
1043 //////////////////////////////////////////////////////////////
1044 struct PrefPair
1045 {
1046   const char * name;
1047   PRBool value;
1048 };
1049
1050 static PrefPair debug_PrefValues[] =
1051 {
1052   { "nglayout.debug.crossing_event_dumping", PR_FALSE },
1053   { "nglayout.debug.event_dumping", PR_FALSE },
1054   { "nglayout.debug.invalidate_dumping", PR_FALSE },
1055   { "nglayout.debug.motion_event_dumping", PR_FALSE },
1056   { "nglayout.debug.paint_dumping", PR_FALSE },
1057   { "nglayout.debug.paint_flashing", PR_FALSE }
1058 };
1059
1060 static PRUint32 debug_NumPrefValues =
1061   (sizeof(debug_PrefValues) / sizeof(debug_PrefValues[0]));
1062
1063
1064 //////////////////////////////////////////////////////////////
1065 static PRBool debug_GetBoolPref(nsIPrefBranch * aPrefs,const char * aPrefName)
1066 {
1067   NS_ASSERTION(nsnull != aPrefName,"cmon, pref name is null.");
1068   NS_ASSERTION(nsnull != aPrefs,"cmon, prefs are null.");
1069
1070   PRBool value = PR_FALSE;
1071
1072   if (aPrefs)
1073   {
1074     aPrefs->GetBoolPref(aPrefName,&value);
1075   }
1076
1077   return value;
1078 }
1079 //////////////////////////////////////////////////////////////
1080 PRBool
1081 nsBaseWidget::debug_GetCachedBoolPref(const char * aPrefName)
1082 {
1083   NS_ASSERTION(nsnull != aPrefName,"cmon, pref name is null.");
1084
1085   for (PRUint32 i = 0; i < debug_NumPrefValues; i++)
1086   {
1087     if (strcmp(debug_PrefValues[i].name, aPrefName) == 0)
1088     {
1089       return debug_PrefValues[i].value;
1090     }
1091   }
1092
1093   return PR_FALSE;
1094 }
1095 //////////////////////////////////////////////////////////////
1096 static void debug_SetCachedBoolPref(const char * aPrefName,PRBool aValue)
1097 {
1098   NS_ASSERTION(nsnull != aPrefName,"cmon, pref name is null.");
1099
1100   for (PRUint32 i = 0; i < debug_NumPrefValues; i++)
1101   {
1102     if (strcmp(debug_PrefValues[i].name, aPrefName) == 0)
1103     {
1104       debug_PrefValues[i].value = aValue;
1105
1106       return;
1107     }
1108   }
1109
1110   NS_ASSERTION(PR_FALSE, "cmon, this code is not reached dude.");
1111 }
1112
1113 //////////////////////////////////////////////////////////////
1114 class Debug_PrefObserver : public nsIObserver {
1115   public:
1116     NS_DECL_ISUPPORTS
1117     NS_DECL_NSIOBSERVER
1118 };
1119
1120 NS_IMPL_ISUPPORTS1(Debug_PrefObserver, nsIObserver)
1121
1122 NS_IMETHODIMP
1123 Debug_PrefObserver::Observe(nsISupports* subject, const char* topic,
1124                             const PRUnichar* data)
1125 {
1126   nsCOMPtr<nsIPrefBranch> branch(do_QueryInterface(subject));
1127   NS_ASSERTION(branch, "must implement nsIPrefBranch");
1128
1129   NS_ConvertUTF16toUTF8 prefName(data);
1130
1131   PRBool value = PR_FALSE;
1132   branch->GetBoolPref(prefName.get(), &value);
1133   debug_SetCachedBoolPref(prefName.get(), value);
1134   return NS_OK;
1135 }
1136
1137 //////////////////////////////////////////////////////////////
1138 /* static */ void
1139 debug_RegisterPrefCallbacks()
1140 {
1141   static PRBool once = PR_TRUE;
1142
1143   if (once)
1144   {
1145     once = PR_FALSE;
1146
1147     nsCOMPtr<nsIPrefBranch2> prefs(do_GetService(NS_PREFSERVICE_CONTRACTID));
1148
1149     NS_ASSERTION(prefs, "Prefs services is null.");
1150
1151     if (prefs)
1152     {
1153       nsCOMPtr<nsIObserver> obs(new Debug_PrefObserver());
1154       for (PRUint32 i = 0; i < debug_NumPrefValues; i++)
1155       {
1156         // Initialize the pref values
1157         debug_PrefValues[i].value =
1158           debug_GetBoolPref(prefs,debug_PrefValues[i].name);
1159
1160         if (obs) {
1161           // Register callbacks for when these change
1162           prefs->AddObserver(debug_PrefValues[i].name, obs, PR_FALSE);
1163         }
1164       }
1165     }
1166   }
1167 }
1168 //////////////////////////////////////////////////////////////
1169 static PRInt32
1170 _GetPrintCount()
1171 {
1172   static PRInt32 sCount = 0;
1173
1174   return ++sCount;
1175 }
1176 //////////////////////////////////////////////////////////////
1177 /* static */ PRBool
1178 nsBaseWidget::debug_WantPaintFlashing()
1179 {
1180   return debug_GetCachedBoolPref("nglayout.debug.paint_flashing");
1181 }
1182 //////////////////////////////////////////////////////////////
1183 /* static */ void
1184 nsBaseWidget::debug_DumpEvent(FILE *                aFileOut,
1185                               nsIWidget *           aWidget,
1186                               nsGUIEvent *          aGuiEvent,
1187                               const nsCAutoString & aWidgetName,
1188                               PRInt32               aWindowID)
1189 {
1190   // NS_PAINT is handled by debug_DumpPaintEvent()
1191   if (aGuiEvent->message == NS_PAINT)
1192     return;
1193
1194   if (aGuiEvent->message == NS_MOUSE_MOVE)
1195   {
1196     if (!debug_GetCachedBoolPref("nglayout.debug.motion_event_dumping"))
1197       return;
1198   }
1199
1200   if (aGuiEvent->message == NS_MOUSE_ENTER ||
1201       aGuiEvent->message == NS_MOUSE_EXIT)
1202   {
1203     if (!debug_GetCachedBoolPref("nglayout.debug.crossing_event_dumping"))
1204       return;
1205   }
1206
1207   if (!debug_GetCachedBoolPref("nglayout.debug.event_dumping"))
1208     return;
1209
1210   nsCAutoString tempString; tempString.AssignWithConversion(debug_GuiEventToString(aGuiEvent).get());
1211
1212   fprintf(aFileOut,
1213           "%4d %-26s widget=%-8p name=%-12s id=%-8p refpt=%d,%d\n",
1214           _GetPrintCount(),
1215           tempString.get(),
1216           (void *) aWidget,
1217           aWidgetName.get(),
1218           (void *) (aWindowID ? aWindowID : 0x0),
1219           aGuiEvent->refPoint.x,
1220           aGuiEvent->refPoint.y);
1221 }
1222 //////////////////////////////////////////////////////////////
1223 /* static */ void
1224 nsBaseWidget::debug_DumpPaintEvent(FILE *                aFileOut,
1225                                    nsIWidget *           aWidget,
1226                                    nsPaintEvent *        aPaintEvent,
1227                                    const nsCAutoString & aWidgetName,
1228                                    PRInt32               aWindowID)
1229 {
1230   NS_ASSERTION(nsnull != aFileOut,"cmon, null output FILE");
1231   NS_ASSERTION(nsnull != aWidget,"cmon, the widget is null");
1232   NS_ASSERTION(nsnull != aPaintEvent,"cmon, the paint event is null");
1233
1234   if (!debug_GetCachedBoolPref("nglayout.debug.paint_dumping"))
1235     return;
1236
1237   fprintf(aFileOut,
1238           "%4d PAINT      widget=%p name=%-12s id=%-8p rect=",
1239           _GetPrintCount(),
1240           (void *) aWidget,
1241           aWidgetName.get(),
1242           (void *) aWindowID);
1243
1244   if (aPaintEvent->rect)
1245   {
1246     fprintf(aFileOut,
1247             "%3d,%-3d %3d,%-3d",
1248             aPaintEvent->rect->x,
1249             aPaintEvent->rect->y,
1250             aPaintEvent->rect->width,
1251             aPaintEvent->rect->height);
1252   }
1253   else
1254   {
1255     fprintf(aFileOut,"none");
1256   }
1257
1258   fprintf(aFileOut,"\n");
1259 }
1260 //////////////////////////////////////////////////////////////
1261 /* static */ void
1262 nsBaseWidget::debug_DumpInvalidate(FILE *                aFileOut,
1263                                    nsIWidget *           aWidget,
1264                                    const nsRect *        aRect,
1265                                    PRBool                aIsSynchronous,
1266                                    const nsCAutoString & aWidgetName,
1267                                    PRInt32               aWindowID)
1268 {
1269   if (!debug_GetCachedBoolPref("nglayout.debug.invalidate_dumping"))
1270     return;
1271
1272   NS_ASSERTION(nsnull != aFileOut,"cmon, null output FILE");
1273   NS_ASSERTION(nsnull != aWidget,"cmon, the widget is null");
1274
1275   fprintf(aFileOut,
1276           "%4d Invalidate widget=%p name=%-12s id=%-8p",
1277           _GetPrintCount(),
1278           (void *) aWidget,
1279           aWidgetName.get(),
1280           (void *) aWindowID);
1281
1282   if (aRect)
1283   {
1284     fprintf(aFileOut,
1285             " rect=%3d,%-3d %3d,%-3d",
1286             aRect->x,
1287             aRect->y,
1288             aRect->width,
1289             aRect->height);
1290   }
1291   else
1292   {
1293     fprintf(aFileOut,
1294             " rect=%-15s",
1295             "none");
1296   }
1297
1298   fprintf(aFileOut,
1299           " sync=%s",
1300           (const char *) (aIsSynchronous ? "yes" : "no "));
1301
1302   fprintf(aFileOut,"\n");
1303 }
1304 //////////////////////////////////////////////////////////////
1305
1306 #endif // DEBUG
1307