webkit  2cdf99a9e3038c7e01b3c37e8ad903ecbe5eecf1
https://github.com/WebKit/webkit
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | List of all members
WebCore::Event Class Reference

#include <Event.h>

Inheritance diagram for WebCore::Event:
WebCore::ScriptWrappable WTF::RefCounted< Event > WebCore::ScriptWrappable WTF::RefCounted< Event > WTF::RefCountedBase WTF::RefCountedBase WTF::RefCountedBase WTF::RefCountedBase WTF::RefCountedBase WTF::RefCountedBase WebCore::AnimationEvent WebCore::AudioProcessingEvent WebCore::BeforeLoadEvent WebCore::BeforeTextInsertedEvent WebCore::BeforeUnloadEvent WebCore::ClipboardEvent WebCore::CloseEvent WebCore::CustomEvent WebCore::DeviceMotionEvent WebCore::DeviceOrientationEvent WebCore::ErrorEvent WebCore::HashChangeEvent WebCore::MessageEvent WebCore::MutationEvent WebCore::MutationEvent WebCore::OfflineAudioCompletionEvent WebCore::OverflowEvent WebCore::OverflowEvent WebCore::PageTransitionEvent WebCore::PopStateEvent WebCore::ProgressEvent WebCore::ProgressEvent WebCore::SecurityPolicyViolationEvent WebCore::StorageEvent WebCore::TransitionEvent WebCore::UIEvent WebCore::UIEvent WebCore::WebGLContextEvent WebCore::WebKitAnimationEvent WebCore::WebKitTransitionEvent

Public Types

enum  IsTrusted { IsTrusted::No, IsTrusted::Yes, IsTrusted::No, IsTrusted::Yes }
 
enum  PhaseType {
  NONE = 0, CAPTURING_PHASE = 1, AT_TARGET = 2, BUBBLING_PHASE = 3,
  NONE = 0, CAPTURING_PHASE = 1, AT_TARGET = 2, BUBBLING_PHASE = 3
}
 
enum  IsTrusted { IsTrusted::No, IsTrusted::Yes, IsTrusted::No, IsTrusted::Yes }
 
enum  PhaseType {
  NONE = 0, CAPTURING_PHASE = 1, AT_TARGET = 2, BUBBLING_PHASE = 3,
  NONE = 0, CAPTURING_PHASE = 1, AT_TARGET = 2, BUBBLING_PHASE = 3
}
 

Public Member Functions

virtual ~Event ()
 
WEBCORE_EXPORT void initEvent (const AtomicString &type, bool canBubble, bool cancelable)
 
bool isInitialized () const
 
const AtomicStringtype () const
 
void setType (const AtomicString &type)
 
EventTargettarget () const
 
void setTarget (RefPtr< EventTarget > &&)
 
EventTargetcurrentTarget () const
 
void setCurrentTarget (EventTarget *)
 
unsigned short eventPhase () const
 
void setEventPhase (unsigned short eventPhase)
 
bool bubbles () const
 
bool cancelable () const
 
WEBCORE_EXPORT bool composed () const
 
DOMTimeStamp timeStamp () const
 
void setEventPath (const EventPath &path)
 
void clearEventPath ()
 
Vector< EventTarget * > composedPath () const
 
void stopPropagation ()
 
void stopImmediatePropagation ()
 
bool isTrusted () const
 
void setUntrusted ()
 
EventTargetsrcElement () const
 
bool legacyReturnValue () const
 
void setLegacyReturnValue (bool returnValue)
 
virtual EventInterface eventInterface () const
 
virtual bool isUIEvent () const
 
virtual bool isMouseEvent () const
 
virtual bool isFocusEvent () const
 
virtual bool isKeyboardEvent () const
 
virtual bool isInputEvent () const
 
virtual bool isCompositionEvent () const
 
virtual bool isTouchEvent () const
 
virtual bool isClipboardEvent () const
 
virtual bool isBeforeTextInsertedEvent () const
 
virtual bool isBeforeUnloadEvent () const
 
virtual bool isErrorEvent () const
 
virtual bool isTextEvent () const
 
virtual bool isWheelEvent () const
 
bool propagationStopped () const
 
bool immediatePropagationStopped () const
 
void resetPropagationFlags ()
 
bool defaultPrevented () const
 
