embedding/tests/os2Embed/WebBrowserChrome.cpp

   1 /* ***** BEGIN LICENSE BLOCK *****
   2  * Version: Mozilla-sample-code 1.0
   3  *
   4  * Copyright (c) 2002 Netscape Communications Corporation and
   5  * other contributors
   6  *
   7  * Permission is hereby granted, free of charge, to any person obtaining a
   8  * copy of this Mozilla sample software and associated documentation files
   9  * (the "Software"), to deal in the Software without restriction, including
  10  * without limitation the rights to use, copy, modify, merge, publish,
  11  * distribute, sublicense, and/or sell copies of the Software, and to permit
  12  * persons to whom the Software is furnished to do so, subject to the
  13  * following conditions:
  14  *
  15  * The above copyright notice and this permission notice shall be included
  16  * in all copies or substantial portions of the Software.
  17  *
  18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  19  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  21  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  22  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  23  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  24  * DEALINGS IN THE SOFTWARE.
  25  *
  26  * Contributor(s):
  27  *
  28  * ***** END LICENSE BLOCK ***** */
  29
  30 // Mozilla Includes
  31 #include "nsIGenericFactory.h"
  32 #include "nsIComponentManager.h"
  33 #include "nsString.h"
  34 #include "nsXPIDLString.h"
  35 #include "nsIURI.h"
  36 #include "nsIWebProgress.h"
  37 #include "nsIDocShellTreeItem.h"
  38 #include "nsIDOMWindow.h"
  39 #include "nsIDOMWindowInternal.h"
  40 #include "nsIInterfaceRequestor.h"
  41 #include "nsIInterfaceRequestorUtils.h"
  42 #include "nsIRequest.h"
  43 #include "nsIChannel.h"
  44 #include "nsCWebBrowser.h"
  45 #include "nsWidgetsCID.h"
  46 #include "nsIProfileChangeStatus.h"
  47 #include "nsCRT.h"
  48
  49 // Local includes
  50 #include "resource.h"
  51
  52 #include "os2Embed.h"
  53 #include "WebBrowserChrome.h"
  54
  55
  56 WebBrowserChrome::WebBrowserChrome()
  57 {
  58     mNativeWindow = nsnull;
  59     mSizeSet = PR_FALSE;
  60 }
  61
  62 WebBrowserChrome::~WebBrowserChrome()
  63 {
  64     WebBrowserChromeUI::Destroyed(this);
  65 }
  66
  67 nsresult WebBrowserChrome::CreateBrowser(PRInt32 aX, PRInt32 aY,
  68                                          PRInt32 aCX, PRInt32 aCY,
  69                                          nsIWebBrowser **aBrowser)
  70 {
  71     NS_ENSURE_ARG_POINTER(aBrowser);
  72     *aBrowser = nsnull;
  73
  74     mWebBrowser = do_CreateInstance(NS_WEBBROWSER_CONTRACTID);
  75
  76     if (!mWebBrowser)
  77         return NS_ERROR_FAILURE;
  78
  79     (void)mWebBrowser->SetContainerWindow(static_cast<nsIWebBrowserChrome*>(this));
  80
  81     nsCOMPtr<nsIDocShellTreeItem> dsti = do_QueryInterface(mWebBrowser);
  82     dsti->SetItemType(nsIDocShellTreeItem::typeContentWrapper);
  83
  84     nsCOMPtr<nsIBaseWindow> browserBaseWindow = do_QueryInterface(mWebBrowser);
  85
  86     mNativeWindow = WebBrowserChromeUI::CreateNativeWindow(static_cast<nsIWebBrowserChrome*>(this));
  87
  88     if (!mNativeWindow)
  89         return NS_ERROR_FAILURE;
  90
  91     browserBaseWindow->InitWindow( mNativeWindow,
  92                              nsnull,
  93                              aX, aY, aCX, aCY);
  94     browserBaseWindow->Create();
  95
  96     nsCOMPtr<nsIWebProgressListener> listener(static_cast<nsIWebProgressListener*>(this));
  97     nsCOMPtr<nsIWeakReference> thisListener(do_GetWeakReference(listener));
  98     (void)mWebBrowser->AddWebBrowserListener(thisListener,
  99         NS_GET_IID(nsIWebProgressListener));
 100
 101     // The window has been created. Now register for history notifications
 102     mWebBrowser->AddWebBrowserListener(thisListener, NS_GET_IID(nsISHistoryListener));
 103
 104     if (mWebBrowser)
 105     {
 106       *aBrowser = mWebBrowser;
 107       NS_ADDREF(*aBrowser);
 108       return NS_OK;
 109     }
 110     return NS_ERROR_FAILURE;
 111 }
 112
 113 //*****************************************************************************
 114 // WebBrowserChrome::nsISupports
 115 //*****************************************************************************
 116
 117 NS_IMPL_ADDREF(WebBrowserChrome)
 118 NS_IMPL_RELEASE(WebBrowserChrome)
 119
 120 NS_INTERFACE_MAP_BEGIN(WebBrowserChrome)
 121    NS_INTERFACE_MAP_ENTRY_AMBIGUOUS(nsISupports, nsIWebBrowserChrome)
 122    NS_INTERFACE_MAP_ENTRY(nsIInterfaceRequestor)
 123    NS_INTERFACE_MAP_ENTRY(nsIWebBrowserChrome)
 124    NS_INTERFACE_MAP_ENTRY(nsIEmbeddingSiteWindow)
 125    NS_INTERFACE_MAP_ENTRY(nsIWebProgressListener) // optional
 126    NS_INTERFACE_MAP_ENTRY(nsISHistoryListener)
 127    NS_INTERFACE_MAP_ENTRY(nsISupportsWeakReference)
 128    NS_INTERFACE_MAP_ENTRY(nsIObserver)
 129    NS_INTERFACE_MAP_ENTRY(nsIContextMenuListener)
 130    NS_INTERFACE_MAP_ENTRY(nsITooltipListener)
 131 NS_INTERFACE_MAP_END
 132
 133 //*****************************************************************************
 134 // WebBrowserChrome::nsIInterfaceRequestor
 135 //*****************************************************************************
 136
 137 NS_IMETHODIMP WebBrowserChrome::GetInterface(const nsIID &aIID, void** aInstancePtr)
 138 {
 139     NS_ENSURE_ARG_POINTER(aInstancePtr);
 140
 141     *aInstancePtr = 0;
 142     if (aIID.Equals(NS_GET_IID(nsIDOMWindow)))
 143     {
 144         if (mWebBrowser)
 145         {
 146             return mWebBrowser->GetContentDOMWindow((nsIDOMWindow **) aInstancePtr);
 147         }
 148         return NS_ERROR_NOT_INITIALIZED;
 149     }
 150     return QueryInterface(aIID, aInstancePtr);
 151 }
 152
 153 //*****************************************************************************
 154 // WebBrowserChrome::nsIWebBrowserChrome
 155 //*****************************************************************************
 156
 157 NS_IMETHODIMP WebBrowserChrome::SetStatus(PRUint32 aType, const PRUnichar* aStatus)
 158 {
 159     WebBrowserChromeUI::UpdateStatusBarText(this, aStatus);
 160     return NS_OK;
 161 }
 162
 163 NS_IMETHODIMP WebBrowserChrome::GetWebBrowser(nsIWebBrowser** aWebBrowser)
 164 {
 165     NS_ENSURE_ARG_POINTER(aWebBrowser);
 166     *aWebBrowser = mWebBrowser;
 167     NS_IF_ADDREF(*aWebBrowser);
 168     return NS_OK;
 169 }
 170
 171 NS_IMETHODIMP WebBrowserChrome::SetWebBrowser(nsIWebBrowser* aWebBrowser)
 172 {
 173     mWebBrowser = aWebBrowser;
 174     return NS_OK;
 175 }
 176
 177 NS_IMETHODIMP WebBrowserChrome::GetChromeFlags(PRUint32* aChromeMask)
 178 {
 179     *aChromeMask = mChromeFlags;
 180     return NS_OK;
 181 }
 182
 183 NS_IMETHODIMP WebBrowserChrome::SetChromeFlags(PRUint32 aChromeMask)
 184 {
 185     mChromeFlags = aChromeMask;
 186     return NS_OK;
 187 }
 188
 189 NS_IMETHODIMP WebBrowserChrome::DestroyBrowserWindow(void)
 190 {
 191     WebBrowserChromeUI::Destroy(this);
 192     return NS_OK;
 193 }
 194
 195
 196 // IN: The desired browser client area dimensions.
 197 NS_IMETHODIMP WebBrowserChrome::SizeBrowserTo(PRInt32 aWidth, PRInt32 aHeight)
 198 {
 199   /* This isn't exactly correct: we're setting the whole window to
 200      the size requested for the browser. At time of writing, though,
 201      it's fine and useful for os2Embed's purposes. */
 202   WebBrowserChromeUI::SizeTo(this, aWidth, aHeight);
 203   mSizeSet = PR_TRUE;
 204   return NS_OK;
 205 }
 206
 207
 208 NS_IMETHODIMP WebBrowserChrome::ShowAsModal(void)
 209 {
 210   if (mDependentParent)
 211     EnableChromeWindow(mDependentParent, PR_FALSE);
 212
 213   mContinueModalLoop = PR_TRUE;
 214   RunEventLoop(mContinueModalLoop);
 215
 216   if (mDependentParent)
 217     EnableChromeWindow(mDependentParent, PR_TRUE);
 218
 219   return NS_OK;
 220 }
 221
 222 NS_IMETHODIMP WebBrowserChrome::IsWindowModal(PRBool *_retval)
 223 {
 224     *_retval = PR_FALSE;
 225     return NS_ERROR_NOT_IMPLEMENTED;
 226 }
 227
 228 NS_IMETHODIMP WebBrowserChrome::ExitModalEventLoop(nsresult aStatus)
 229 {
 230   mContinueModalLoop = PR_FALSE;
 231   return NS_OK;
 232 }
 233
 234 //*****************************************************************************
 235 // WebBrowserChrome::nsIWebBrowserChromeFocus
 236 //*****************************************************************************
 237
 238 NS_IMETHODIMP WebBrowserChrome::FocusNextElement()
 239 {
 240     return NS_ERROR_NOT_IMPLEMENTED;
 241 }
 242
 243 NS_IMETHODIMP WebBrowserChrome::FocusPrevElement()
 244 {
 245     return NS_ERROR_NOT_IMPLEMENTED;
 246 }
 247
 248 //*****************************************************************************
 249 // WebBrowserChrome::nsIWebProgressListener
 250 //*****************************************************************************
 251
 252 NS_IMETHODIMP WebBrowserChrome::OnProgressChange(nsIWebProgress *progress, nsIRequest *request,
 253                                                   PRInt32 curSelfProgress, PRInt32 maxSelfProgress,
 254                                                   PRInt32 curTotalProgress, PRInt32 maxTotalProgress)
 255 {
 256     WebBrowserChromeUI::UpdateProgress(this, curTotalProgress, maxTotalProgress);
 257     return NS_OK;
 258 }
 259
 260 NS_IMETHODIMP WebBrowserChrome::OnStateChange(nsIWebProgress *progress, nsIRequest *request,
 261                                                PRUint32 progressStateFlags, nsresult status)
 262 {
 263     if ((progressStateFlags & STATE_START) && (progressStateFlags & STATE_IS_DOCUMENT))
 264     {
 265         WebBrowserChromeUI::UpdateBusyState(this, PR_TRUE);
 266     }
 267
 268     if ((progressStateFlags & STATE_STOP) && (progressStateFlags & STATE_IS_DOCUMENT))
 269     {
 270         WebBrowserChromeUI::UpdateBusyState(this, PR_FALSE);
 271         WebBrowserChromeUI::UpdateProgress(this, 0, 100);
 272         WebBrowserChromeUI::UpdateStatusBarText(this, nsnull);
 273         ContentFinishedLoading();
 274     }
 275
 276     return NS_OK;
 277 }
 278
 279
 280 NS_IMETHODIMP WebBrowserChrome::OnLocationChange(nsIWebProgress* aWebProgress,
 281                                                  nsIRequest* aRequest,
 282                                                  nsIURI *location)
 283 {
 284   PRBool isSubFrameLoad = PR_FALSE; // Is this a subframe load
 285   if (aWebProgress) {
 286     nsCOMPtr<nsIDOMWindow>  domWindow;
 287     nsCOMPtr<nsIDOMWindow>  topDomWindow;
 288     aWebProgress->GetDOMWindow(getter_AddRefs(domWindow));
 289     if (domWindow) { // Get root domWindow
 290       domWindow->GetTop(getter_AddRefs(topDomWindow));
 291     }
 292     if (domWindow != topDomWindow)
 293       isSubFrameLoad = PR_TRUE;
 294   }
 295   if (!isSubFrameLoad)
 296     WebBrowserChromeUI::UpdateCurrentURI(this);
 297   return NS_OK;
 298 }
 299
 300 NS_IMETHODIMP
 301 WebBrowserChrome::OnStatusChange(nsIWebProgress* aWebProgress,
 302                                  nsIRequest* aRequest,
 303                                  nsresult aStatus,
 304                                  const PRUnichar* aMessage)
 305 {
 306     WebBrowserChromeUI::UpdateStatusBarText(this, aMessage);
 307     return NS_OK;
 308 }
 309
 310
 311
 312 NS_IMETHODIMP
 313 WebBrowserChrome::OnSecurityChange(nsIWebProgress *aWebProgress,
 314                                     nsIRequest *aRequest,
 315                                     PRUint32 state)
 316 {
 317     return NS_OK;
 318 }
 319
 320 //*****************************************************************************
 321 // WebBrowserChrome::nsISHistoryListener
 322 //*****************************************************************************
 323
 324 NS_IMETHODIMP
 325 WebBrowserChrome::OnHistoryNewEntry(nsIURI * aNewURI)
 326 {
 327     return SendHistoryStatusMessage(aNewURI, "add");
 328 }
 329
 330 NS_IMETHODIMP
 331 WebBrowserChrome::OnHistoryGoBack(nsIURI * aBackURI, PRBool * aContinue)
 332 {
 333     // For now, let the operation continue
 334     *aContinue = PR_TRUE;
 335     return SendHistoryStatusMessage(aBackURI, "back");
 336 }
 337
 338
 339 NS_IMETHODIMP
 340 WebBrowserChrome::OnHistoryGoForward(nsIURI * aForwardURI, PRBool * aContinue)
 341 {
 342     // For now, let the operation continue
 343     *aContinue = PR_TRUE;
 344     return SendHistoryStatusMessage(aForwardURI, "forward");
 345 }
 346
 347
 348 NS_IMETHODIMP
 349 WebBrowserChrome::OnHistoryGotoIndex(PRInt32 aIndex, nsIURI * aGotoURI, PRBool * aContinue)
 350 {
 351     // For now, let the operation continue
 352     *aContinue = PR_TRUE;
 353     return SendHistoryStatusMessage(aGotoURI, "goto", aIndex);
 354 }
 355
 356 NS_IMETHODIMP
 357 WebBrowserChrome::OnHistoryReload(nsIURI * aURI, PRUint32 aReloadFlags, PRBool * aContinue)
 358 {
 359     // For now, let the operation continue
 360     *aContinue = PR_TRUE;
 361     return SendHistoryStatusMessage(aURI, "reload", 0 /* no info to pass here */, aReloadFlags);
 362 }
 363
 364 NS_IMETHODIMP
 365 WebBrowserChrome::OnHistoryPurge(PRInt32 aNumEntries, PRBool *aContinue)
 366 {
 367     // For now let the operation continue
 368     *aContinue = PR_FALSE;
 369     return SendHistoryStatusMessage(nsnull, "purge", aNumEntries);
 370 }
 371
 372 nsresult
 373 WebBrowserChrome::SendHistoryStatusMessage(nsIURI * aURI, char * operation, PRInt32 info1, PRUint32 aReloadFlags)
 374 {
 375     nsCAutoString uriCStr;
 376     if (aURI)
 377     {
 378         aURI->GetSpec(uriCStr);
 379     }
 380
 381     nsString uriAStr;
 382
 383     if(!(nsCRT::strcmp(operation, "back")))
 384     {
 385         // Going back. XXX Get string from a resource file
 386         uriAStr.AppendLiteral("Going back to url:");
 387         AppendUTF8toUTF16(uriCStr, uriAStr);
 388     }
 389     else if (!(nsCRT::strcmp(operation, "forward")))
 390     {
 391         // Going forward. XXX Get string from a resource file
 392         uriAStr.AppendLiteral("Going forward to url:");
 393         AppendUTF8toUTF16(uriCStr, uriAStr);
 394     }
 395     else if (!(nsCRT::strcmp(operation, "reload")))
 396     {
 397         // Reloading. XXX Get string from a resource file
 398         if (aReloadFlags & nsIWebNavigation::LOAD_FLAGS_BYPASS_PROXY &&
 399             aReloadFlags & nsIWebNavigation::LOAD_FLAGS_BYPASS_CACHE)
 400         {
 401             uriAStr.Append(NS_LITERAL_STRING("Reloading url,(bypassing proxy and cache) :"));
 402         }
 403         else if (aReloadFlags & nsIWebNavigation::LOAD_FLAGS_BYPASS_PROXY)
 404         {
 405             uriAStr.Append(NS_LITERAL_STRING("Reloading url, (bypassing proxy):"));
 406         }
 407         else if (aReloadFlags & nsIWebNavigation::LOAD_FLAGS_BYPASS_CACHE)
 408         {
 409             uriAStr.Append(NS_LITERAL_STRING("Reloading url, (bypassing cache):"));
 410         }
 411         else
 412         {
 413             uriAStr.Append(NS_LITERAL_STRING("Reloading url, (normal):"));
 414         }
 415         AppendUTF8toUTF16(uriCStr, uriAStr);
 416     }
 417     else if (!(nsCRT::strcmp(operation, "add")))
 418     {
 419         // Adding new entry. XXX Get string from a resource file
 420         AppendUTF8toUTF16(uriCStr, uriAStr);
 421         uriAStr.AppendLiteral(" added to session History");
 422     }
 423     else if (!(nsCRT::strcmp(operation, "goto")))
 424     {
 425         // Goto. XXX Get string from a resource file
 426         uriAStr.AppendLiteral("Going to HistoryIndex:");
 427         uriAStr.AppendInt(info1);
 428         uriAStr.AppendLiteral(" Url:");
 429         AppendUTF8toUTF16(uriCStr, uriAStr);
 430     }
 431     else if (!(nsCRT::strcmp(operation, "purge")))
 432     {
 433         // Purging old entries
 434         uriAStr.AppendInt(info1);
 435         uriAStr.AppendLiteral(" purged from Session History");
 436     }
 437
 438     WebBrowserChromeUI::UpdateStatusBarText(this, uriAStr.get());
 439
 440     return NS_OK;
 441 }
 442
 443 void WebBrowserChrome::ContentFinishedLoading()
 444 {
 445   // if it was a chrome window and no one has already specified a size,
 446   // size to content
 447   if (mWebBrowser && !mSizeSet &&
 448      (mChromeFlags & nsIWebBrowserChrome::CHROME_OPENAS_CHROME)) {
 449     nsCOMPtr<nsIDOMWindow> contentWin;
 450     mWebBrowser->GetContentDOMWindow(getter_AddRefs(contentWin));
 451     if (contentWin)
 452         contentWin->SizeToContent();
 453     WebBrowserChromeUI::ShowWindow(this, PR_TRUE);
 454   }
 455 }
 456
 457
 458 //*****************************************************************************
 459 // WebBrowserChrome::nsIEmbeddingSiteWindow
 460 //*****************************************************************************
 461
 462 NS_IMETHODIMP WebBrowserChrome::SetDimensions(PRUint32 aFlags, PRInt32 x, PRInt32 y, PRInt32 cx, PRInt32 cy)
 463 {
 464     return NS_ERROR_NOT_IMPLEMENTED;
 465 }
 466
 467 NS_IMETHODIMP WebBrowserChrome::GetDimensions(PRUint32 aFlags, PRInt32 *x, PRInt32 *y, PRInt32 *cx, PRInt32 *cy)
 468 {
 469     if (aFlags & nsIEmbeddingSiteWindow::DIM_FLAGS_POSITION)
 470     {
 471         *x = 0;
 472         *y = 0;
 473     }
 474     if (aFlags & nsIEmbeddingSiteWindow::DIM_FLAGS_SIZE_INNER ||
 475         aFlags & nsIEmbeddingSiteWindow::DIM_FLAGS_SIZE_OUTER)
 476     {
 477         *cx = 0;
 478         *cy = 0;
 479     }
 480     return NS_ERROR_NOT_IMPLEMENTED;
 481 }
 482
 483 /* void setFocus (); */
 484 NS_IMETHODIMP WebBrowserChrome::SetFocus()
 485 {
 486     WebBrowserChromeUI::SetFocus(this);
 487     return NS_OK;
 488 }
 489
 490 /* attribute wstring title; */
 491 NS_IMETHODIMP WebBrowserChrome::GetTitle(PRUnichar * *aTitle)
 492 {
 493    NS_ENSURE_ARG_POINTER(aTitle);
 494
 495    *aTitle = nsnull;
 496
 497    return NS_ERROR_NOT_IMPLEMENTED;
 498 }
 499 NS_IMETHODIMP WebBrowserChrome::SetTitle(const PRUnichar * aTitle)
 500 {
 501     return NS_ERROR_NOT_IMPLEMENTED;
 502 }
 503
 504 /* attribute boolean visibility; */
 505 NS_IMETHODIMP WebBrowserChrome::GetVisibility(PRBool * aVisibility)
 506 {
 507     NS_ENSURE_ARG_POINTER(aVisibility);
 508     *aVisibility = PR_TRUE;
 509     return NS_OK;
 510 }
 511 NS_IMETHODIMP WebBrowserChrome::SetVisibility(PRBool aVisibility)
 512 {
 513     return NS_OK;
 514 }
 515
 516 /* attribute nativeSiteWindow siteWindow */
 517 NS_IMETHODIMP WebBrowserChrome::GetSiteWindow(void * *aSiteWindow)
 518 {
 519    NS_ENSURE_ARG_POINTER(aSiteWindow);
 520
 521    *aSiteWindow = mNativeWindow;
 522    return NS_OK;
 523 }
 524
 525
 526 //*****************************************************************************
 527 // WebBrowserChrome::nsIObserver
 528 //*****************************************************************************
 529
 530 NS_IMETHODIMP WebBrowserChrome::Observe(nsISupports *aSubject, const char *aTopic, const PRUnichar *someData)
 531 {
 532     nsresult rv = NS_OK;
 533     if (nsCRT::strcmp(aTopic, "profile-change-teardown") == 0)
 534     {
 535         // A profile change means death for this window
 536         WebBrowserChromeUI::Destroy(this);
 537     }
 538     return rv;
 539 }
 540
 541 //*****************************************************************************
 542 // WebBrowserChrome::nsIContextMenuListener
 543 //*****************************************************************************
 544
 545 /* void OnShowContextMenu (in unsigned long aContextFlags, in nsIDOMEvent aEvent, in nsIDOMNode aNode); */
 546 NS_IMETHODIMP WebBrowserChrome::OnShowContextMenu(PRUint32 aContextFlags, nsIDOMEvent *aEvent, nsIDOMNode *aNode)
 547 {
 548     WebBrowserChromeUI::ShowContextMenu(this, aContextFlags, aEvent, aNode);
 549     return NS_OK;
 550 }
 551
 552 //*****************************************************************************
 553 // WebBrowserChrome::nsITooltipListener
 554 //*****************************************************************************
 555
 556 /* void OnShowTooltip (in long aXCoords, in long aYCoords, in wstring aTipText); */
 557 NS_IMETHODIMP WebBrowserChrome::OnShowTooltip(PRInt32 aXCoords, PRInt32 aYCoords, const PRUnichar *aTipText)
 558 {
 559     WebBrowserChromeUI::ShowTooltip(this, aXCoords, aYCoords, aTipText);
 560     return NS_OK;
 561 }
 562
 563 /* void OnHideTooltip (); */
 564 NS_IMETHODIMP WebBrowserChrome::OnHideTooltip()
 565 {
 566     WebBrowserChromeUI::HideTooltip(this);
 567     return NS_OK;
 568 }