Struct sourceview5::Map

pub struct Map { /* private fields */ }

Widget that displays a map for a specific View.

Map is a widget that maps the content of a View into a smaller view so the user can have a quick overview of the whole document.

This works by connecting a View to to the Map using the view property or MapExt::set_view().

Map is a View object. This means that you can add a GutterRenderer to a gutter in the same way you would for a View. One example might be a GutterRenderer that shows which lines have changed in the document.

Additionally, it is desirable to match the font of the Map and the View used for editing. Therefore, font-desc should be used to set the target font. You will need to adjust this to the desired font size for the map. A 1pt font generally seems to be an appropriate font size. “Monospace 1” is the default. See [pango::FontDescription::set_size()][crate::pango::FontDescription::set_size()] for how to alter the size of an existing [pango::FontDescription][crate::pango::FontDescription].

When FontConfig is available, Map will try to use a bundled “block” font to make the map more legible.

Properties

font-desc

Readable | Writeable

view

Readable | Writeable

View

auto-indent

Readable | Writeable

background-pattern

Draw a specific background pattern on the view.

Readable | Writeable

completion

The completion object associated with the view

Readable

enable-snippets

The property denotes if snippets should be expanded when the user presses Tab after having typed a word matching the snippets found in SnippetManager.

The user may tab through focus-positions of the snippet if any are available by pressing Tab repeatedly until the desired focus position is selected.

Readable | Writeable

highlight-current-line

Readable | Writeable

indent-on-tab

Readable | Writeable

indent-width

Width of an indentation step expressed in number of spaces.

Readable | Writeable

indenter

The property is a Indenter to use to indent as the user types into the View.

Readable | Writeable

insert-spaces-instead-of-tabs

Readable | Writeable

right-margin-position

Position of the right margin.

Readable | Writeable

show-line-marks

Whether to display line mark pixbufs

Readable | Writeable

show-line-numbers

Whether to display line numbers

Readable | Writeable

show-right-margin

Whether to display the right margin.

Readable | Writeable

smart-backspace

Whether smart Backspace should be used.

Readable | Writeable

smart-home-end

Set the behavior of the HOME and END keys.

Readable | Writeable

space-drawer

The SpaceDrawer object associated with the view.4

Readable

tab-width

Width of a tab character expressed in number of spaces.

Readable | Writeable

TextView

accepts-tab

Whether Tab will result in a tab character being entered.

Readable | Writeable

bottom-margin

The bottom margin for text in the text view.

Note that this property is confusingly named. In CSS terms, the value set here is padding, and it is applied in addition to the padding from the theme.

Don’t confuse this property with margin-bottom.

Readable | Writeable

buffer

The buffer which is displayed.

Readable | Writeable

cursor-visible

If the insertion cursor is shown.

Readable | Writeable

editable

Whether the text can be modified by the user.

Readable | Writeable

extra-menu

A menu model whose contents will be appended to the context menu.

Readable | Writeable

im-module

Which IM (input method) module should be used for this text_view.

See Gtk::IMMulticontext.