void preventDefault ()
 
void setDefaultPrevented (bool defaultPrevented)
 
bool defaultHandled () const
 
void setDefaultHandled ()
 
void setInPassiveListener (bool value)
 
bool cancelBubble () const
 
void setCancelBubble (bool)
 
EventunderlyingEvent () const
 
void setUnderlyingEvent (Event *)
 
bool isBeingDispatched () const
 
virtual EventTargetrelatedTarget () const
 
virtual ~Event ()
 
WEBCORE_EXPORT void initEvent (const AtomicString &type, bool canBubble, bool cancelable)
 
bool isInitialized () const
 
const AtomicStringtype () const
 
void setType (const AtomicString &type)
 
EventTargettarget () const
 
void setTarget (RefPtr< EventTarget > &&)
 
EventTargetcurrentTarget () const
 
void setCurrentTarget (EventTarget *)
 
unsigned short eventPhase () const
 
void setEventPhase (unsigned short eventPhase)
 
bool bubbles () const
 
bool cancelable () const
 
WEBCORE_EXPORT bool composed () const
 
DOMTimeStamp timeStamp () const
 
void setEventPath (const EventPath &path)
 
void clearEventPath ()
 
Vector< EventTarget * > composedPath () const
 
void stopPropagation ()
 
void stopImmediatePropagation ()
 
bool isTrusted () const
 
void setUntrusted ()
 
EventTargetsrcElement () const
 
bool legacyReturnValue () const
 
void setLegacyReturnValue (bool returnValue)
 
virtual EventInterface eventInterface () const
 
virtual bool isUIEvent () const
 
virtual bool isMouseEvent () const
 
virtual bool isFocusEvent () const
 
virtual bool isKeyboardEvent () const
 
virtual bool isInputEvent () const
 
virtual bool isCompositionEvent () const
 
virtual bool isTouchEvent () const
 
virtual bool isClipboardEvent () const
 
virtual bool isBeforeTextInsertedEvent () const
 
virtual bool isBeforeUnloadEvent () const
 
virtual bool isErrorEvent () const
 
virtual bool isTextEvent () const
 
virtual bool isWheelEvent () const
 
bool propagationStopped () const
 
bool immediatePropagationStopped () const
 
void resetPropagationFlags ()
 
bool defaultPrevented () const
 
void preventDefault ()
 
void setDefaultPrevented (bool defaultPrevented)
 
bool defaultHandled () const
 
void setDefaultHandled ()
 
void setInPassiveListener (bool value)
 
bool cancelBubble () const
 
void setCancelBubble (bool)
 
EventunderlyingEvent () const
 
void setUnderlyingEvent (Event *)
 
bool isBeingDispatched () const
 
virtual EventTargetrelatedTarget () const
 
- Public Member Functions inherited from WebCore::ScriptWrappable
JSDOMObjectwrapper () const
 
void setWrapper (JSDOMObject *, JSC::WeakHandleOwner *, void *)
 
void clearWrapper (JSDOMObject *)
 
JSDOMObjectwrapper () const
 
void setWrapper (JSDOMObject *, JSC::WeakHandleOwner *, void *)
 
void clearWrapper (JSDOMObject *)
 
- Public Member Functions inherited from WTF::RefCounted< Event >
void deref () const
 
void deref () const
 
void deref () const
 
- Public Member Functions inherited from WTF::RefCountedBase
void ref () const
 
bool hasOneRef () const
 
unsigned refCount () const
 
void relaxAdoptionRequirement ()
 
void ref () const
 
bool hasOneRef () const
 
unsigned refCount () const
 
void relaxAdoptionRequirement ()
 
void ref () const
 
bool hasOneRef () const
 
unsigned refCount () const
 
void relaxAdoptionRequirement ()
 

Static Public Member Functions

static Ref< Eventcreate (const AtomicString &type, bool canBubble, bool cancelable)
 
static Ref< EventcreateForBindings ()
 
static Ref< Eventcreate (const AtomicString &type, const EventInit &initializer, IsTrusted isTrusted=IsTrusted::No)
 
static Ref< Eventcreate (const AtomicString &type, bool canBubble, bool cancelable)
 
static Ref< EventcreateForBindings ()
 
static Ref< Eventcreate (const AtomicString &type, const EventInit &initializer, IsTrusted isTrusted=IsTrusted::No)
 
