c++ - Gtkmm scroll_to() 目的

Question

我想知道这个成员函数的 scroll_to(TextBuffer::iterator& iter, double within_margin = 0)参数 within_margin。 API 是这样说的:

The effective screen for purposes of this function is reduced by a margin of size within_margin.
...
Parameters
within_margin margin as a [0.0,0.5] fraction of screen size.

我只是不明白。这个参数在什么时候以及什么时候修改行为？ Gtk 的每种语言绑定(bind)都包含相同的描述。我写了一个小应用程序，因此您可以自己将传递的参数更改为参数。

#include <gtkmm.h>
#include <iostream>
#include <string>
using namespace std;

Gtk::TextView* text_view;
void on_add_button_clicked();
void on_scroll_button_clicked();

int main(int argc, char* argv[]) {
    Glib::RefPtr<Gtk::Application> app = Gtk::Application::create(argc, argv, "org.gtkmm.examples.base");
    Gtk::Window window;
    Glib::RefPtr<Gdk::Monitor> primary_monitor = window.get_screen()->get_display()->get_primary_monitor();
    Gdk::Rectangle monitor_size;
    primary_monitor->get_geometry(monitor_size);
    // half-size of primary-monitor
    int width = monitor_size.get_width() / 2;
    int height = monitor_size.get_height() / 2;

    window.set_default_size(width, height);
    window.set_title(__FILE__);

    Gtk::Grid grid;
    grid.set_row_spacing(5);
    grid.set_column_spacing(5);
    
    Gtk::ScrolledWindow scroll_window;
    text_view = new Gtk::TextView();
    text_view->set_editable(true);
    scroll_window.add(*text_view);
    scroll_window.set_policy(Gtk::POLICY_AUTOMATIC, Gtk::POLICY_AUTOMATIC);
    scroll_window.set_hexpand(true);
    scroll_window.set_vexpand(true);
    Glib::RefPtr<Gtk::TextBuffer> text_buffer = text_view->get_buffer();
    text_buffer->set_text("Hello!\n");
    text_view->set_buffer(text_buffer);
    grid.attach(scroll_window, 0, 0, 2, 2);
    

    Gtk::Button add_button("add text");
    add_button.signal_clicked().connect(sigc::ptr_fun(&on_add_button_clicked));
    grid.attach_next_to(add_button, scroll_window, Gtk::POS_BOTTOM, 1, 1);

    Gtk::Button scroll_button("scroll to somewhere");
    scroll_button.signal_clicked().connect(sigc::ptr_fun(&on_scroll_button_clicked));
    grid.attach_next_to(scroll_button, add_button, Gtk::POS_RIGHT, 1, 1);

    window.add(grid);
    window.show_all();

    return app->run(window);
}


void on_add_button_clicked() {
    Glib::RefPtr<Gtk::TextBuffer> text_buffer = text_view->get_buffer();
    for (int i = 0; i != 100; ++i) {
        text_buffer->insert_at_cursor("foobar\n");
    }
}

void on_scroll_button_clicked() {
    Glib::RefPtr<Gtk::TextBuffer> text_buffer = text_view->get_buffer();
    Gtk::TextBuffer::iterator it = text_buffer->end();
    text_view->scroll_to(it, 0.49);
}

您可以使用 g++ -o scroll scroll.cpp -Wall -pedantic-errors `pkg-config gtkmm-3.0 --cflags --libs` 编译代码。

谢谢

Answer 1

如果 margin 为 0，则 scroll_to() 可以自由地将目标放在屏幕中的任何位置。例如，如果 margin 为 0.45，则 scroll_to() 会将目标放在屏幕中间 10% 的位置，如果可能的话。

您在示例中看不到这一点的原因是因为您正在滚动到结束迭代器，并且无法 ScrollView 以便文本的结尾显示在屏幕中间。 (一些 TextView 在文本后包含额外的空间以实现这一点；Gtk::TextView 没有。)