X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=doc%2Fkeys.xml;h=852363fa7fd6595dca703029141f2699e52deffd;hb=dd6d813ffad339352c39dc0645a792bdd9d8315c;hp=8367eecba621cb96fd91e92d26d6ba2b419cb90d;hpb=43080325d64b525633b5035331b79a2e7a177924;p=inkscape.git diff --git a/doc/keys.xml b/doc/keys.xml index 8367eecba..852363fa7 100644 --- a/doc/keys.xml +++ b/doc/keys.xml @@ -1,6 +1,9 @@ - + -

This document describes the default keyboard shortcuts of Inkscape, corresponding to the +

This document describes the default keyboard and mouse shortcuts of Inkscape, corresponding to the share/keys/default.xml file in Inkscape distribution. Most (but not all) of these keys are configurable by the user; see the default.xml file for details on how to do that.

@@ -19,9 +22,12 @@ RFE).

s Selector Selector (temporary) Space switches to the Selector tool temporarily; another Space switches back. +When the "Left mouse button pans when Space is pressed" option is on in Preferences, Space+mouse drag pans canvas instead of switching to Selector. n Node tool +w Tweak tool z Zoom tool r Rectangle tool +x 3D box tool e Ellipse/arc tool p Freehand (Pencil) tool b Bezier (Pen) tool @@ -40,6 +46,7 @@ RFE).

*
+Open F Fill and Stroke W Swatches T Text and Font @@ -54,7 +61,7 @@ RFE).

E Export to PNG F Find B Trace bitmap -These open a new dialog window if it wasn't open yet, otherwise the corresponding dialog gets focus. +These shortcuts open a new dialog window if it wasn't open yet, otherwise the corresponding dialog gets focus. @@ -81,23 +88,28 @@ RFE).

*
+Access The Controls bar at the top of the document window provides different buttons and controls for each tool. X jump to the first editable field - accept the new value -This accepts the new value you typed in a text field and returns focus to canvas. - cancel changes, return to canvas -This cancels any changes you made in a text field and returns focus to canvas. -Z cancel changes -This cancels any changes you made in a text field but you stay in the field. + + + +Navigate jump to next field jump to previous field Use these to navigate between fields in the Controls bar (the value in the field you leave, if changed, is accepted). -Changing values +Change values change value by 0.1 change value by 5.0 + accept the new value +This accepts the new value you typed in a text field and returns focus to canvas. + cancel changes, return to canvas +This cancels any changes you made in a text field and returns focus to canvas. +Z cancel changes +This cancels any changes you made in a text field but you stay in the field.
@@ -112,6 +124,7 @@ RFE).

zoom in zoom out zoom in or out +When the "Mouse wheel zooms by default" option is on in Preferences, Ctrl+wheel scrolls instead of zooming. To zoom, use wheel without Ctrl. zoom into the area Z activate zoom field The zoom field in the lower left corner of the window allows you to specify zoom level precisely. @@ -135,13 +148,15 @@ RFE).

 -Scrolling (panning) +Scroll (pan) scroll canvas Scrolling by keys is accelerated, i.e. it speeds up when you press Ctrl+arrows in quick succession, or press and hold. pan canvas pan canvas scroll canvas vertically +When the "Mouse wheel zooms by default" option is on in Preferences, mouse wheel zooms instead of scrolling. To scroll, use Ctrl+wheel. scroll canvas horizontally +When the "Left mouse button pans when Space is pressed" option is on in Preferences, Space+mouse drag also pans canvas. @@ -167,6 +182,7 @@ RFE).

These keys work both in the floating palette dialog and in the palette frame at the bottom of the window. set fill color on selection set stroke color on selection + set stroke color on selection drag fill color to objects drag stroke color to objects To change fill/stroke of an object by dragging color on it, that object need not be selected. @@ -324,7 +340,7 @@ RFE).

 -Booleans +Boolean operations + union Union combines any number of objects into a single path, removing overlaps. - difference @@ -386,7 +402,32 @@ RFE).