Setting this to a non-None value overrides the system-wide IM module setting. See the GtkSettings [gtk-im-module][struct@crate::Gtk::Settings#gtk-im-module] property.

Readable | Writeable

indent

Amount to indent the paragraph, in pixels.

A negative value of indent will produce a hanging indentation. That is, the first line will have the full width, and subsequent lines will be indented by the absolute value of indent.

Readable | Writeable

input-hints

Additional hints (beyond input-purpose) that allow input methods to fine-tune their behaviour.

Readable | Writeable

input-purpose

The purpose of this text field.

This property can be used by on-screen keyboards and other input methods to adjust their behaviour.

Readable | Writeable

justification

Left, right, or center justification.

Readable | Writeable

left-margin

The default left margin for text in the text view.

Tags in the buffer may override the default.

Note that this property is confusingly named. In CSS terms, the value set here is padding, and it is applied in addition to the padding from the theme.

Readable | Writeable

monospace

Whether text should be displayed in a monospace font.

If true, set the .monospace style class on the text view to indicate that a monospace font is desired.

Readable | Writeable

overwrite

Whether entered text overwrites existing contents.

Readable | Writeable

pixels-above-lines

Pixels of blank space above paragraphs.

Readable | Writeable

pixels-below-lines

Pixels of blank space below paragraphs.

Readable | Writeable

pixels-inside-wrap

Pixels of blank space between wrapped lines in a paragraph.

Readable | Writeable

right-margin

The default right margin for text in the text view.

Tags in the buffer may override the default.

Note that this property is confusingly named. In CSS terms, the value set here is padding, and it is applied in addition to the padding from the theme.

Readable | Writeable

tabs

Custom tabs for this text.

Readable | Writeable

top-margin

The top margin for text in the text view.

Note that this property is confusingly named. In CSS terms, the value set here is padding, and it is applied in addition to the padding from the theme.

Don’t confuse this property with margin-top.

Readable | Writeable

wrap-mode

Whether to wrap lines never, at word boundaries, or at character boundaries.

Readable | Writeable

Widget

can-focus

Whether the widget or any of its descendents can accept the input focus.

This property is meant to be set by widget implementations, typically in their instance init function.

Readable | Writeable

can-target

Whether the widget can receive pointer events.

Readable | Writeable

css-classes

A list of css classes applied to this widget.

Readable | Writeable

css-name

The name of this widget in the CSS tree.

This property is meant to be set by widget implementations, typically in their instance init function.

Readable | Writeable | Construct Only

cursor

The cursor used by @widget.

Readable | Writeable

focus-on-click

Whether the widget should grab focus when it is clicked with the mouse.

This property is only relevant for widgets that can take focus.

Readable | Writeable

focusable

Whether this widget itself will accept the input focus.

Readable | Writeable

halign

How to distribute horizontal space if widget gets extra space.

Readable | Writeable

has-default

Whether the widget is the default widget.

Readable

has-focus

Whether the widget has the input focus.

Readable

has-tooltip

Enables or disables the emission of the ::query-tooltip signal on @widget.

A value of true indicates that @widget can have a tooltip, in this case the widget will be queried using query-tooltip to determine whether it will provide a tooltip or not.

Readable | Writeable

height-request

Override for height request of the widget.

If this is -1, the natural request will be used.

Readable | Writeable

hexpand

Whether to expand horizontally.

Readable | Writeable

hexpand-set

Whether to use the hexpand property.

Readable | Writeable

layout-manager

The gtk::LayoutManager instance to use to compute the preferred size of the widget, and allocate its children.

This property is meant to be set by widget implementations, typically in their instance init function.

Readable | Writeable

margin-bottom

Margin on bottom side of widget.

This property adds margin outside of the widget’s normal size request, the margin will be added in addition to the size from [WidgetExtManual::set_size_request()][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.

Readable | Writeable

margin-end

Margin on end of widget, horizontally.

This property supports left-to-right and right-to-left text directions.

This property adds margin outside of the widget’s normal size request, the margin will be added in addition to the size from [WidgetExtManual::set_size_request()][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.

Readable | Writeable

margin-start

Margin on start of widget, horizontally.

This property supports left-to-right and right-to-left text directions.

This property adds margin outside of the widget’s normal size request, the margin will be added in addition to the size from [WidgetExtManual::set_size_request()][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.

Readable | Writeable

margin-top

Margin on top side of widget.

This property adds margin outside of the widget’s normal size request, the margin will be added in addition to the size from [WidgetExtManual::set_size_request()][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.

Readable | Writeable

name

The name of the widget.

Readable | Writeable

opacity

The requested opacity of the widget.

Readable | Writeable

overflow

How content outside the widget’s content area is treated.

This property is meant to be set by widget implementations, typically in their instance init function.

Readable | Writeable

parent

The parent widget of this widget.

Readable

receives-default

Whether the widget will receive the default action when it is focused.

Readable | Writeable

root

The GtkRoot widget of the widget tree containing this widget.

This will be None if the widget is not contained in a root widget.

Readable

scale-factor

The scale factor of the widget.

Readable

sensitive

Whether the widget responds to input.

Readable | Writeable

tooltip-markup

Sets the text of tooltip to be the given string, which is marked up with Pango markup.

Also see Gtk::Tooltip::set_markup().

This is a convenience property which will take care of getting the tooltip shown if the given string is not None: has-tooltip will automatically be set to true and there will be taken care of query-tooltip in the default signal handler.

Note that if both tooltip-text and tooltip-markup are set, the last one wins.

Readable | Writeable

tooltip-text

Sets the text of tooltip to be the given string.

Also see Gtk::Tooltip::set_text().

This is a convenience property which will take care of getting the tooltip shown if the given string is not None: has-tooltip will automatically be set to true and there will be taken care of query-tooltip in the default signal handler.

Note that if both tooltip-text and tooltip-markup are set, the last one wins.

Readable | Writeable

valign

How to distribute vertical space if widget gets extra space.

Readable | Writeable

vexpand

Whether to expand vertically.

Readable | Writeable

vexpand-set

Whether to use the vexpand property.

Readable | Writeable

visible

Whether the widget is visible.

Readable | Writeable

width-request

Override for width request of the widget.

If this is -1, the natural request will be used.

Readable | Writeable

Accessible

accessible-role

The accessible role of the given gtk::Accessible implementation.

The accessible role cannot be changed once set.

Readable | Writeable

Scrollable

hadjustment

Horizontal gtk::Adjustment of the scrollable widget.

This adjustment is shared between the scrollable widget and its parent.

Readable | Writeable | Construct

hscroll-policy

Determines when horizontal scrolling should start.

Readable | Writeable

vadjustment

Vertical gtk::Adjustment of the scrollable widget.

This adjustment is shared between the scrollable widget and its parent.

Readable | Writeable | Construct

vscroll-policy

Determines when vertical scrolling should start.

Readable | Writeable

Implements

MapExt, ViewExt, gtk::prelude::TextViewExt, gtk::prelude::WidgetExt, [trait@glib::ObjectExt], gtk::prelude::AccessibleExt, gtk::prelude::BuildableExt, gtk::prelude::ConstraintTargetExt, gtk::prelude::ScrollableExt, ViewManualExt

GLib type: GObject with reference counted clone semantics.

Implementations

impl Map

pub const NONE: Option<&'static Map> = None

pub fn new() -> Map

Creates a new Map.

Returns

a new #GtkSourceMap.

pub fn builder() -> MapBuilder

Creates a new builder-pattern struct instance to construct Map objects.

This method returns an instance of MapBuilder which can be used to create Map objects.

Trait Implementations

impl Clone for Map

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Map

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Map

fn default() -> Self

Returns the “default value” for a type.

impl HasParamSpec for Map

type ParamSpec = ParamSpecObject

type SetValue = Map

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, Map>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for Map

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Hashes the memory address of this object.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Map

fn cmp(&self, other: &Self) -> Ordering

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl ParentClassIs for Map

type Parent = View

impl<OT: ObjectType> PartialEq<OT> for Map

fn eq(&self, other: &OT) -> bool

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for Map

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for Map

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for Map

impl IsA<Accessible> for Map

impl IsA<Buildable> for Map

impl IsA<ConstraintTarget> for Map

impl IsA<Scrollable> for Map

impl IsA<TextView> for Map

impl IsA<View> for Map

impl IsA<Widget> for Map