You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Mar 11, 2026. It is now read-only.
Copy file name to clipboardExpand all lines: index.html
+19-7Lines changed: 19 additions & 7 deletions
Original file line number
Diff line number
Diff line change
@@ -41,12 +41,24 @@ <h1>Search Layers Plugin</h1>
41
41
<p>Search Layers is located in the QGIS Plugins menu under <em>"Plugins->Search Layers->Search Layers"</em> or by selecting the tool bar icon. <imgalt="Toolbar Icon" src="icon.png" /></p>
42
42
<p>The following dialog box is displayed when "Search Layers" is launched.</p>
<p>Under <strong>Search String</strong>, enter the search string. <strong>Search Layers</strong> specifies whether the search will be on <em><All Layers></em>, <em><Selected layers></em>, or on any of the vector layers in the QGIS project. If a specific layer is selected then <strong>Search Fields</strong>will be enabled and by default <em><All Fields></em>will be selected, but any field can be selected from the layer and the search will only search on that layer and field.</p>
45
-
<p><strong>Comparison</strong> is the matching criteria and is as follows.</p>
44
+
<p>Under <strong>Search criteria</strong>, you can enter up to two search strings. The <strong>NOT</strong>check box will negate the search results for the applicable string.</p>
45
+
<p>Under each search string text box a drop down menu specifies how the search string is to match the contents in the attribute table. The options are: </p>
46
46
<ul>
47
-
<li><strong>=</strong> - This requires an exact match including case.</li>
48
-
<li><strong>Contains</strong> - This performs a case independent search in which a match is made if a field contains the search string.</li>
49
-
<li><strong>Begins with</strong> - This is a case independent search in which the search finds any field that begins with the search string.</li>
47
+
<li><strong>equals</strong> - This requires an exact match.</li>
48
+
<li><strong>contains</strong> - This looks for a field that contains the search string.</li>
49
+
<li><strong>begins with</strong> - This search finds any field that begins with the search string.</li>
50
+
<li><strong>ends with</strong> - This search finds any field that ends with the search string.</li>
50
51
</ul>
51
-
<p>Click the <strong>Search</strong> button to begin the search. In the case of a large data set, clicking on <strong>Stop</strong> will halt the process. Note that the plugin stops after finding 1500 matches.</p>
52
-
<p>When matches are found and clicked on, the features are highlighted on the map. If <strong>Automatically zoom to selected features</strong> is checked, QGIS also zooms to the selected features. The matches can be examined even before the search process has been completed.</p></body>
52
+
<p>By default the search is case independent, but by checking the <strong>Case sensitive</strong> check box the search string must match the case of the text.</p>
53
+
<p><strong>Search Layers</strong> specifies whether the search will be on <em><All Layers></em>, <em><Selected layers></em>, or on any of the vector layers in the QGIS project. If a specific layer is selected then <strong>Search Fields</strong> will be enabled and by default <em><All Fields></em> will be selected, but any field can be selected from the layer and the search will only search on that layer and field.</p>
54
+
<p>It is possible that a search string could match the contents in one or more attribute fields. By checking <strong>Report one result per feature</strong>, only the first match per feature will be reported.</p>
55
+
<p>When two search strings are used checking <strong>Constrain two search strings to match within an attribute field rather than across attribute fields</strong> will constrain the search criteria to match within an attribute field; otherwise, one string may match one attribute field and the other string may match another attribute field. The results are either <strong>AND</strong>ed or <strong>OR</strong>ed together. Here is an axample of a two string search.</p>
<p>Click the <strong>Search</strong> button to begin the search. In the case of a large data set, clicking on <strong>Abort</strong> will halt the process. Note that the plugin stops after finding 1500 matches.</p>
58
+
<p>When matches are found and clicked on the feature(s) will be highlighted. You can you Shift->Click to highlight a range of features, Ctrl->Click to toggle whether a feature is highlighted or not. The drop down menu <strong>Action when selecting features below</strong> controls one of the following motion actions. </p>
59
+
<ul>
60
+
<li><strong>Do nothing</strong> - No action takes place.</li>
61
+
<li><strong>Zoom to selected features</strong> - QGIS will zoom in on the selected features.</li>
62
+
<li><strong>Pan to selected features</strong> - QGIS will pan to the selected features.</li>
63
+
</ul>
64
+
<p>Note that the search is very quick when selecting a single vector layer under <strong>Search Layers</strong> and a single field under <strong>Search Fields</strong>. If this is not the case regular expression searches are used and are very slow. In the future this may change.</p></body>
Copy file name to clipboardExpand all lines: readme.md
+23-7Lines changed: 23 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,15 +8,31 @@ The following dialog box is displayed when "Search Layers" is launched.
8
8
9
9

