The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

PyFrame Guide to wxPython

Copyright and License information Home

__ A B C D E F G H I L M P R S T U V W

wxStyledTextCtrl - Long Line Indicators

  • GetEdgeColour

  • GetEdgeColumn

  • GetEdgeMode

  • SetEdgeColour

  • SetEdgeColumn

  • SetEdgeMode

Summary:

You may wish to have your user see whether or not she is exceeding some preset line length limit, without actually cutting off the text. The methods in this section allow you to do this.

You set a threshold with SetEdgeColumn. You can choose to use a vertical line or to display the remainder of the line with a background color. Normally, both of these modes are off, and there's no over-length indication. You set the color of the line or highlight with SetEdgeColour.

WxPython has some defined variables you can use to pass in parameters or test against return values:

 wxSTC_EDGE_BACKGROUND  : highlight the text of the rest of the line
 wxSTC_EDGE_LINE        : display vertical line at threshold
 wxSTC_EDGE_NONE        : inactive (default)

The Scintilla documentation states: "The vertical line works well for monospaced fonts but not for proportional fonts which should use EDGE_BACKGROUND." This author has found these long-line indicators to be problematic in all cases, but this may not hold true for you.

----

GetEdgeColour()

Retrieve the color used in edge indication. The returned value is a wxColour.

top

----

GetEdgeColumn()

Retrieve an integer with the column number which text should be kept within.

top

----

GetEdgeMode()

Returns an integer with the edge highlight mode.

 wxSTC_EDGE_BACKGROUND  : highlight the text of the rest of the line
 wxSTC_EDGE_LINE        : display vertical line at threshold
 wxSTC_EDGE_NONE        : inactive

top

----

SetEdgeColour(edgeColour)

Sets the color to use for edge highlighting. The color value edgeColour must be a wxColour object, a #RRGGBB string, or a color spec like "white". Return value is None.

top

----

SetEdgeColumn(column)

The integer value column sets the column threshold. Returns None.

top

----

SetEdgeMode(mode)

Sets the edge mode. The default when the STC is instantiated is wxSTC_EDGE_NONE, i.e., inactive. The integer value mode is one of:

 wxSTC_EDGE_BACKGROUND  : highlight the text of the rest of the line
 wxSTC_EDGE_LINE        : display vertical line at threshold
 wxSTC_EDGE_NONE        : inactive

top

----