*
-Keyboard select +Select (mouse) + select an object +When you left-click on an object, previous selection is deselected. + toggle selection +Shift+click adds an object to the current selection if it was not selected, or deselects it otherwise. + edit the object +For paths, double clicking switches to Node tool; for shapes, to corresponding shape tool; for text, to Text tool. +For groups, double clicking performs the "Enter group" command (the group becomes temporary layer). +Double clicking in empty space swithes to the parent layer in the hierarchy, if any. + + + +Rubberband, touch selection + select by rubberband +Dragging around objects does "rubberband" selection; previous selection is deselected. + add objects to selection +Normally, you need to start from an empty space to initiate a rubberband. +However, if you press Shift before dragging, Inkscape will do rubberband selection even if you start from an object. + select by touch +Alt+dragging over objects selects those objects that are touched by the path. +To start touch selection with Alt, you must have nothing selected; otherwise use Shift+Alt. +You can switch rubberband selection to touch selection and back while dragging by pressing/releasing Alt. + + + +Select (keyboard) select next object select previous object These keys pick objects in their z-order (Tab cycles from bottom to top, Shift+Tab cycles from top to bottom). @@ -405,57 +446,6 @@ RFE).

delete selection - -Keyboard move - move selection by the nudge distance - move selection by 10x nudge distance -The default nudge distance is 2 px (SVG pixel units, not screen pixels). - move selection by 1 pixel - move selection by 10 pixels -The actual distance for pixel movements depends on zoom level. Zoom in for finer movement. - - - -Keyboard scale -. > scale selection up by the scale step -, < scale selection down by the scale step -The default scale step is 2 px (SVG pixel units, not screen pixels). -. > scale selection to 200% -, < scale selection to 50% -. > scale selection up by 1 pixel -, < scale selection down by 1 pixel -The actual size increment for pixel scaling depends on zoom level. Zoom in for finer scaling. -Scaling is uniform around the center, so that the size increment applies to the larger of the two dimensions. - - - -Keyboard rotate -[ ] rotate selection by the angle step -The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise. -[ ] rotate selection by 90 degrees -[ ] rotate selection by 1 pixel -The actual angle for pixel rotation depends on zoom level. Zoom in for finer movement. -These commands use the rotation center, draggable in Selector (by default it's in geometric center). - - - -Keyboard flip -h flip selection horizontally -v flip selection vertically - - - -Mouse select - select an object -When you left-click on an object, previous selection is deselected. - toggle selection -Shift+click adds an object to the current selection if it was not selected, or deselects it otherwise. - edit the object -For paths, double clicking switches to Node tool; for shapes, to corresponding shape tool; for text, to Text tool. -For groups, double clicking performs the "Enter group" command (the group becomes temporary layer). -Double clicking in empty space swithes to the parent layer in the hierarchy, if any. - - Select within group, select under select within group @@ -478,20 +468,7 @@ groups) with the same effect as Alt+click.) -Rubberband, touch selection - select by rubberband -Dragging around objects does "rubberband" selection; previous selection is deselected. - add objects to selection -Normally, you need to start from an empty space to initiate a rubberband. -However, if you press Shift before dragging, Inkscape will do rubberband selection even if you start from an object. - select by touch -Alt+dragging over objects selects those objects that are touched by the path. -To start touch selection with Alt, you must have nothing selected; otherwise use Shift+Alt. -You can switch rubberband selection to touch selection and back while dragging by pressing/releasing Alt. - - - -Mouse move +Move (mouse) select + move Dragging an object selects it if it was not selected, then moves selection. move selected @@ -506,26 +483,48 @@ groups) with the same effect as Alt+click.) -Mouse transform - toggle scale/rotation handles - scale (scale handles) - rotate or skew (rotation handles) +Move (keyboard) + move selection by the nudge distance + move selection by 10x nudge distance +The default nudge distance is 2 px (SVG pixel units, not screen pixels). + move selection by 1 pixel + move selection by 10 pixels +The actual distance for pixel movements depends on zoom level. Zoom in for finer movement. + + + +Transform (mouse) +S toggle scale/rotation handles + scale (with scale handles) + rotate or skew (with rotation handles) -Scale handles +Scale by handles scale scale preserving aspect ratio - symmetric transformation Holding Shift while transforming makes transformation symmetric around the center of the selection. - slow movement -Holding Alt while transforming makes transformation lag behind mouse movement, allowing finer changes. + scale by integer +Hold Alt while scaling to limit scale to 2, 3, 4, etc. or 1/2, 1/3, 1/4 etc. of the initial size. + + + +Scale (keyboard) +. > scale selection up by the scale step +, < scale selection down by the scale step +The default scale step is 2 px (SVG pixel units, not screen pixels). +. > scale selection to 200% +, < scale selection to 50% +. > scale selection up by 1 pixel +, < scale selection down by 1 pixel +The actual size increment for pixel scaling depends on zoom level. Zoom in for finer scaling. +Scaling is uniform around the center, so that the size increment applies to the larger of the two dimensions. -Rotation/skew handles +Rotate/skew by handles rotate or skew snap skew angle Holding Ctrl when dragging a skew (non-corner) handle snaps the skew angle to angle steps (default 15 degrees). @@ -533,10 +532,27 @@ groups) with the same effect as Alt+click.) Holding Ctrl when dragging a rotation (corner) handle snaps the rotation angle to angle steps (default 15 degrees). + +Rotate (keyboard) +[ ] rotate selection by the angle step +The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise. +[ ] rotate selection by 90 degrees +[ ] rotate selection by 1 pixel +The actual angle for pixel rotation depends on zoom level. Zoom in for finer movement. +These commands use the rotation center, draggable in Selector (by default it's in geometric center). + + + +Flip +h flip selection horizontally +v flip selection vertically +If the tool is in rotate mode (rotation center visible), that center becomes the axis of flipping; otherwise it flips around geometric center of selection + + Rotation center move rotation center -Moved rotation center remembers its position for (all) selected object(s) until you reset it. +Moved rotation center remembers and saves its position for (all) selected object(s); you can reset it. Dragging the center snaps it to the centerlines and bounding box edges of the selection. move without snapping reset rotation center @@ -557,7 +573,36 @@ groups) with the same effect as Alt+click.) *
-Keyboard select +Select objects (mouse) + click a non-selected object to select + select under + toggle selection +These work the same as in Selector. The nodes or handles of the single selected object become editable. + + + +Select nodes (mouse) + select a node +Clicking on a node selects it. + select two adjacent nodes +Clicking on a selected path between the nodes selects the two nodes closest to the click point. + toggle selection +This adds/removes a node (if clicked on node) or two nodes (if clicked on path) to/from the node selection. + deselect +Clicking in an empty space deselects all selected nodes. Next click will deselect the object. + + + +Rubberband selection + select multiple nodes +Dragging around nodes does "rubberband" selection; previous node selection is deselected. + add nodes to selection +Normally, you need to start from a point not over a path or a node to initiate a rubberband. +However, if you press Shift before dragging, Inkscape will do rubberband selection even if you start over the path. + + + +Select nodes (keyboard) select next node select previous node These keys select nodes within the selected path @@ -573,7 +618,39 @@ groups) with the same effect as Alt+click.) -Keyboard move +Grow/shrink node selection + grow/shrink selection (spatial) + grow/shrink selection (spatial) + grow/shrink selection (along path) + grow/shrink selection (along path) +Your mouse pointer must be over a node for growing/shrinking. +Each key press or wheel click selects the nearest unselected node or deselects the farthest selected node. +Distance to nodes can be calculated directly (spatial mode) or along path. + + + +Move nodes (mouse) + move selected nodes + restrict movement to horizontal or vertical + move along handles +This restricts movement to the directions of the node's handles, their continuations and perpendiculars (total 8 snaps). +If the node has straight lines on one or both sides, this will snap it to these lines' directions and perpendiculars instead. + temporarily disable snapping +Snapping nodes is enabled in Document Preferences. By default, only bounding box of objects snaps to grid/guides. + drag out handle +If a node has a retracted handle, dragging with Shift lets you drag it out of the node. + drop a copy +When dragging nodes with mouse, each Space leaves a copy of the selected object. +You can press and hold Space while dragging for a nice "trail." + sculpt nodes +Sculpting moves the selected nodes so that the dragged node moves all the way, the farthest selected nodes stay put; +all intermediate selected nodes move intermediate distances, governed by a bell-like curve. +Sculpting is pressure-sensitive with a tablet; press harder for a blunter drag profile, press lightly for a sharper profile. +To stop sculpting without losing the pressure-sensitive profile, release Alt first and then lift the pen. + + + +Move nodes (keyboard) move selected node(s) by the nudge distance move selected node(s) by 10x nudge distance The default nudge distance is 2 px (SVG pixel units, not screen pixels). @@ -583,7 +660,19 @@ groups) with the same effect as Alt+click.) -Keyboard handle scale (1 node selected) +Move node handle (mouse) + move a node handle + snap the handle to angle steps +The default angle step is 15 degrees. This also snaps to the handle's original angle, its continuation and perpendiculars. + rotate both handles + lock the handle length +Ctrl, Shift, Alt can be combined when dragging handles. + retract the handle +Retracted handle is zero length; use Shift+drag to drag it back out. + + + +Scale handle (1 node selected) < > contract/expand both handles by scale step The default scale step is 2 px (SVG pixel units, not screen pixels). May apply to more than one node. @@ -611,7 +700,7 @@ groups) with the same effect as Alt+click.) -Keyboard handle rotate (1 node selected) +Rotate handle (1 node selected) [ ] rotate both handles by the angle step The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise. May apply to more than one node. [ ] rotate left handle by the angle step @@ -622,8 +711,9 @@ groups) with the same effect as Alt+click.) -Keyboard scale (>1 nodes selected) -These commands scale the selected nodes as if they were an "object", around the center of that object. +Scale nodes (>1 nodes selected) +These commands scale the selected nodes as if they were an "object". +If mouse is over a node, that node becomes the axis of scaling; otherwise it scales around geometric center of selected nodes. . > scale nodes up by the scale step , < scale nodes down by the scale step The default scale step is 2 px (SVG pixel units, not screen pixels). @@ -634,8 +724,9 @@ groups) with the same effect as Alt+click.) -Keyboard rotate (>1 nodes selected) -These commands rotate the selected nodes as if they were an "object", around the center of that object. +Rotate nodes (>1 nodes selected) +These commands rotate the selected nodes as if they were an "object". +If mouse is over a node, that node becomes the axis of rotation; otherwise it rotates around geometric center of selected nodes. [ ] rotate nodes by the angle step The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise. [ ] rotate nodes by 1 pixel @@ -643,13 +734,13 @@ groups) with the same effect as Alt+click.) -Keyboard flip (>1 nodes selected) +Flip nodes (>1 nodes selected) These commands flip the selected nodes as if they were an "object", around the center of that object. h flip nodes horizontally v flip nodes vertically +If mouse is over a node, that node becomes the axis of flipping; otherwise it flips around geometric center of selected nodes - Change segment(s) L make line @@ -706,76 +797,18 @@ groups) with the same effect as Alt+click.) --> - -Mouse select: objects - click a non-selected object to select - select under - toggle selection -These work the same as in Selector. The nodes or handles of the single selected object become editable. - - - -Mouse select: nodes - select a node -Clicking on a node selects it. - select two adjacent nodes -Clicking on a selected path between the nodes selects the two nodes closest to the click point. - toggle selection -This adds/removes a node (if clicked on node) or two nodes (if clicked on path) to/from the node selection. - deselect -Clicking in an empty space deselects all selected nodes. Next click will deselect the object. - - - -Rubberband - select multiple nodes -Dragging around nodes does "rubberband" selection; previous node selection is deselected. - add nodes to selection -Normally, you need to start from a point not over a path or a node to initiate a rubberband. -However, if you press Shift before dragging, Inkscape will do rubberband selection even if you start over the path. - - - - -Node move (mouse) - move selected nodes - restrict movement to horizontal or vertical - move along handles -This restricts movement to the directions of the node's handles, their continuations and perpendiculars (total 8 snaps). -If the node has straight lines on one or both sides, this will snap it to these lines' directions and perpendiculars instead. - temporarily disable snapping -Snapping nodes is enabled in Document Preferences. By default, only bounding box of objects snaps to grid/guides. - drag out handle -If a node has a retracted handle, dragging with Shift lets you drag it out of the node. - drop a copy -When dragging nodes with mouse, each Space leaves a copy of the selected object. -You can press and hold Space while dragging for a nice "trail." - -Node handles - move a node handle - snap the handle to angle steps -The default angle step is 15 degrees. This also snaps to the handle's original angle, its continuation and perpendiculars. - rotate both handles - lock the handle length -Ctrl, Shift, Alt can be combined when dragging handles. - retract the handle -Retracted handle is zero length; use Shift+drag to drag it back out. - - - -Reversing +Reverse r reverse path direction -Editing shapes +Edit shapes Node tool can also drag the handles of shapes (rectangles, ellipses, stars, spirals). Click on a shape to select it. See the corresponding shape tools for their editing shortcuts, all of which also work in node tool. - Cancel cancel rubberband or move @@ -788,91 +821,167 @@ groups) with the same effect as Alt+click.) +*
+ +Operation + act on selected paths in the current mode + act temporarily switching to melt mode + act temporarily switching to inflate mode +The amount of tweaking action is the greatest at the center of the circular area and drops off smoothly towards the edges. + + + +Modes +p push mode +m melt (thin) mode +i inflate (thicken) mode +r roughen mode + + + +Parameters + adjust brush width by 1 + set brush width to 1 / 100 + adjust tweaking force +Width and force can be adjusted while drawing. + + +
*
-Drawing +Draw draw a rectangle make a square or integer-ratio rectangle This restricts rectangle so its height/width ratio is a whole number. draw around the starting point This creates a rectangle symmetric around the starting point of the mouse drag. + -Editing - click an object to select +Select + click to select select under toggle selection - drag a handle to resize or round corners -Initially, the two rounding handles are in the top right corner; two resize handles are in top left and bottom right corners. - lock width, height, or ratio (resize handles) - lock the corner circular (rounding handles) +In this tool, selecting by click disregards any grouping (i.e. acts as clicking with Ctrl in Selector) + deselect + + + +Resize by handles + drag a square handle to resize +Initially, the two resize (square) handles are in top left and bottom right corners. Resize handles change the width and height of the rectangle in its own coordinate system, before any transforms are applied. -When rounding corners, dragging only one rounding handle (with the other at the corner) keeps the corner circular. -You can drag both handles for an elliptic rounded corner, or drag one with Ctrl to make sure the other one is synchronized. + lock width, height, or ratio + + + +Round corners by handles + drag a circular handle to round corners +Initially, the two rounding handles are in the top right corner of the rectangle. + lock the corner circular + set the corner circular +When rounding corners, dragging one rounding handle keeps the corner circular if the other remains at the corner. +You can drag both handles for an elliptic rounded corner, or drag/click one with Ctrl to make it circular again. + remove corner rounding + +
+ +*
+ +Draw + draw a 3D box + + + +Select + click to select + select under + toggle selection deselect +
*
-Drawing +Draw draw an ellipse make circle or integer-ratio ellipse This restricts ellipse so its height/width ratio is a whole number. draw around the starting point This creates an ellipse symmetric around the starting point of the mouse drag. + -Editing - click an object to select +Select + click to select select under toggle selection - drag a handle to resize, make arc or segment -Initially, the two arc/segment handles are in the rightmost point; two resize handles are at the topmost and leftmost points. +In this tool, selecting by click disregards any grouping (i.e. acts as clicking with Ctrl in Selector) + deselect + + + +Edit by handles + resize, make arc or segment +Initially, the two resize handles are at the topmost and leftmost points; the two arc/segment handles are in the rightmost point. lock circle (resize handles) snap to angle steps (arc/segment handles) Resize handles change the width and height of the ellipse in its own coordinate system, before any transforms are applied. The default angle step is 15 degrees. - deselect + make whole (arc/segment handles)
*
-Drawing +Draw draw a star snap star to angle steps The default angle step is 15 degrees. + -Editing - click an object to select - select under +Select + click to select + select under toggle selection +In this tool, selecting by click disregards any grouping (i.e. acts as clicking with Ctrl in Selector) + deselect + + + +Edit by handles drag a handle to vary the star shape keep star rays radial (no skew) round the star remove rounding randomize the star remove randomization - deselect
*
-Drawing +Draw draw a spiral snap spiral to angle steps The default angle step is 15 degrees. + -Editing - click an object to select - select under +Select + click to select + select under toggle selection +In this tool, selecting by click disregards any grouping (i.e. acts as clicking with Ctrl in Selector) + deselect + + + +Edit by handles roll/unroll from inside (inner handle) Dragging the inner handle adjusts the "inner radius" parameter. converge/diverge (inner handle) @@ -888,8 +997,6 @@ groups) with the same effect as Alt+click.) snap handles to angle steps The default angle step is 15 degrees. This works for both handles. - - deselect
@@ -971,16 +1078,13 @@ groups) with the same effect as Alt+click.)
-*
+*
draw a calligraphic line add to selected path Drawing with Shift unions the newly created stroke with the previous selection track a guide path Drawing with Ctrl tracks a selected guide path at the constant distance - thin selected paths - thicken selected paths -Dragging with Alt or Shift+Alt over selected paths makes them thinner/thicker where you drag adjust pen width by 1 set pen width to 1 or 100 adjust pen angle @@ -994,15 +1098,29 @@ groups) with the same effect as Alt+click.) fill a bounded area add to selected path Clicking with Shift unions the newly created fill with the previous selection + fill from each point +From each point, the fill spreads to the neighbors with the colors similar to that point. +This can be used to fill an area currently filled with a gradient or blur. + fill from each point same as initial point +From each point, the fill spreads to the neighbors with the colors similar to the initial point of the drag. +This can be used to fill several disjoint bounded areas by starting in one and dragging over all of the areas. set fill color set stroke color -Ctrl+clicking an object sets its fill (or stroke with Shift) to the tool's current style +Ctrl+clicking an object sets its fill (or stroke with Shift) to the tool's current style; the object need not be selected
*
+ -Creating gradients +Select objects + click an object to select + select under + toggle selection + + + +Create gradients create gradient This creates gradient on selected objects. The Controls bar lets you select linear/radial and fill/stroke for the new gradient. create default gradient @@ -1010,33 +1128,55 @@ groups) with the same effect as Alt+click.) -Handles +Select handles + select a handle + add handle to selection select next handle select previous handle + deselect all handles + + + +Create/delete stops + create a stop + create a stop +Ctrl+Alt+click or double click on a gradient line creates a new intermediate stop + delete stop +Ctrl+Alt+click on a stop's handle deletes the stop; +if it was an end stop, gradient shortens or disappears + delete selected stops + + + +Move handles + + move selected handle(s) move selected handle by the nudge distance move selected handle by 10x nudge distance The default nudge distance is 2 px (SVG pixel units, not screen pixels). move selected handle by 1 pixel move selected handle by 10 pixels The actual distance for pixel movements depends on zoom level. Zoom in for finer movement. - deselect handle - open gradient editor -Double clicking a gradient handle opens the Gradient Editor with that gradient and the clicked handle chosen in the stops list. + -Reversing +Reverse r reverse gradient definition This mirrors the stop positions of the current gradient without moving the gradient handles. + -Mouse select - click an object to select - select under - toggle selection +Gradient editor + open gradient editor +Double clicking a gradient handle opens the Gradient Editor with that gradient and the clicked handle chosen in the stops list. +
@@ -1064,7 +1204,7 @@ groups) with the same effect as Alt+click.) *
-Selecting/creating +Select/create create/select a text object Clicking in an empty space or on a non-text creates a text object; now you can type your text. @@ -1073,7 +1213,7 @@ groups) with the same effect as Alt+click.) -Text navigation +Navigate in text move cursor by one character move cursor by one word move cursor by one paragraph @@ -1110,7 +1250,7 @@ groups) with the same effect as Alt+click.) -Editing text +Edit text To type + and - characters, use the main keyboard; keypad + and - are reserved for zoom (unless NumLock is on). start a new line or paragraph Enter in regular text creates new line; in flowed text it creates a new paragraph @@ -1124,7 +1264,7 @@ groups) with the same effect as Alt+click.) -Selecting text +Select text select text Left-dragging over a text object selects a text span. select text by character @@ -1138,7 +1278,7 @@ groups) with the same effect as Alt+click.) -Styling selection +Style selection B make selection bold I make selection italic Also, you can use the Text&Font or Fill&Stroke dialogs to assign any style to text selection. @@ -1175,7 +1315,7 @@ groups) with the same effect as Alt+click.) -Rotating +Rotate [ ] rotate character(s) by 90 degrees [ ] rotate character(s) by 1 pixel These commands rotate the next character (without selection) or all characters in the selection (with selection).