|
1 /* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ |
|
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 "nsIURL.idl" |
|
7 |
|
8 interface nsIFile; |
|
9 |
|
10 /** |
|
11 * nsIFileURL provides access to the underlying nsIFile object corresponding to |
|
12 * an URL. The URL scheme need not be file:, since other local protocols may |
|
13 * map URLs to files (e.g., resource:). |
|
14 */ |
|
15 [scriptable, uuid(7750029c-1b0a-414e-8359-a77f24a2a0a6)] |
|
16 interface nsIFileURL : nsIURL |
|
17 { |
|
18 /** |
|
19 * Get/Set nsIFile corresponding to this URL. |
|
20 * |
|
21 * - Getter returns a reference to an immutable object. Callers must clone |
|
22 * before attempting to modify the returned nsIFile object. NOTE: this |
|
23 * constraint might not be enforced at runtime, so beware!! |
|
24 * |
|
25 * - Setter clones the nsIFile object (allowing the caller to safely modify |
|
26 * the nsIFile object after setting it on this interface). |
|
27 */ |
|
28 attribute nsIFile file; |
|
29 }; |