nsIMacShellService.idl (1708B)
1 /* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ 2 /* This Source Code Form is subject to the terms of the Mozilla Public 3 * License, v. 2.0. If a copy of the MPL was not distributed with this 4 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ 5 6 #include "nsIShellService.idl" 7 8 [scriptable, uuid(387fdc80-0077-4b60-a0d9-d9e80a83ba64)] 9 interface nsIMacShellService : nsIShellService 10 { 11 /** 12 * Opens the desktop preferences, e.g. for after setting the background. 13 */ 14 void showDesktopPreferences(); 15 16 /** 17 * @param aPaneID used by macOS to identify the pane to open. 18 * Example arguments: 19 * * "" - use the default Security and Privacy pane. 20 * * General 21 * * Privacy 22 * * Privacy_AllFiles 23 * * Privacy_Camera 24 * * Privacy_Microphone 25 */ 26 void showSecurityPreferences(in ACString aPaneID); 27 28 /* 29 * Searches for any available handlers for the given protocol and returns them in an 30 * array in the form [[displayName1, handlerPath1], [displayName2, handlerPath2], etc.] 31 * Can return an empty array if no handlers are found. 32 * 33 * @param protocol The protocol to search for handlers for (e.g. "http", "mailto" etc.) 34 * @return The full list of handler paths and names. 35 * 36 * @throws NS_ERROR_ILLEGAL_VALUE if the protocol cannot be resolved as a string. 37 * @throws NS_ERROR_MALFORMED_URI if the protocol cannot be resolved to a URI. 38 * @throws NS_ERROR_NOT_AVAILABLE if a list of handlers fails to generate. 39 */ 40 41 Array<Array<AString> > getAvailableApplicationsForProtocol(in ACString protocol); 42 };