If 'box' is among the values returned then the other Parameter, and the rows() method must be defined. Single-element tuple ( maxcol,) to their size Methods in this widget must be able to accept a If 'flow' is among the values returned then the other If a sizing mode is missing from the set then the widget Work given the state of the widget, but many do not yet Make an effort to remove sizing modes they know will not Supported by this widget, but is not sufficient to know The sizing modes returned indicate the modes that may be _sizing, which for this class includes all three. Default implementation returns the value of sizing ( ) ¶ Returns:Ī frozenset including one or more of 'box', 'flow' and (typically when there are no other selectable widgets visible). It is still possible for non selectable widgets to have the focus Returning False does not guarantee that this widget will never be inįocus, only that this widget will usually be skipped over when changingįocus. If this method returns True then the keypress() method Set the _selectable class variable to True. Or if they are always selectable they may Subclasses may leave these is if the are not selectable, This default implementation returns _selectable. it contains something the user might want to True if this is a widget that is designed to take theįocus, i.e. Required to display the text wrapped into a target number of rows.

Or call it iteratively to calculate the minimum number of columns You can use Text.pack() to calculate the minumumĬolumns and rows required to display a text widget without wrapping, Text widgets have implemented this method. This is a new method that hasn’t been fully implemented across the Passed and the value of rows() as the maxrow when ( maxcol,) This default implementation returns the size passed, or the maxcol Implement this method and return their size when () is passed as the Size where all content could still be displayed. Returns:Ī “packed” size ( maxcol, maxrow) for this widget See Widget.render() for parameter details. Inde圎rror, making normal widgets fail the same wayĪccessing focus_position on an empty container widget would. Property for reading and setting the focus position forĬontainer widgets. This default implementationĪlways returns None, indicating that this widget has no children. Read-only property returning the child widget in focus forĬontainer widgets. Read-only property that steps through decoration widgetsĪnd returns the one at the base. Mark cached canvases rendered by this widget as dirty so that True if the position was set successfully anywhere onĬonvenience function to emit signals with self as first row ( int) – new row for the cursor, 0 it the top row of this widget.col ( int) – new column for the cursor, 0 is the left edge of this widget.size ( widget size) – See Widget.render() for details.Method is equivalent to having a method that always returns May render the cached canvas instead of creating a new one. _invalidate() to remove any cached canvases, or the widget May be defined and set to True if this widget renders the sameĬanvas regardless of the value of the focus parameter.Īny time the content of a widget changes it should call Later calls will automatically look up the value in the cache first.Īs a small optimization the class variable ignore_focus Result of this method to be cached by CanvasCache. There is some metaclass magic defined in the Widget If focus is False, the returned canvas may not have a cursor The whole surface) and container widgets return aĬompositeCanvas (one or more other canvases SolidCanvas (a single character repeated across Text widgets return a TextCanvas (arbitrary text andĭisplay attributes), SolidFill widgets return a focus ( bool) – set to True if this widget or one of its childrenĪ Canvas subclass instance containing the.Number of columns for this widget () for fixed sizing – this widget is a fixed size Size of this widget ( maxcol,) for flow sizing – the parent chooses only the

Maxcol and maxrow are integers > 0: ( maxcol, maxrow) for box sizing – the parent chooses the exact

Must be implemented by any concrete subclass Parameters: This method is not implemented in Widget but

Magic hider 1.3.1