1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168
|
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"../docbook-xml/docbookx.dtd"
[
<!ENTITY % myents SYSTEM "../fvwm.ent" >
%myents;
]>
<!-- $Id$ -->
<section id='Resize'>
<title>Resize</title>
<cmdsynopsis>
<command>Resize</command
><group choice='plain'
/><optional
><arg choice='opt'>frame</arg
><arg choice='opt'
>direction <replaceable>dir</replaceable
></arg><arg choice='opt'>warptoborder
<replaceable>automatic</replaceable></arg
><arg choice='opt'>fixeddirection</arg
><arg choice='plain'
><optional>w</optional
><replaceable>width</replaceable
><optional
><group choice='plain'
><arg choice='plain'>p</arg
><arg choice='plain'>c</arg
><arg choice='plain'>wa</arg
><arg choice='plain'>da</arg
></group
></optional
></arg
><arg choice='plain'
><optional>w</optional
><replaceable>height</replaceable
><optional
><group choice='plain'
><arg choice='plain'>p</arg
><arg choice='plain'>c</arg
></group
></optional
></arg
></optional>
</cmdsynopsis>
<para>Allows for resizing a window. If called from somewhere in a window
or its border, then that window is resized. If called from the
root window then the user is allowed to select the target window.</para>
<para>The operation can be aborted with <keysym>Escape</keysym> or by pressing
any mouse button (except button 1 which confirms it).</para>
<para>If the optional arguments
<replaceable>width</replaceable> and <replaceable>height</replaceable>
are provided, then the window is resized so that its dimensions
are
<replaceable>width</replaceable> by <replaceable>height</replaceable>.
The units of
<replaceable>width</replaceable> and <replaceable>height</replaceable>
are percent-of-screen, unless a letter
'<fvwmopt cmd="Resize" opt="p"/>'
is appended to one or both coordinates, in which case the location
is specified in pixels. With a
'<fvwmopt cmd="Resize" opt="c"/>'
suffix the unit defined by the client application (hence the c) is
used. With the suffix
'<fvwmopt cmd="Resize" opt="wa"/>'
the value is a percentage of the width or height size of the EWMH
working area, and with the suffix
'<fvwmopt cmd="Resize" opt="da"/>'
it is a percentage of the width or height of the EWMH dynamic working
area. So you can say</para>
<programlisting>Resize 80c 24c</programlisting>
<para>to make a terminal window just big enough for 80x24
characters.</para>
<para>If the
<replaceable>width</replaceable> or <replaceable>height</replaceable>
is prefixed with the letter
'<fvwmopt cmd="Resize" opt="w"/>'
the size is not taken as an absolute value but added to the
current size of the window. Example:</para>
<programlisting>
# Enlarge window by one line
Resize keep w+1c
</programlisting>
<para>Both,
<replaceable>width</replaceable> and <replaceable>height</replaceable>
can be negative. In this case the new size is the screen size
minus the given value. If either value is "<fvwmopt cmd="Resize" opt="keep"/>", the
corresponding dimension of the window is left untouched. The new
size is the size of the client window, thus</para>
<programlisting>Resize 100 100</programlisting>
<para>may make the window bigger than the screen. To base the new size
on the size of the whole fvwm window, add the
<fvwmopt cmd="Resize" opt="frame"/>
option after the command. The options
<emphasis remap='I'>fixeddirection</emphasis>,
<emphasis remap='I'>direction</emphasis> and
<emphasis remap='I'>warptoborder</emphasis>
are only used in interactive move operations. With
<fvwmopt cmd="Resize" opt="fixeddirection"/>
the same border is moved even if the pointer moves past the
opposite border. The
<fvwmopt cmd="Resize" opt="direction"/>
option must be followed by a direction name such as "NorthWest",
"South" or "East" (you get the idea). Resizing is started
immediately, even if the pointer is not on a border. If the special option
<fvwmopt cmd="Resize" opt="automatic"/> is given as a direction argument, then
the direction to resize is calculated based on the position of the pointer in
the window. If the pointer is in the middle of the window, then no direction is
calculated.
The <fvwmopt cmd="Resize" opt="warptoborder"/>
option can be used to warp the pointer to the direction indicated. As with the
<fvwmopt cmd="Resize" opt="automatic" /> option for
<fvwmopt cmd="Resize" opt="direction" />, the border to warp to is
calculated based on the pointer's proximity to a given border. Also, if
resizing is started by clicking on the window border, the pointer
is warped to the outer edge of the border.</para>
<programlisting>
<fvwmref cmd="AddToFunc"/> ResizeSE I Resize <fvwmref cmd="Direction"/> SE
<fvwmref cmd="Mouse"/> 3 A M ResizeSE
</programlisting>
<cmdsynopsis>
<command>Resize</command
><arg choice='opt'
><group choice='plain'
><arg choice='plain'>bottomright</arg
><arg choice='plain'>br</arg
></group
><arg choice='plain'
><replaceable>x</replaceable
></arg
><arg choice='plain'
><replaceable>y</replaceable
></arg
></arg>
</cmdsynopsis>
<para>An alternate syntax is used if the keyword
<fvwmopt cmd="Resize" opt="bottomright"/> or in short
<fvwmopt cmd="Resize" opt="br"/>
follows the command name. In this case, the arguments
<replaceable>x</replaceable> and <replaceable>y</replaceable>
specify the desired position of the bottom right corner of the
window. They are interpreted exactly like the
<replaceable>x</replaceable> and <replaceable>y</replaceable>
arguments of the
<fvwmref cmd="Move"/>
command. Actually, any of the options accepted by the
<fvwmref cmd="Move"/>
command can be used.</para>
</section>
|