Number: 170

Date: 18-Mar-84 16':13':13

Submitter: Sannella.PA

Source: Sheil.pa

Subject: Improve documentation of  WIDTH, HEIGHT window properties

Lisp Version: 1-Mar-84 14':24':22

Description: Date': 18 Mar 84 15':53 PST'
From': Sheil.pa'
Subject': Lisp': Window': WIDTH property'
To': LispSupport.pa'
'
Lisp-System-Date':  1-Mar-84 14':24':22'
Machine-Type': Dolphin'
'
Thw WIDTH windowprop is apparently calculated from the display stream clipping region, not the window size, so it is incorrect (i.e. neq the width of the region - the border) when the corresponding display stream is being clipped.'
'
This is an arguable design, but it deserves documentation if it is an intentional feature.'
'
(I would expect HEIGHT has the same property, but REGION does not).'
'
[Note': There is a paren typo in the manual page that documents this at "not settable by WINDOWPROP"]'
'
BEAU'
'
-----'
'
Date': 21 Mar 84 16':49 PST'
From': Burton.pa'
Subject': Lisp': response to ar 170'
To': LispSupport.pa'
cc': sheil.pa'
Status': Declined?'
'
'
Intentional (though arguably bad) design.  Did you not believe it when you read it or was it not clear?  Could you suggest a rewording?'
'
Relevant section included below for convenience.'
'
'
{Def {Type (Window Property)} {Name HEIGHT}}'
{Def {Type (Window Property)} {Name WIDTH}'
{Text'
Value is the height and width of the interior of the window (the usable space not counting the border and title).'
}}'
'
'
'
{Def {Type (Window Property)} {Name REGION}'
{Text'
Value is a region (in screen coordinates) indicating where the window (counting the border and title) is located on the screen.'
}}'
'
'
-----'
'
Date': 22 Mar 84 11':21 PST'
From': Sheil.pa'
Subject': Re': Lisp': response to ar 170'
In-reply-to': Burton.pa''s message of 21 Mar 84 16':49 PST'
To': Burton.pa'
cc': LispSupport.pa'
'
If the display clipping region is temporarily reset, the WIDTH and HEIGHT is *NOT* "the height and width of the interior of the window" but are the relevant values for the current clipping region. The documentation is just plain wrong as it currently stands.'
'
Since one can get the WIDTH and HEIGHT of the region from the region, if that''s what one wants, I do argue that the design should be changed.'
'
Beau'
'
'


Workaround: 

Test Case: 

Edit-By: Sannella.PA

Edit-Date:  3-Apr-84 12':38':22

Attn: Burton.pa

Assigned To: Burton.pa

In/By: 

Disposition: 

System: Windows and Graphics

Subsystem: Window System

Machine: 1100

Disk: 

Microcode Version: 

Memory Size: 

File Server: 

Server Software Version: 

Difficulty: 

Frequency: Everytime

Impact: Minor

Priority: Unlikely

Status: Open

Problem Type: Documentation

Source Files: