get-view

Gets the the visible region of the editor within its display (in editor coordinates), or the overall size of the viewing region in the editor's top-level display (for an embedded editor).

If the display is an editor canvas, see also reflow-container. The viewing area within an editor canvas is not the full client area of the canvas, because an editor canvas installs a whitespace border around a displayed editor within the client area.

The calculation of the editor's visible region is based on the current size and scrollbar values of the top-level display. For an editor canvas display, the region reported by get-view does not depend on whether the canvas is hidden, obscured by other windows, or moved off the edge of the screen.

• (send an-editor-admin get-view x y w h full?) -> void
      x : boxed real number or #f
      y : boxed real number or #f
      w : boxed non-negative real number or #f
      h : boxed non-negative real number or #f
      full? = #f : boolean

  The x box is filled with the left edge of the visible region in editor coordinates, unless x is #f. The y box is filled with the top edge of the visible region in editor coordinates, unless y is #f. The w box is filled with the width of the visible region, which may be larger than the editor itself, unless w is #f. The h box is filled with the height of the visible region, which may be larger than the editor itself, unless h is #f.

  If an editor is fully visible and full? is #f, then x and y will both be filled with 0.

  If full? is a true value, then the returned area is the view area of the top-level display for the editor. This result is different only when the editor is embedded in another editor; in that case, the x and y values may be meaningless, because they are in the coordinate system of the immediate editor within the top-level display.