Struct xpcom::interfaces::nsIHelperAppLauncherDialog

#[repr(C)]
pub struct nsIHelperAppLauncherDialog { /* fields omitted */ }

interface nsIHelperAppLauncherDialog : nsISupports

/**
 * This interface is used to display a confirmation dialog before
 * launching a "helper app" to handle content not handled by
 * Mozilla.
 *
 * Usage:  Clients (of which there is one: the nsIExternalHelperAppService
 * implementation in mozilla/uriloader/exthandler) create an instance of
 * this interface (using the contract ID) and then call the show() method.
 *
 * The dialog is shown non-modally.  The implementation of the dialog
 * will access methods of the nsIHelperAppLauncher passed in to show()
 * in order to cause a "save to disk" or "open using" action.
 */

Methods

impl nsIHelperAppLauncherDialog

pub fn coerce<T: nsIHelperAppLauncherDialogCoerce>(&self) -> &T

Cast this nsIHelperAppLauncherDialog to one of its base interfaces.

impl nsIHelperAppLauncherDialog

pub const REASON_CANTHANDLE: i64

REASON_CANTHANDLE: i64 = 0

/**
   * This request is passed to the helper app dialog because Gecko can not
   * handle content of this type.
   */

pub const REASON_SERVERREQUEST: i64

REASON_SERVERREQUEST: i64 = 1

/**
   * The server requested external handling.
   */

pub const REASON_TYPESNIFFED: i64

REASON_TYPESNIFFED: i64 = 2

/**
   * Gecko detected that the type sent by the server (e.g. text/plain) does
   * not match the actual type.
   */

pub unsafe fn Show(
    &self,
    aLauncher: *const nsIHelperAppLauncher,
    aWindowContext: *const nsISupports,
    aReason: uint32_t
) -> nsresult

/**
   * Show confirmation dialog for launching application (or "save to
   * disk") for content specified by aLauncher.
   *
   * @param aLauncher
   *        A nsIHelperAppLauncher to be invoked when a file is selected.
   * @param aWindowContext
   *        Window associated with action.
   * @param aReason
   *        One of the constants from above. It indicates why the dialog is
   *        shown. Implementors should treat unknown reasons like
   *        REASON_CANTHANDLE.
   */

void show (in nsIHelperAppLauncher aLauncher, in nsISupports aWindowContext, in unsigned long aReason);

pub unsafe fn PromptForSaveToFileAsync(
    &self,
    aLauncher: *const nsIHelperAppLauncher,
    aWindowContext: *const nsISupports,
    aDefaultFileName: *const int16_t,
    aSuggestedFileExtension: *const int16_t,
    aForcePrompt: bool
) -> nsresult

/**
   * Async invoke a save-to-file dialog instead of the full fledged helper app
   * dialog. When the file is chosen (or the dialog is closed), the callback
   * in aLauncher (aLauncher.saveDestinationAvailable) is called with the
   * selected file.
   *
   * @param aLauncher
   *        A nsIHelperAppLauncher to be invoked when a file is selected.
   * @param aWindowContext
   *        Window associated with action.
   * @param aDefaultFileName
   *        Default file name to provide (can be null)
   * @param aSuggestedFileExtension
   *        Sugested file extension
   * @param aForcePrompt
   *        Set to true to force prompting the user for thet file
   *        name/location, otherwise perferences may control if the user is
   *        prompted.
   */

void promptForSaveToFileAsync (in nsIHelperAppLauncher aLauncher, in nsISupports aWindowContext, in wstring aDefaultFileName, in wstring aSuggestedFileExtension, in boolean aForcePrompt);

Methods from Deref<Target = nsISupports>

pub fn coerce<T: nsISupportsCoerce>(&self) -> &T

Cast this nsISupports to one of its base interfaces.

pub unsafe fn QueryInterface(
    &self,
    uuid: &nsIID,
    result: *mut *mut c_void
) -> nsresult

void QueryInterface (in nsIIDRef uuid, [iid_is (uuid), retval] out nsQIResult result);

pub unsafe fn AddRef(&self) -> nsrefcnt

[noscript,notxpcom] nsrefcnt AddRef ();

pub unsafe fn Release(&self) -> nsrefcnt

[noscript,notxpcom] nsrefcnt Release ();

Trait Implementations

impl XpCom for nsIHelperAppLauncherDialog

const IID: nsIID

IID: nsIID = nsID(3217504755, 36213, 16436, [166, 248, 16, 57, 165, 153, 107, 173])

fn query_interface<T: XpCom>(&self) -> Option<RefPtr<T>>

Perform a QueryInterface call on this object, attempting to dynamically cast it to the requested interface type. Returns Some(RefPtr) if the cast succeeded, and None otherwise.

impl RefCounted for nsIHelperAppLauncherDialog

unsafe fn addref(&self)

Increment the reference count.

unsafe fn release(&self)

Decrement the reference count, potentially freeing backing memory.

impl Deref for nsIHelperAppLauncherDialog

type Target = nsISupports

The resulting type after dereferencing.

fn deref(&self) -> &nsISupports

Dereferences the value.