- Static Public Member Functions inherited from WebCore::ScriptWrappable
template<typename Derived >
static ptrdiff_t offsetOfWrapper ()
 
template<typename Derived >
static ptrdiff_t offsetOfWrapper ()
 

Protected Member Functions

 Event (IsTrusted=IsTrusted::No)
 
WEBCORE_EXPORT Event (const AtomicString &type, bool canBubble, bool cancelable)
 
 Event (const AtomicString &type, bool canBubble, bool cancelable, double timestamp)
 
 Event (const AtomicString &type, const EventInit &, IsTrusted)
 
virtual void receivedTarget ()
 
bool dispatched () const
 
 Event (IsTrusted=IsTrusted::No)
 
WEBCORE_EXPORT Event (const AtomicString &type, bool canBubble, bool cancelable)
 
 Event (const AtomicString &type, bool canBubble, bool cancelable, double timestamp)
 
 Event (const AtomicString &type, const EventInit &, IsTrusted)
 
virtual void receivedTarget ()
 
bool dispatched () const
 
- Protected Member Functions inherited from WebCore::ScriptWrappable
 ~ScriptWrappable ()
 
 ~ScriptWrappable ()
 
- Protected Member Functions inherited from WTF::RefCounted< Event >
 RefCounted ()
 
 RefCounted ()
 
 RefCounted ()
 
 ~RefCounted ()
 
 ~RefCounted ()
 
 ~RefCounted ()
 
- Protected Member Functions inherited from WTF::RefCountedBase
 RefCountedBase ()
 
 ~RefCountedBase ()
 
bool derefBase () const
 
bool deletionHasBegun () const
 
 RefCountedBase ()
 
 ~RefCountedBase ()
 
bool derefBase () const
 
bool deletionHasBegun () const
 
 RefCountedBase ()
 
 ~RefCountedBase ()
 
bool derefBase () const
 
bool deletionHasBegun () const
 

Member Enumeration Documentation

◆ IsTrusted [1/2]

Enumerator
No 
Yes 
No 
Yes 

◆ IsTrusted [2/2]

Enumerator
No 
Yes 
No 
Yes 

◆ PhaseType [1/2]

Enumerator
NONE 
CAPTURING_PHASE 
AT_TARGET 
BUBBLING_PHASE 
NONE 
CAPTURING_PHASE 
AT_TARGET 
BUBBLING_PHASE 

◆ PhaseType [2/2]

Enumerator
NONE 
CAPTURING_PHASE 
AT_TARGET 
BUBBLING_PHASE 
NONE 
CAPTURING_PHASE 
AT_TARGET 
BUBBLING_PHASE 

Constructor & Destructor Documentation

◆ ~Event() [1/2]

Event::~Event ( )
virtual

◆ Event() [1/8]

Event::Event ( IsTrusted  isTrusted = IsTrusted::No)
protected

◆ Event() [2/8]

Event::Event ( const AtomicString type,
bool  canBubble,
bool  cancelable 
)
protected

◆ Event() [3/8]

Event::Event ( const AtomicString type,
bool  canBubble,
bool  cancelable,
double  timestamp 
)
protected

◆ Event() [4/8]

Event::Event ( const AtomicString type,
const EventInit initializer,
IsTrusted  isTrusted 
)
protected

◆ ~Event() [2/2]

virtual WebCore::Event::~Event ( )
virtual

◆ Event() [5/8]

WebCore::Event::Event ( IsTrusted  = IsTrusted::No)
protected

◆ Event() [6/8]

WEBCORE_EXPORT WebCore::Event::Event ( const AtomicString type,
bool  canBubble,
bool  cancelable 
)
protected

◆ Event() [7/8]

WebCore::Event::Event ( const AtomicString type,
bool  canBubble,
bool  cancelable,
double  timestamp 
)
protected

◆ Event() [8/8]

WebCore::Event::Event ( const AtomicString type,
const EventInit ,
IsTrusted   
)
protected

Member Function Documentation

◆ bubbles() [1/2]

bool WebCore::Event::bubbles ( ) const
inline

◆ bubbles() [2/2]

bool WebCore::Event::bubbles ( ) const
inline

◆ cancelable() [1/2]

bool WebCore::Event::cancelable ( ) const
inline

