Phoenix Logo

phoenix_title wx.lib.agw.pyprogress.ProgressGauge

This class provides a visual alternative for Gauge.


class_hierarchy Class Hierarchy

Inheritance diagram for class ProgressGauge:


super_classes Known Superclasses

wx.Window


method_summary Methods Summary

__init__ Default class constructor.
DrawProgress Actually draws the sliding bar.
GetFirstGradientColour Returns the first gradient colour.
GetGaugeBackground Returns the gauge background colour.
GetGaugeProportion Returns the relative proportion between the sliding bar and the
GetGaugeSteps Returns the number of steps the gauge performs before switching from
GetSecondGradientColour Returns the second gradient colour.
OnEraseBackground Handles the wx.EVT_ERASE_BACKGROUND event for ProgressGauge.
OnPaint Handles the wx.EVT_PAINT event for ProgressGauge.
SetFirstGradientColour Sets the first gradient colour.
SetGaugeBackground Sets the gauge background colour.
SetGaugeProportion Sets the relative proportion between the sliding bar and the
SetGaugeSteps Sets the number of steps the gauge performs before switching from
SetSecondGradientColour Sets the second gradient colour.
Update Updates the gauge with a new value.

api Class API



class ProgressGauge(wx.Window)

This class provides a visual alternative for Gauge.


Methods



__init__(self, parent, id=wx.ID_ANY, pos=wx.DefaultPosition, size=(-1, 30))

Default class constructor.

Parameters:
  • parent – parent window. Must not be None;
  • id – window identifier. A value of -1 indicates a default value;
  • pos – the control position. A value of (-1, -1) indicates a default position, chosen by either the windowing system or wxPython, depending on platform;
  • size – the control size. A value of (-1, -1) indicates a default size, chosen by either the windowing system or wxPython, depending on platform.


DrawProgress(self, dc, xsize, ysize, increment)

Actually draws the sliding bar.

Parameters:
  • dc – an instance of wx.DC;
  • xsize – the width of the whole progress bar;
  • ysize – the height of the whole progress bar;
  • increment – a positive value if we are spinning from left to right, a negative one if we are spinning from right to left.


GetFirstGradientColour(self)

Returns the first gradient colour.



GetGaugeBackground(self)

Returns the gauge background colour.



GetGaugeProportion(self)

Returns the relative proportion between the sliding bar and the whole gauge.



GetGaugeSteps(self)

Returns the number of steps the gauge performs before switching from forward to backward (or vice-versa) movement.



GetSecondGradientColour(self)

Returns the second gradient colour.



OnEraseBackground(self, event)

Handles the wx.EVT_ERASE_BACKGROUND event for ProgressGauge.

Parameters:event – a EraseEvent event to be processed.

Note

This method is intentionally empty to reduce flicker.



OnPaint(self, event)

Handles the wx.EVT_PAINT event for ProgressGauge.

Parameters:event – a PaintEvent event to be processed.


SetFirstGradientColour(self, colour)

Sets the first gradient colour.

Parameters:colour – a valid wx.Colour object.


SetGaugeBackground(self, colour)

Sets the gauge background colour.

Parameters:colour – a valid wx.Colour object.


SetGaugeProportion(self, proportion)

Sets the relative proportion between the sliding bar and the whole gauge.

Parameters:proportion – a floating point number representing the relative proportion between the sliding bar and the whole gauge.


SetGaugeSteps(self, steps)

Sets the number of steps the gauge performs before switching from forward to backward (or vice-versa) movement.

Parameters:steps – the number of steps the gauge performs before switching from forward to backward (or vice-versa) movement.


SetSecondGradientColour(self, colour)

Sets the second gradient colour.

Parameters:colour – a valid wx.Colour object.


Update(self)

Updates the gauge with a new value.