File: Resize.xml

package info (click to toggle)
fvwm 1%3A2.7.0-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 15,968 kB
  • sloc: ansic: 145,836; xml: 17,096; perl: 7,237; sh: 5,100; makefile: 1,101; yacc: 688; lex: 187; sed: 11
file content (168 lines) | stat: -rw-r--r-- 5,732 bytes parent folder | download | duplicates (4)
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>