wxruby3 0.9.0.pre.rc.3-x64-mingw-ucrt → 0.9.0-x64-mingw-ucrt

data/lib/wx/doc/gen/rtc/rich_text_box.rb

@@ -0,0 +1,423 @@
+# :stopdoc:
+# This file is automatically generated by the WXRuby3 documentation 
+# generator. Do not alter this file.
+# :startdoc:
+
+
+module Wx::RTC
+
+  # This class implements a floating or inline text box, containing paragraphs.
+  # === 
+  # 
+  # Category:  Rich Text
+  # @see Wx::RTC::RichTextParagraphLayoutBox
+  # @see  Wx::RTC::RichTextObject
+  # @see  Wx::RTC::RichTextBuffer
+  # @see  Wx::RTC::RichTextCtrl 
+  # 
+  # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  class RichTextBox < RichTextParagraphLayoutBox
+  
+    # @overload initialize(parent=nil)
+    #   Default constructor; optionally pass the parent object.
+    #   @param parent [Wx::RTC::RichTextObject] 
+    #   @return [Wx::RTC::RichTextBox]
+    # @overload initialize(obj)
+    #   Copy constructor.
+    #   @param obj [Wx::RTC::RichTextBox] 
+    #   @return [Wx::RTC::RichTextBox]
+    def initialize(*args) end
+    
+    # Draw the item, within the given range.
+    # Some objects may ignore the range (for example paragraphs) while others must obey it (lines, to implement wrapping)
+    # @param dc [Wx::DC] 
+    # @param context [Wx::RTC::RichTextDrawingContext] 
+    # @param range [Range] 
+    # @param selection [Wx::RTC::RichTextSelection] 
+    # @param rect [Wx::Rect] 
+    # @param descent [Integer] 
+    # @param style [Integer] 
+    # @return [Boolean]
+    def draw(dc, context, range, selection, rect, descent, style) end
+    
+    # Returns the XML node name of this object.
+    # This must be overridden for {Wx::XmlNode}-base XML export to work.
+    # @return [String]
+    def get_xml_node_name; end
+    alias_method :xml_node_name, :get_xml_node_name
+    
+    # Returns true if we can edit the object's properties via a GUI.
+    # @return [Boolean]
+    def can_edit_properties; end
+    alias_method :can_edit_properties?, :can_edit_properties
+    
+    # Edits the object's properties via a GUI.
+    # @param parent [Wx::Window] 
+    # @param buffer [Wx::RTC::RichTextBuffer] 
+    # @return [Boolean]
+    def edit_properties(parent, buffer) end
+    
+    # Returns the label to be used for the properties context menu item.
+    # @return [String]
+    def get_properties_menu_label; end
+    alias_method :properties_menu_label, :get_properties_menu_label
+    
+    # Clones the object.
+    # @return [Wx::RTC::RichTextObject]
+    def clone; end
+    
+    # @param obj [Wx::RTC::RichTextBox] 
+    # @return [void]
+    def copy(obj) end
+    
+  end # RichTextBox
+  
+  # {Wx::RTC::RichTextCell} is the cell in a table, in which the user can type.
+  # As well as text, it can also contain objects e.g. an image, or even another {Wx::RTC::RichTextTable}.
+  # A cell's appearance can be changed via its associated {Wx::RTC::RichTextAttr}; for example its size altered or its background colour set. It also has the properties of column- and row-span. By default these are 1, meaning that the cell only spans itself, but can be increased using the {Wx::RTC::RichTextCell#set_col_span} and {Wx::RTC::RichTextCell#set_row_span} methods. Attempts to set too large a span are silently truncated to the table edge.
+  # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  class RichTextCell < RichTextBox
+  
+    # @overload initialize(parent=nil)
+    #   Default constructor; optionally pass the parent object.
+    #   @param parent [Wx::RTC::RichTextObject] 
+    #   @return [Wx::RTC::RichTextCell]
+    # @overload initialize(obj)
+    #   Copy constructor.
+    #   @param obj [Wx::RTC::RichTextCell] 
+    #   @return [Wx::RTC::RichTextCell]
+    def initialize(*args) end
+    
+    # Draw the item, within the given range.
+    # Some objects may ignore the range (for example paragraphs) while others must obey it (lines, to implement wrapping)
+    # @param dc [Wx::DC] 
+    # @param context [Wx::RTC::RichTextDrawingContext] 
+    # @param range [Range] 
+    # @param selection [Wx::RTC::RichTextSelection] 
+    # @param rect [Wx::Rect] 
+    # @param descent [Integer] 
+    # @param style [Integer] 
+    # @return [Boolean]
+    def draw(dc, context, range, selection, rect, descent, style) end
+    
+    # Hit-testing: returns a flag indicating hit test details, plus information about position.
+    # contextObj is returned to specify what object position is relevant to, since otherwise there's an ambiguity. @ obj might not be a child of contextObj, since we may be referring to the container itself if we have no hit on a child - for example if we click outside an object.
+    # The function puts the position in textPosition if one is found. pt is in logical units (a zero y position is at the beginning of the buffer).
+    # One of the {Wx::RTC::RichTextHitTestFlags} values.
+    # @param dc [Wx::DC] 
+    # @param context [Wx::RTC::RichTextDrawingContext] 
+    # @param pt [Array(Integer, Integer), Wx::Point] 
+    # @param textPosition [Integer] 
+    # @param obj [Wx::RTC::RichTextObject] 
+    # @param contextObj [Wx::RTC::RichTextObject] 
+    # @param flags [Integer] 
+    # @return [Array(Integer,Integer)]
+    def hit_test(dc, context, pt, textPosition, obj, contextObj, flags=0) end
+    
+    # Returns the XML node name of this object.
+    # This must be overridden for {Wx::XmlNode}-base XML export to work.
+    # @return [String]
+    def get_xml_node_name; end
+    alias_method :xml_node_name, :get_xml_node_name
+    
+    # Returns true if we can edit the object's properties via a GUI.
+    # @return [Boolean]
+    def can_edit_properties; end
+    alias_method :can_edit_properties?, :can_edit_properties
+    
+    # Edits the object's properties via a GUI.
+    # @param parent [Wx::Window] 
+    # @param buffer [Wx::RTC::RichTextBuffer] 
+    # @return [Boolean]
+    def edit_properties(parent, buffer) end
+    
+    # Returns the label to be used for the properties context menu item.
+    # @return [String]
+    def get_properties_menu_label; end
+    alias_method :properties_menu_label, :get_properties_menu_label
+    
+    # Returns the number of columns spanned by the cell.
+    # By default a cell doesn't span extra columns, so this function returns 1.
+    # @see Wx::RTC::RichTextCell#set_col_span
+    # @see  Wx::RTC::RichTextCell#get_row_span 
+    # @return [Integer]
+    def get_col_span; end
+    alias_method :col_span, :get_col_span
+    
+    # Set the number of columns spanned by the cell.
+    # By default colspan is 1 i.e. a cell doesn't span extra columns. Pass a value >1 to change this. Attempting to set a colspan <1 will assert and be ignored.
+    # @see Wx::RTC::RichTextCell#get_col_span
+    # @see  Wx::RTC::RichTextCell#set_row_span 
+    # @param span [Integer] 
+    # @return [void]
+    def set_col_span(span) end
+    alias_method :col_span=, :set_col_span
+    
+    # Returns the number of rows spanned by the cell.
+    # By default a cell doesn't span extra rows, so this function returns 1.
+    # @see Wx::RTC::RichTextCell#set_row_span
+    # @see  Wx::RTC::RichTextCell#get_col_span 
+    # @return [Integer]
+    def get_row_span; end
+    alias_method :row_span, :get_row_span
+    
+    # Set the number of rows spanned by the cell.
+    # By default colspan is 1 i.e. a cell doesn't span extra rows. Pass a value >1 to change this. Attempting to set a rowspan <1 will assert and be ignored.
+    # @see Wx::RTC::RichTextCell#get_row_span
+    # @see  Wx::RTC::RichTextCell#set_col_span 
+    # @param span [Integer] 
+    # @return [void]
+    def set_row_span(span) end
+    alias_method :row_span=, :set_row_span
+    
+    # Clones the object.
+    # @return [Wx::RTC::RichTextObject]
+    def clone; end
+    
+    # @param obj [Wx::RTC::RichTextCell] 
+    # @return [void]
+    def copy(obj) end
+    
+  end # RichTextCell
+  
+  # {Wx::RTC::RichTextTable} represents a table with arbitrary columns and rows.
+  # 
+  # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  class RichTextTable < RichTextBox
+  
+    # @overload initialize(parent=nil)
+    #   Default constructor; optionally pass the parent object.
+    #   @param parent [Wx::RTC::RichTextObject] 
+    #   @return [Wx::RTC::RichTextTable]
+    # @overload initialize(obj)
+    #   Copy constructor.
+    #   @param obj [Wx::RTC::RichTextTable] 
+    #   @return [Wx::RTC::RichTextTable]
+    def initialize(*args) end
+    
+    # Draw the item, within the given range.
+    # Some objects may ignore the range (for example paragraphs) while others must obey it (lines, to implement wrapping)
+    # @param dc [Wx::DC] 
+    # @param context [Wx::RTC::RichTextDrawingContext] 
+    # @param range [Range] 
+    # @param selection [Wx::RTC::RichTextSelection] 
+    # @param rect [Wx::Rect] 
+    # @param descent [Integer] 
+    # @param style [Integer] 
+    # @return [Boolean]
+    def draw(dc, context, range, selection, rect, descent, style) end
+    
+    # Hit-testing: returns a flag indicating hit test details, plus information about position.
+    # contextObj is returned to specify what object position is relevant to, since otherwise there's an ambiguity. @ obj might not be a child of contextObj, since we may be referring to the container itself if we have no hit on a child - for example if we click outside an object.
+    # The function puts the position in textPosition if one is found. pt is in logical units (a zero y position is at the beginning of the buffer).
+    # One of the {Wx::RTC::RichTextHitTestFlags} values.
+    # @param dc [Wx::DC] 
+    # @param context [Wx::RTC::RichTextDrawingContext] 
+    # @param pt [Array(Integer, Integer), Wx::Point] 
+    # @param textPosition [Integer] 
+    # @param obj [Wx::RTC::RichTextObject] 
+    # @param contextObj [Wx::RTC::RichTextObject] 
+    # @param flags [Integer] 
+    # @return [Array(Integer,Integer)]
+    def hit_test(dc, context, pt, textPosition, obj, contextObj, flags=0) end
+    
+    # Returns the XML node name of this object.
+    # This must be overridden for {Wx::XmlNode}-base XML export to work.
+    # @return [String]
+    def get_xml_node_name; end
+    alias_method :xml_node_name, :get_xml_node_name
+    
+    # Lay the item out at the specified position with the given size constraint.
+    # Layout must set the cached size. rect is the available space for the object, and parentRect is the container that is used to determine a relative size or position (for example if a text box must be 50% of the parent text box).
+    # @param dc [Wx::DC] 
+    # @param context [Wx::RTC::RichTextDrawingContext] 
+    # @param rect [Wx::Rect] 
+    # @param parentRect [Wx::Rect] 
+    # @param style [Integer] 
+    # @return [Boolean]
+    def layout(dc, context, rect, parentRect, style) end
+    
+    # Returns the object size for the given range.
+    # Returns false if the range is invalid for this object.
+    # @param range [Range] 
+    # @param size [Array(Integer, Integer), Wx::Size] 
+    # @param descent [int] 
+    # @param dc [Wx::DC] 
+    # @param context [Wx::RTC::RichTextDrawingContext] 
+    # @param flags [Integer] 
+    # @param position [Array(Integer, Integer), Wx::Point] 
+    # @param parentSize [Array(Integer, Integer), Wx::Size] 
+    # @param partialExtents [Array,nil] 
+    # @return [Boolean]
+    def get_range_size(range, size, descent, dc, context, flags, position=(Wx::Point.new(0, 0)), parentSize=Wx::DEFAULT_SIZE, partialExtents=nil) end
+    alias_method :range_size, :get_range_size
+    
+    # Deletes the given range.
+    # @param range [Range] 
+    # @return [Boolean]
+    def delete_range(range) end
+    
+    # Returns any text in this object for the given range.
+    # @param range [Range] 
+    # @return [String]
+    def get_text_for_range(range) end
+    alias_method :text_for_range, :get_text_for_range
+    
+    # Imports this object from XML.
+    # @param buffer [Wx::RTC::RichTextBuffer] 
+    # @param node [Wx::XmlNode] 
+    # @param handler [Wx::RTC::RichTextXMLHandler] 
+    # @param recurse [Boolean] 
+    # @return [Array(Boolean,Boolean)]
+    def import_from_xml(buffer, node, handler, recurse) end
+    
+    # Finds the absolute position and row height for the given character position.
+    # @param dc [Wx::DC] 
+    # @param context [Wx::RTC::RichTextDrawingContext] 
+    # @param index [Integer] 
+    # @param pt [Array(Integer, Integer), Wx::Point] 
+    # @param height [int] 
+    # @param forceLineStart [Boolean] 
+    # @return [Boolean]
+    def find_position(dc, context, index, pt, height, forceLineStart) end
+    
+    # Calculates the range of the object.
+    # By default, guess that the object is 1 unit long.
+    # @param start [Integer] 
+    # @param end_ [Integer] 
+    # @return [Integer]
+    def calculate_range(start, end_) end
+    
+    # Returns true if this object can handle the selections of its children, fOr example a table.
+    # Required for composite selection handling to work.
+    # @return [Boolean]
+    def handles_child_selections; end
+    
+    # Returns a selection object specifying the selections between start and end character positions.
+    # For example, a table would deduce what cells (of range length 1) are selected when dragging across the table.
+    # @param start [Integer] 
+    # @param end_ [Integer] 
+    # @return [Wx::RTC::RichTextSelection]
+    def get_selection(start, end_) end
+    alias_method :selection, :get_selection
+    
+    # Returns true if we can edit the object's properties via a GUI.
+    # @return [Boolean]
+    def can_edit_properties; end
+    alias_method :can_edit_properties?, :can_edit_properties
+    
+    # Edits the object's properties via a GUI.
+    # @param parent [Wx::Window] 
+    # @param buffer [Wx::RTC::RichTextBuffer] 
+    # @return [Boolean]
+    def edit_properties(parent, buffer) end
+    
+    # Returns the label to be used for the properties context menu item.
+    # @return [String]
+    def get_properties_menu_label; end
+    alias_method :properties_menu_label, :get_properties_menu_label
+    
+    # Returns true if objects of this class can accept the focus, i.e. a call to SetFocusObject is possible.
+    # For example, containers supporting text, such as a text box object, can accept the focus, but a table can't (set the focus to individual cells instead).
+    # @return [Boolean]
+    def accepts_focus; end
+    
+    # Returns the cells array.
+    # @return [Array<Array<Wx::RTC::RichTextObject>>]
+    def get_cells; end
+    alias_method :cells, :get_cells
+    
+    # Returns the row count.
+    # @return [Integer]
+    def get_row_count; end
+    alias_method :row_count, :get_row_count
+    
+    # Returns the column count.
+    # @return [Integer]
+    def get_column_count; end
+    alias_method :column_count, :get_column_count
+    
+    # @overload get_cell(row, col)
+    #   Returns the cell at the given row/column position.
+    #   @param row [Integer] 
+    #   @param col [Integer] 
+    #   @return [Wx::RTC::RichTextCell]
+    # @overload get_cell(pos)
+    #   Returns the cell at the given character position (in the range of the table).
+    #   @param pos [Integer] 
+    #   @return [Wx::RTC::RichTextCell]
+    def get_cell(*args) end
+    alias_method :cell, :get_cell
+    
+    # Returns the row/column for a given character position.
+    # @param pos [Integer] 
+    # @return [Array(Boolean,Integer,Integer)]
+    def get_cell_row_column_position(pos) end
+    alias_method :cell_row_column_position, :get_cell_row_column_position
+    
+    # Returns the coordinates of the cell with keyboard focus, or (-1,-1) if none.
+    # @return [Array(Integer,Integer)]
+    def get_focused_cell; end
+    alias_method :focused_cell, :get_focused_cell
+    
+    # Clears the table.
+    # @return [void]
+    def clear_table; end
+    
+    # Creates a table of the given dimensions.
+    # @param rows [Integer] 
+    # @param cols [Integer] 
+    # @return [Boolean]
+    def create_table(rows, cols) end
+    
+    # Sets the attributes for the cells specified by the selection.
+    # @param selection [Wx::RTC::RichTextSelection] 
+    # @param style [Wx::RTC::RichTextAttr] 
+    # @param flags [Integer] 
+    # @return [Boolean]
+    def set_cell_style(selection, style, flags=Wx::RTC::RICHTEXT_SETSTYLE_WITH_UNDO) end
+    
+    # Deletes rows from the given row position.
+    # @param startRow [Integer] 
+    # @param noRows [Integer] 
+    # @return [Boolean]
+    def delete_rows(startRow, noRows=1) end
+    
+    # Deletes columns from the given column position.
+    # @param startCol [Integer] 
+    # @param noCols [Integer] 
+    # @return [Boolean]
+    def delete_columns(startCol, noCols=1) end
+    
+    # Adds rows from the given row position.
+    # @param startRow [Integer] 
+    # @param noRows [Integer] 
+    # @param attr [Wx::RTC::RichTextAttr] 
+    # @return [Boolean]
+    def add_rows(startRow, noRows=1, attr=(Wx::RichTextAttr.new())) end
+    
+    # Adds columns from the given column position.
+    # @param startCol [Integer] 
+    # @param noCols [Integer] 
+    # @param attr [Wx::RTC::RichTextAttr] 
+    # @return [Boolean]
+    def add_columns(startCol, noCols=1, attr=(Wx::RichTextAttr.new())) end
+    
+    # Clones the object.
+    # @return [Wx::RTC::RichTextObject]
+    def clone; end
+    
+    # @param obj [Wx::RTC::RichTextTable] 
+    # @return [void]
+    def copy(obj) end
+    
+  end # RichTextTable
+  
+
+end