pjs/xpfe/appshell/public/nsIInternetConfigService.idl

/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 *
 * The contents of this file are subject to the Netscape Public
 * License Version 1.1 (the "License"); you may not use this file
 * except in compliance with the License. You may obtain a copy of
 * the License at http://www.mozilla.org/NPL/
 *
 * Software distributed under the License is distributed on an "AS
 * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
 * implied. See the License for the specific language governing
 * rights and limitations under the License.
 *
 * The Original Code is Mozilla Communicator client code.
 *
 * The Initial Developer of the Original Code is Netscape Communications
 * Corporation.  Portions created by Netscape are
 * Copyright (C) 2000 Netscape Communications Corporation. All
 * Rights Reserved.
 *
 * Contributor(s): 
 */

#include "nsISupports.idl"

interface nsIMIMEInfo;
interface nsIURL;

%{C++

#include <Files.h>

#define NS_INTERNETCONFIGSERVICE_CONTRACTID \
"@mozilla.org/mac/internet-config-service;1"

%}

native FSSpec(FSSpec);
[ptr] native FSSpecPtr(FSSpec);

[scriptable, uuid(9B8B9D80-5F4F-11D4-9696-0060083A0BCF)]
interface nsIInternetConfigService : nsISupports
{
  const unsigned long eICColor_WebBackgroundColour = 1;
  const unsigned long eICColor_WebReadColor = 2;
  const unsigned long eICColor_WebTextColor = 3;
  const unsigned long eICColor_WebUnreadColor = 4;
  const unsigned long eICBoolean_WebUnderlineLinks = 11;
  const unsigned long eICString_WWWHomePage = 101;
  const unsigned long eICString_WebSearchPagePrefs = 102;
  const unsigned long eICString_MacSearchHost = 103;
  const unsigned long eICString_FTPHost = 121;
  const unsigned long eICBoolean_UsePassiveFTP = 122;
  const unsigned long eICBoolean_UseFTPProxy = 123;      const unsigned long eICString_FTPProxyUser = 124; 
  const unsigned long eICString_FTPProxyAccount = 125;   const unsigned long eICString_FTPProxyHost = 126;
  const unsigned long eICString_FTPProxyPassword = 127;
  const unsigned long eICBoolean_UseHTTPProxy = 130;     const unsigned long eICString_HTTPProxyHost = 131;
  const unsigned long eICString_LDAPSearchbase = 201;    const unsigned long eICString_LDAPServer = 202;
  const unsigned long eICString_SMTPHost = 221;
  const unsigned long eICString_Email = 222;
  const unsigned long eICString_MailAccount = 223;       const unsigned long eICString_MailPassword = 224;
  const unsigned long eICText_MailHeaders = 225;         const unsigned long eICText_Signature = 226;
  const unsigned long eICBoolean_NewMailDialog = 231;
  const unsigned long eICBoolean_NewMailFlashIcon = 232;
  const unsigned long eICBoolean_NewMailPlaySound = 233; const unsigned long eICString_NewMailSoundName = 234;
  const unsigned long eICString_NNTPHost = 241;
  const unsigned long eICString_NewsAuthUsername = 242;  const unsigned long eICString_NewsAuthPassword = 243;
  const unsigned long eICText_NewsHeaders = 244;
  const unsigned long eICString_InfoMacPreferred = 245;
  const unsigned long eICString_Organization = 251;      const unsigned long eICString_RealName = 252;
  const unsigned long eICText_SnailMailAddress = 253;
  const unsigned long eICString_QuotingString = 254;
  const unsigned long eICString_GopherHost = 301;
  const unsigned long eICBoolean_UseGopherProxy = 302;   const unsigned long eICString_GopherProxy = 303;
  const unsigned long eICBoolean_UseSocks = 321;         const unsigned long eICString_SocksHost = 322;
  const unsigned long eICString_TelnetHost = 331;
  const unsigned long eICString_IRCHost = 341;
  const unsigned long eICString_NTPHost = 351;
  const unsigned long eICString_WAISGateway = 381;
  const unsigned long eICString_FingerHost = 382;        const unsigned long eICText_Plan = 383;
  const unsigned long eICString_WhoisHost = 384;
  const unsigned long eICString_PhHost = 385;
  const unsigned long eICString_ArchiePreferred = 386;
  const unsigned long eICString_UMichPreferred = 391;

  const unsigned long eIICMapFlag_BinaryMask            = 1;  /* file should be transfered in binary as opposed to text mode*/
  const unsigned long eIICMapFlag_ResourceForkMask      = 2;  /* the resource fork of the file is significant*/
  const unsigned long eIICMapFlag_DataForkMask          = 4;  /* the data fork of the file is significant*/
  const unsigned long eIICMapFlag_PostMask              = 8;  /* post process using post fields*/
  const unsigned long eIICMapFlag_NotIncomingMask       = 16; /* ignore this mapping for incoming files*/
  const unsigned long eIICMapFlag_NotOutgoingMask       = 32; /* ignore this mapping for outgoing files*/


  void launchURL(in string url);
  
  boolean hasMappingForMIMEType(in string mimetype);
  
  boolean hasProtocolHandler(in string protocol);
  
  // pass in a mime type or a file extension.....
  void fillInMIMEInfo(in string mimetype, in string aFileExtension, out nsIMIMEInfo mimeinfo);
  
  void getMIMEInfoFromExtension(in string aFileExt, out nsIMIMEInfo mimeinfo);
  
  void getMIMEInfoFromTypeCreator(in PRUint32 aType, in PRUint32 aCreator, in string aFileExt, out nsIMIMEInfo mimeInfo);
  
  //Return a File Mapping for the specified file. If no mapping found, return -1.
  [noscript] long getFileMappingFlags(in FSSpecPtr fsspec, in boolean lookupByExtensionFirst);
  
  [noscript] void getDownloadFolder(out FSSpec fsspec);
  
  string getString(in unsigned long keyenum);

  unsigned long getColor(in unsigned long keyenum);

  boolean getBoolean(in unsigned long keyenum);
  
  wstring getText(in unsigned long keyenum, out unsigned long length);
};