blob: cf9c50072dbd936597d4c14eb223849d056f34ea [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="en">
<HEAD>
<meta name="copyright" content="Copyright (c) Freescale Semiconductor and others 2010, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
<title>Resource filters</title>
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"> </script>
</HEAD>
<BODY BGCOLOR="#ffffff">
<H1 CLASS="Head">Resource filters</H1>
<p>
Resource filters allow you to configure which files and folders are included automatically
in a project resource hierarchy when refresh is performed.
</p>
<p>
By adding resource filters to a project or folder, you can systematically prevent some file
system entries to be displayed in the resource tree.
</p>
<p>
A resource filter is either of <b>Include Only</b> or <b>Exclude All</b> type, and can apply to either files,
folders, or both.
</p>
<p>
Resource filters only apply to files and/or folders that are implicitly included in the workspace
by the refresh operation. Link files and folders are not affected by resource filters, since they
need to be created explicitly by the user.
</p>
<p>
An "Include" resource filter allows only files and/or folders that match the filter condition
to be included in the workspace during the refresh operation. If multiple "Include" filters exist,
the elements included will be those who match any of the existing "Include" filters.
</p>
<p>
An "Exclude" resource filter prevent all files and/or folders that match the filter condition
to be included in the workspace during the refresh operation. If multiple "Exclude" filters exist,
the elements excluded will be those who match any of the existing "Exclude" filters.
</p>
<p>
If both "Exclude" and "Include" resource filters exist in a given folder or project, only files
and/or folders that match any of the "Include" filters <b>and </b> do not match any of the "Exclude"
filters will be included in the workspace.
</p>
<p>
A resource filter can apply recursively to all children of the project or folder it is created on. In
such case, the resource filter will apply to a sub-folder as if it was created in that sub-folder
itself, following the rules mentioned above.
</p>
<p>
Resource filters can be created, edited and removed in
the <b>File &gt; Properties &gt; Resource &gt; Resources Filters</b> property page for a project or
folder resource.
</p>
<p>
Resource filters can also be created on a folder before that folder is created in the workspace by
selecting the "Resource Filters..." button in the "Advanced" section of the <b>New Folder wizard</b>.
</p>
<h3 class="related">Related concepts</h3>
<a href="concepts-13.htm">Linked resources</a>
<h3 class="related">Related tasks</h3>
<a href="../tasks/tasks-97.htm">Creating resource filters</a><br>
<a href="../tasks/tasks-49.htm">Viewing resource properties</a>
<h3 class="related">Related reference</h3>
<a href="../reference/ref-14b.htm">Linked resources</a>
</BODY>
</HTML>