◆ cancelable() [2/2]

bool WebCore::Event::cancelable ( ) const
inline

◆ cancelBubble() [1/2]

bool WebCore::Event::cancelBubble ( ) const
inline

◆ cancelBubble() [2/2]

bool WebCore::Event::cancelBubble ( ) const
inline

◆ clearEventPath() [1/2]

void WebCore::Event::clearEventPath ( )
inline

◆ clearEventPath() [2/2]

void WebCore::Event::clearEventPath ( )
inline

◆ composed() [1/2]

bool Event::composed ( ) const

◆ composed() [2/2]

WEBCORE_EXPORT bool WebCore::Event::composed ( ) const

◆ composedPath() [1/2]

Vector<EventTarget*> WebCore::Event::composedPath ( ) const

◆ composedPath() [2/2]

Vector< EventTarget * > Event::composedPath ( ) const

◆ create() [1/4]

static Ref<Event> WebCore::Event::create ( const AtomicString type,
bool  canBubble,
bool  cancelable 
)
inlinestatic

◆ create() [2/4]

static Ref<Event> WebCore::Event::create ( const AtomicString type,
bool  canBubble,
bool  cancelable 
)
inlinestatic

◆ create() [3/4]

static Ref<Event> WebCore::Event::create ( const AtomicString type,
const EventInit initializer,
IsTrusted  isTrusted = IsTrusted::No 
)
inlinestatic

◆ create() [4/4]

static Ref<Event> WebCore::Event::create ( const AtomicString type,
const EventInit initializer,
IsTrusted  isTrusted = IsTrusted::No 
)
inlinestatic

◆ createForBindings() [1/2]

static Ref<Event> WebCore::Event::createForBindings ( )
inlinestatic

◆ createForBindings() [2/2]

static Ref<Event> WebCore::Event::createForBindings ( )
inlinestatic

◆ currentTarget() [1/2]

EventTarget* WebCore::Event::currentTarget ( ) const
inline

◆ currentTarget() [2/2]

EventTarget* WebCore::Event::currentTarget ( ) const
inline

◆ defaultHandled() [1/2]

bool WebCore::Event::defaultHandled ( ) const
inline

◆ defaultHandled() [2/2]

bool WebCore::Event::defaultHandled ( ) const
inline

◆ defaultPrevented() [1/2]

bool WebCore::Event::defaultPrevented ( ) const
inline

◆ defaultPrevented() [2/2]

bool WebCore::Event::defaultPrevented ( ) const
inline

◆ dispatched() [1/2]

bool WebCore::Event::dispatched ( ) const
inlineprotected

◆ dispatched() [2/2]

bool WebCore::Event::dispatched ( ) const
inlineprotected

◆ eventInterface() [1/2]

virtual EventInterface WebCore::Event::eventInterface ( ) const
virtual

◆ eventInterface() [2/2]

EventInterface Event::eventInterface ( ) const
virtual

◆ eventPhase() [1/2]

unsigned short WebCore::Event::eventPhase ( ) const
inline

◆ eventPhase() [2/2]

unsigned short WebCore::Event::eventPhase ( ) const
inline

◆ immediatePropagationStopped() [1/2]

bool WebCore::Event::immediatePropagationStopped ( ) const
inline

◆ immediatePropagationStopped() [2/2]

bool WebCore::Event::immediatePropagationStopped ( ) const
inline

◆ initEvent() [1/2]

void Event::initEvent ( const AtomicString type,
bool  canBubble,
bool  cancelable 
)

◆ initEvent() [2/2]

WEBCORE_EXPORT void WebCore::Event::initEvent ( const AtomicString type,
bool  canBubble,
bool  cancelable 
)

◆ isBeforeTextInsertedEvent() [1/2]

bool Event::isBeforeTextInsertedEvent ( ) const
virtual

◆ isBeforeTextInsertedEvent() [2/2]

virtual bool WebCore::Event::isBeforeTextInsertedEvent ( ) const
virtual

◆ isBeforeUnloadEvent() [1/2]

bool Event::isBeforeUnloadEvent ( ) const
virtual

◆ isBeforeUnloadEvent() [2/2]

virtual bool WebCore::Event::isBeforeUnloadEvent ( ) const
virtual

◆ isBeingDispatched() [1/2]

