PGScrollFrame

from panda3d.core import PGScrollFrame
class PGScrollFrame

Bases: PGVirtualFrame, PGSliderBarNotify

This is a special kind of frame that pretends to be much larger than it actually is. You can scroll through the frame, as if you’re looking through a window at the larger frame beneath. All children of this frame node are scrolled and clipped as if they were children of the larger, virtual frame.

This is implemented as a specialization of PGVirtualFrame, which handles the meat of the virtual canvas. This class adds automatic support for scroll bars, and restricts the virtual transform to translate only (no scale or rotate).

Inheritance diagram

Inheritance diagram of PGScrollFrame

__init__(name: str)
clearHorizontalSlider()None

Removes the horizontal scroll bar from control of the frame. It is your responsibility to actually remove or hide the object itself.

clearVerticalSlider()None

Removes the vertical scroll bar from control of the frame. It is your responsibility to actually remove or hide the object itself.

clearVirtualFrame()None

Removes the virtual frame from the item. This effectively sets the virtual frame to the same size as the clip frame. Scrolling will no longer be possible.

getAutoHide()bool

Returns the auto_hide flag. See setAutoHide().

static getClassType()TypeHandle
getHorizontalSlider()PGSliderBar

Returns the PGSliderBar that serves as the horizontal scroll bar for this frame, if any, or NULL if it is not set.

getManagePieces()bool

Returns the manage_pieces flag. See setManagePieces().

getVerticalSlider()PGSliderBar

Returns the PGSliderBar that serves as the vertical scroll bar for this frame, if any, or NULL if it is not set.

getVirtualFrame()LVecBase4

Returns the bounding rectangle of the virtual frame. See setVirtualFrame(). If hasVirtualFrame() is false, this returns the item’s clip frame.

hasVirtualFrame()bool

Returns true if the virtual frame has a bounding rectangle; see setVirtualFrame(). Most PGScrollFrame objects will have a virtual frame.

recompute()None

Forces the PGScrollFrame to recompute itself right now. Normally this should not be required.

remanage()None

Manages the position and size of the scroll bars. Normally this should not need to be called directly.

setAutoHide(auto_hide: bool)None

Sets the auto_hide flag. When this is true, the two scroll bars are automatically hidden if they are not needed (that is, if the virtual frame would fit within the clip frame without them), and they are automatically shown when they are needed.

Setting this flag true forces the manage_pieces flag to also be set true.

setHorizontalSlider(horizontal_slider: PGSliderBar)None

Sets the PGSliderBar object that will serve as the horizontal scroll bar for this frame. It is your responsibility to parent this slider bar to the frame and move it to the appropriate place.

setManagePieces(manage_pieces: bool)None

Sets the manage_pieces flag. When this is true, the sub-pieces of the scroll frame–that is, the two scroll bars–are automatically positioned and/or resized when the scroll frame’s overall frame is changed. They are also automatically resized to fill in the gap when one or the other is hidden.

setVerticalSlider(vertical_slider: PGSliderBar)None

Sets the PGSliderBar object that will serve as the vertical scroll bar for this frame. It is your responsibility to parent this slider bar to the frame and move it to the appropriate place.

setVirtualFrame(virtual_frame: LVecBase4)None

Sets the bounding rectangle of the virtual frame. This is the size of the large, virtual canvas which we can see only a portion of at any given time.

setVirtualFrame(left: float, right: float, bottom: float, top: float)None

Sets the bounding rectangle of the virtual frame. This is the size of the large, virtual canvas which we can see only a portion of at any given time.

setup(width: float, height: float, left: float, right: float, bottom: float, top: float, slider_width: float, bevel: float)None

Creates a PGScrollFrame with the indicated dimensions, and the indicated virtual frame.