AGW Logo

agw_title AuiSingleDockingGuide

A docking guide window for single docking hint (not diamond-shaped HUD).

hierarchy Inheritance Diagram

Inheritance diagram for: AuiSingleDockingGuide

Inheritance diagram of AuiSingleDockingGuide


method_summary Methods Summary

__init__Default class constructor.
AeroMoveMoves the docking window to the new position.
CreateShapesWithStyleCreates the docking guide window shape based on which docking bitmaps are used.
HitTestChecks if the mouse position is inside the target window rect.
IsValidReturns whether the docking direction is valid.
SetGuideShapeSets the correct shape for the docking guide window.
SetShapeIf the platform supports it, sets the shape of the window to that depicted by region.
SetValidSets the docking direction as valid or invalid.
UpdateDockGuideUpdates the docking guide images depending on the mouse position, using focused images if the mouse is inside the docking guide or unfocused images if it is outside.

API Class API

class AuiSingleDockingGuide(AuiDockingGuide)[source]

A docking guide window for single docking hint (not diamond-shaped HUD).



__init__(parent, direction=0)[source]

Default class constructor. Used internally, do not call it in your code!

Parameters:
  • parent – the AuiSingleDockingGuide parent;
  • direction – one of wx.TOP, wx.BOTTOM, wx.LEFT, wx.RIGHT.


AeroMove(pos)[source]

Moves the docking window to the new position. Overridden in children classes.

Parameters:pos – the new docking guide position.


CreateShapesWithStyle(useWhidbey)[source]

Creates the docking guide window shape based on which docking bitmaps are used.

Parameters:useWhidbey – if True, use Whidbey-style bitmaps; if False, use the Aero-style bitmaps.


HitTest(x, y)[source]

Checks if the mouse position is inside the target window rect.

Parameters:
  • x – the x mouse position;
  • y – the y mouse position.


IsValid()[source]

Returns whether the docking direction is valid.



SetGuideShape(event=None)[source]

Sets the correct shape for the docking guide window.

Parameters:event – on wxGTK, a wx.WindowCreateEvent event to process.


SetShape(region)[source]

If the platform supports it, sets the shape of the window to that depicted by region. The system will not display or respond to any mouse event for the pixels that lie outside of the region. To reset the window to the normal rectangular shape simply call SetShape again with an empty region.

Parameters:region – the shape of the frame.

Note

Overridden for wxMac.



SetValid(valid)[source]

Sets the docking direction as valid or invalid.

Parameters:valid – whether the docking direction is allowed or not.


UpdateDockGuide(pos)[source]

Updates the docking guide images depending on the mouse position, using focused images if the mouse is inside the docking guide or unfocused images if it is outside.

Parameters:pos – a wx.Point mouse position.
Tree

Table Of Contents

Previous topic

AuiPaneInfo

Next topic

aui.framemanager functions