10
10
11
-
Under **Search String**, enter the search string. **Search Layers** specifies whether the search will be on *<All Layers>*, *<Selected layers>*, or on any of the vector layers in the QGIS project. If a specific layer is selected then **Search Fields**will be enabled and by default *<All Fields>*will be selected, but any field can be selected from the layer and the search will only search on that layer and field.
11
+
Under **Search criteria**, you can enter up to two search strings. The **NOT**check box will negate the search results for the applicable string.
12
12
13
-
**Comparison** is the matching criteria and is as follows.
13
+
Under each search string text box a drop down menu specifies how the search string is to match the contents in the attribute table. The options are:
14
14
15
-
***=** - This requires an exact match including case.
16
-
***Contains** - This performs a case independent search in which a match is made if a field contains the search string.
17
-
***Begins with** - This is a case independent search in which the search finds any field that begins with the search string.
15
+
***equals** - This requires an exact match.
16
+
***contains** - This looks for a field that contains the search string.
17
+
***begins with** - This search finds any field that begins with the search string.
18
+
***ends with** - This search finds any field that ends with the search string.
18
19
19
-
Click the **Search** button to begin the search. In the case of a large data set, clicking on **Stop**will halt the process. Note that the plugin stops after finding 1500 matches.
20
+
By default the search is case independent, but by checking the **Case sensitive**check box the search string must match the case of the text.
20
21
21
-
When matches are found and clicked on, the features are highlighted on the map. If **Automatically zoom to selected features** is checked, QGIS also zooms to the selected features. The matches can be examined even before the search process has been completed.
22
+
**Search Layers** specifies whether the search will be on *<All Layers>*, *<Selected layers>*, or on any of the vector layers in the QGIS project. If a specific layer is selected then **Search Fields** will be enabled and by default *<All Fields>* will be selected, but any field can be selected from the layer and the search will only search on that layer and field.
22
23
24
+
It is possible that a search string could match the contents in one or more attribute fields. By checking **Report one result per feature**, only the first match per feature will be reported.
25
+
26
+
When two search strings are used checking **Constrain two search strings to match within an attribute field rather than across attribute fields** will constrain the search criteria to match within an attribute field; otherwise, one string may match one attribute field and the other string may match another attribute field. The results are either **AND**ed or **OR**ed together. Here is an axample of a two string search.
27
+
28
+

29
+
30
+
Click the **Search** button to begin the search. In the case of a large data set, clicking on **Abort** will halt the process. Note that the plugin stops after finding 1500 matches.
31
+
32
+
When matches are found and clicked on the feature(s) will be highlighted. You can you Shift->Click to highlight a range of features, Ctrl->Click to toggle whether a feature is highlighted or not. The drop down menu **Action when selecting features below** controls one of the following motion actions.
33
+
34
+
***Do nothing** - No action takes place.
35
+
***Zoom to selected features** - QGIS will zoom in on the selected features.
36
+
***Pan to selected features** - QGIS will pan to the selected features.
37
+
38
+
Note that the search is very quick when selecting a single vector layer under **Search Layers** and a single field under **Search Fields**. If this is not the case regular expression searches are used and are very slow. In the future this may change.
0 commit comments