bool WebCore::Event::isBeingDispatched ( ) const
inline

◆ isBeingDispatched() [2/2]

bool WebCore::Event::isBeingDispatched ( ) const
inline

◆ isClipboardEvent() [1/2]

bool Event::isClipboardEvent ( ) const
virtual

◆ isClipboardEvent() [2/2]

virtual bool WebCore::Event::isClipboardEvent ( ) const
virtual

◆ isCompositionEvent() [1/2]

bool Event::isCompositionEvent ( ) const
virtual

◆ isCompositionEvent() [2/2]

virtual bool WebCore::Event::isCompositionEvent ( ) const
virtual

◆ isErrorEvent() [1/2]

bool Event::isErrorEvent ( ) const
virtual

◆ isErrorEvent() [2/2]

virtual bool WebCore::Event::isErrorEvent ( ) const
virtual

◆ isFocusEvent() [1/2]

virtual bool WebCore::Event::isFocusEvent ( ) const
virtual

◆ isFocusEvent() [2/2]

bool Event::isFocusEvent ( ) const
virtual

◆ isInitialized() [1/2]

bool WebCore::Event::isInitialized ( ) const
inline

◆ isInitialized() [2/2]

bool WebCore::Event::isInitialized ( ) const
inline

◆ isInputEvent() [1/2]

bool Event::isInputEvent ( ) const
virtual

Reimplemented in WebCore::InputEvent, and WebCore::InputEvent.

◆ isInputEvent() [2/2]

virtual bool WebCore::Event::isInputEvent ( ) const
virtual

Reimplemented in WebCore::InputEvent, and WebCore::InputEvent.

◆ isKeyboardEvent() [1/2]

bool Event::isKeyboardEvent ( ) const
virtual

◆ isKeyboardEvent() [2/2]

virtual bool WebCore::Event::isKeyboardEvent ( ) const
virtual

◆ isMouseEvent() [1/2]

virtual bool WebCore::Event::isMouseEvent ( ) const
virtual

◆ isMouseEvent() [2/2]

bool Event::isMouseEvent ( ) const
virtual

◆ isTextEvent() [1/2]

bool Event::isTextEvent ( ) const
virtual

◆ isTextEvent() [2/2]

virtual bool WebCore::Event::isTextEvent ( ) const
virtual

◆ isTouchEvent() [1/2]

bool Event::isTouchEvent ( ) const
virtual

◆ isTouchEvent() [2/2]

virtual bool WebCore::Event::isTouchEvent ( ) const
virtual

◆ isTrusted() [1/2]

bool WebCore::Event::isTrusted ( ) const
inline

◆ isTrusted() [2/2]

bool WebCore::Event::isTrusted ( ) const
inline

◆ isUIEvent() [1/2]

bool Event::isUIEvent ( ) const
virtual

◆ isUIEvent() [2/2]

virtual bool WebCore::Event::isUIEvent ( ) const
virtual

◆ isWheelEvent() [1/2]

virtual bool WebCore::Event::isWheelEvent ( ) const
virtual

◆ isWheelEvent() [2/2]

bool Event::isWheelEvent ( ) const
virtual

◆ legacyReturnValue() [1/2]

bool WebCore::Event::legacyReturnValue ( ) const
inline

◆ legacyReturnValue() [2/2]

bool WebCore::Event::legacyReturnValue ( ) const
inline

◆ preventDefault() [1/2]

void WebCore::Event::preventDefault ( )
inline

◆ preventDefault() [2/2]

void WebCore::Event::preventDefault ( )
inline

◆ propagationStopped() [1/2]

bool WebCore::Event::propagationStopped ( ) const
inline

◆ propagationStopped() [2/2]

bool WebCore::Event::propagationStopped ( ) const
inline

◆ receivedTarget() [1/2]

void Event::receivedTarget ( )
protectedvirtual

◆ receivedTarget() [2/2]

virtual void WebCore::Event::receivedTarget ( )
protectedvirtual

◆ relatedTarget() [1/2]

virtual EventTarget* WebCore::Event::relatedTarget ( ) const
inlinevirtual

◆ relatedTarget() [2/2]

virtual EventTarget* WebCore::Event::relatedTarget ( ) const
inlinevirtual

◆ resetPropagationFlags() [1/2]

void Event::resetPropagationFlags ( )
inline

