Creates a new folder resource as a member of this handle's parent resource.
This is a convenience method, fully equivalent to:
create((force ? FORCE : IResource.NONE), local, monitor);
This method changes resources; these changes will be reported in a subsequent resource change event, including an indication that the folder has been added to its parent.
This method is long-running; progress and cancellation are provided by the given progress monitor.
@param force a flag controlling how to deal with resources thatare not in sync with the local file system
@param local a flag controlling whether or not the folder will be localafter the creation
@param monitor a progress monitor, or
null
if progressreporting is not desired
@exception CoreException if this method fails. Reasons include:
- This resource already exists in the workspace.
- The workspace contains a resource of a different type at the same path as this resource.
- The parent of this resource does not exist.
- The parent of this resource is a project that is not open.
- The parent contains a resource of a different type at the same path as this resource.
- The name of this resource is not valid (according to
IWorkspace.validateName
). - The corresponding location in the local file system is occupied by a file (as opposed to a directory).
- The corresponding location in the local file system is occupied by a folder and
force
is false
. - Resource changes are disallowed during certain types of resource change event notification. See
IResourceChangeEvent
for more details.
@exception OperationCanceledException if the operation is canceled. Cancelation can occur even if no progress monitor is provided.
@see IFolder#create(int,boolean,IProgressMonitor)