◆ resetPropagationFlags() [2/2]

void WebCore::Event::resetPropagationFlags ( )

◆ setCancelBubble() [1/2]

void Event::setCancelBubble ( bool  cancel)
inline

◆ setCancelBubble() [2/2]

void WebCore::Event::setCancelBubble ( bool  )

◆ setCurrentTarget() [1/2]

void WebCore::Event::setCurrentTarget ( EventTarget )

◆ setCurrentTarget() [2/2]

void Event::setCurrentTarget ( EventTarget currentTarget)

◆ setDefaultHandled() [1/2]

void WebCore::Event::setDefaultHandled ( )
inline

◆ setDefaultHandled() [2/2]

void WebCore::Event::setDefaultHandled ( )
inline

◆ setDefaultPrevented() [1/2]

void WebCore::Event::setDefaultPrevented ( bool  defaultPrevented)
inline

◆ setDefaultPrevented() [2/2]

void WebCore::Event::setDefaultPrevented ( bool  defaultPrevented)
inline

◆ setEventPath() [1/2]

void WebCore::Event::setEventPath ( const EventPath path)
inline

◆ setEventPath() [2/2]

void WebCore::Event::setEventPath ( const EventPath path)
inline

◆ setEventPhase() [1/2]

void WebCore::Event::setEventPhase ( unsigned short  eventPhase)
inline

◆ setEventPhase() [2/2]

void WebCore::Event::setEventPhase ( unsigned short  eventPhase)
inline

◆ setInPassiveListener() [1/2]

void WebCore::Event::setInPassiveListener ( bool  value)
inline

◆ setInPassiveListener() [2/2]

void WebCore::Event::setInPassiveListener ( bool  value)
inline

◆ setLegacyReturnValue() [1/2]

void WebCore::Event::setLegacyReturnValue ( bool  returnValue)
inline

◆ setLegacyReturnValue() [2/2]

void WebCore::Event::setLegacyReturnValue ( bool  returnValue)
inline

◆ setTarget() [1/2]

void WebCore::Event::setTarget ( RefPtr< EventTarget > &&  )

◆ setTarget() [2/2]

void Event::setTarget ( RefPtr< EventTarget > &&  target)

◆ setType() [1/2]

void WebCore::Event::setType ( const AtomicString type)
inline

◆ setType() [2/2]

void WebCore::Event::setType ( const AtomicString type)
inline

◆ setUnderlyingEvent() [1/2]

void WebCore::Event::setUnderlyingEvent ( Event )

◆ setUnderlyingEvent() [2/2]

void Event::setUnderlyingEvent ( Event underlyingEvent)

◆ setUntrusted() [1/2]

void WebCore::Event::setUntrusted ( )
inline

◆ setUntrusted() [2/2]

void WebCore::Event::setUntrusted ( )
inline

◆ srcElement() [1/2]

EventTarget* WebCore::Event::srcElement ( ) const
inline

◆ srcElement() [2/2]

EventTarget* WebCore::Event::srcElement ( ) const
inline

◆ stopImmediatePropagation() [1/2]

void WebCore::Event::stopImmediatePropagation ( )
inline

◆ stopImmediatePropagation() [2/2]

void WebCore::Event::stopImmediatePropagation ( )
inline

◆ stopPropagation() [1/2]

void WebCore::Event::stopPropagation ( )
inline

◆ stopPropagation() [2/2]

void WebCore::Event::stopPropagation ( )
inline

◆ target() [1/2]

EventTarget* WebCore::Event::target ( ) const
inline

◆ target() [2/2]

EventTarget* WebCore::Event::target ( ) const
inline

◆ timeStamp() [1/2]

DOMTimeStamp WebCore::Event::timeStamp ( ) const
inline

◆ timeStamp() [2/2]

DOMTimeStamp WebCore::Event::timeStamp ( ) const
inline

◆ type() [1/2]

const AtomicString& WebCore::Event::type ( ) const
inline

◆ type() [2/2]

const AtomicString& WebCore::Event::type ( ) const
inline

◆ underlyingEvent() [1/2]

Event* WebCore::Event::underlyingEvent ( ) const
inline

◆ underlyingEvent() [2/2]

Event* WebCore::Event::underlyingEvent ( ) const
inline

The documentation for this class was generated from the following files: