Class: Studium::GUI::UniversalWidgets::ExamTrainer

Inherits:

UniversalWidgets::Base

• Object
• UniversalWidgets::Base
• Studium::GUI::UniversalWidgets::ExamTrainer

Includes:

UniversalWidgets::BaseModule

Defined in:

lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb

Overview

Studium::GUI::UniversalWidgets::ExamTrainer

Constant Summary

TITLE =

#

TITLE

#

'Simple Exam Trainer'

WIDTH =

#

WIDTH

#

'95% or minimum 2250px'

HEIGHT =

#

Studium::GUI::UniversalWidgets::ExamTrainer::HEIGHT

1080px is the highest for my large monitor, so I set this below.

#

'90% or minimum 1060px'

DEFAULT_DELAY =

#

DEFAULT_DELAY

This constant specifies how long to wait before the answer is revealed, if the user has set the checkbutton to “automatically answer the question”.

#

'15.0'

N_EXAM_QUESTIONS_IN_TOTAL =

#

Studium::GUI::UniversalWidgets::ExamTrainer::N_EXAM_QUESTIONS_IN_TOTAL

#

'n exam-questions in total'

N_ANSWERED_EXAM_QUESTIONS =

#

Studium::GUI::UniversalWidgets::N_ANSWERED_EXAM_QUESTIONS

#

'n answered exam-questions'

N_UNANSWERED_EXAM_QUESTIONS =

#

Studium::GUI::UniversalWidgets::N_UNANSWERED_EXAM_QUESTIONS

#

'n unanswered exam-questions'

N_PERCENT_SOLVED =

#

Studium::GUI::UniversalWidgets::N_PERCENT_SOLVED

An alternative name would be ‘percentage solved’.

#

'n % solved'

SLEEP_N_SECONDS =

#

Studium::GUI::UniversalWidgets::SLEEP_N_SECONDS

#

'sleep n seconds'

PANEL_TOOLTIP_TEXT =

#

PANEL_TOOLTIP_TEXT

#

'Exam Trainer Widget'

SQLITE_DATABASE_FILE =

#

SQLITE_DATABASE_FILE

This is experimental - one day we may want to query from a sqlite database rather than flat files. Or, at the least, offer this as a possibility.

#

'/Depot/jjjj/exam_questions.db'

USE_THIS_FONT =

#

USE_THIS_FONT

The older font was :dejavu_condensed_20 and the oldest font was :deja_vu_sans_25. Before December 2023 the font was :hack_20, but now it is :hack_22.

It is recommended to use the method main_font? rather than this constant directly.

#

:hack_22

LARGER_FONT =

#

LARGER_FONT

#

:hack_26

SMALLER_FONT =

#

SMALLER_FONT

This one should be matched onto the larger font defined above.

#

:hack_20

SMALLEST_FONT =

#

SMALLEST_FONT

#

:hack_15

WORD_WRAP_AT_N_CHARACTERS =

#

WORD_WRAP_AT_N_CHARACTERS

Specify after n characters a given text has to be wrapped via newlines, e. g. “n”.

#

76

DEFAULT_PLACEHOLDER_TEXT =

#

DEFAULT_PLACEHOLDER_TEXT

#

'You can input your answer to the exam question here.'

USE_THIS_MARGIN =

#

USE_THIS_MARGIN

#

12

USE_THIS_AS_THE_DEFAULT_EXAM_TOPIC =

#

USE_THIS_AS_THE_DEFAULT_EXAM_TOPIC

This constant can be used to specify the default exam topic to be used on startup of this application.

#

'toxikologie'

HASH_DESIGNATED_KEY_COMBINATIONS =

#

HASH_DESIGNATED_KEY_COMBINATIONS

#

{
  'strg+s': 'save_the_buffer',
  'alt+y':  'activate_the_third_textview'
}

AskExamQuestion =

#

Last but not least, add two “compatibility constants”:

#

ExamTrainer

SimpleExamTrainer =

And add a helper “alias” here.

ExamTrainer

Class Method Summary

• .[](i = ARGV) ⇒ Object

  # === Studium::GUI::UniversalWidgets::ExamTrainer[] ========================================================================= #.

• .gtk_accel_group ⇒ Object

  # === Studium::GUI::UniversalWidgets::ExamTrainer.gtk_accel_group ========================================================================= #.

• .run(i = ARGV) ⇒ Object

  # === Studium::GUI::UniversalWidgets::ExamTrainer.run ========================================================================= #.

Instance Method Summary

• #activate_the_third_textview ⇒ Object

  # === activate_the_third_textview ========================================================================= #.

• #add_the_status_icon ⇒ Object

  # === add_the_status_icon ========================================================================= #.

• #all_questions_have_been_answered_in_this_topic?(this_topic = current_exam_topic? ) ⇒ Boolean

  # === all_questions_have_been_answered_in_this_topic?.

• #all_textviews? ⇒ Boolean

  # === all_textviews? ========================================================================= #.

• #allow_external_applications? ⇒ Boolean

  # === allow_external_applications?.

• #always_reset_the_delay_before_using_another_delay ⇒ Object

  # === always_reset_the_delay_before_using_another_delay ========================================================================= #.

• #always_reveal_the_exam_answer_via_this_method ⇒ Object

  # === always_reveal_the_exam_answer_via_this_method.

• #answer_is? ⇒ Boolean

  # === answer_is? ========================================================================= #.

• #array_all_exam_questions? ⇒ Boolean (also: #all_exam_questions)

  # === array_all_exam_questions?.

• #available_exam_topics_in_short_form? ⇒ Boolean (also: #return_available_exam_topics, #available_exam_topics?, #exam_topics_short_form?)

  # === available_exam_topics_in_short_form? ========================================================================= #.

• #border_size? ⇒ Boolean

  # === border_size? ========================================================================= #.

• #button_ask_the_exam_question? ⇒ Boolean (also: #question_button?, #button_ask_the_question?)

  # === button_ask_the_exam_question? ========================================================================= #.

• #button_ask_the_exam_question_was_clicked(use_this_topic = :obtain_the_exam_topic_from_the_relevant_entry) ⇒ Object (also: #do_handle_the_click_event_for_the_ask_question_button, #ask_an_exam_question, #do_ask_the_exam_question, #do_ask_a_new_question, #trigger_the_event_when_the_ask_exam_question_button_was_clicked, #do_ask_an_exam_question, #do_ask_a_new_exam_question, #the_button_ask_the_question_was_clicked, #the_button_ask_the_exam_question_was_clicked)

  # === button_ask_the_exam_question_was_clicked (clicked tag).

• #button_clear? ⇒ Boolean

  # === button_clear? ========================================================================= #.

• #button_clear_was_clicked ⇒ Object

  # === button_clear_was_clicked ========================================================================= #.

• #button_reveal_the_answer? ⇒ Boolean

  # === button_reveal_the_answer? ========================================================================= #.

• #button_reveal_the_answer_was_clicked ⇒ Object (also: #the_button_reveal_the_answer_was_clicked)

  # === button_reveal_the_answer_was_clicked ========================================================================= #.

• #button_solve_the_exam_question? ⇒ Boolean

  # === button_solve_the_exam_question? ========================================================================= #.

• #button_solve_the_exam_question_was_clicked ⇒ Object (also: #mark_the_exam_question_as_solved, #do_solve_the_exam_question, #the_current_exam_question_is_now_solved)

  # === button_solve_the_exam_question_was_clicked (solved tag, solve tag) ========================================================================= #.

• #button_update_n_questions_were_answered? ⇒ Boolean

  # === button_update_n_questions_were_answered? ========================================================================= #.

• #button_use_random_entry_from_the_ten_aliases? ⇒ Boolean

  # === button_use_random_entry_from_the_ten_aliases? ========================================================================= #.

• #change_to_a_happy_smiley_before_reverting_to_the_prior_default_again(delay_to_use = 5_000) ⇒ Object

  # === change_to_a_happy_smiley_before_reverting_to_the_prior_default_again.

• #clear_the_exam_answer ⇒ Object (also: #clear_reveal_the_answer, #clear_answers, #clear_answers_buffer, #clear_answer_buffer, #clear_the_answer_buffer)

  # === clear_the_exam_answer (clear tag).

• #combobox_available_exam_topics? ⇒ Boolean (also: #return_the_combobox, #combo_box_available_exam_topics?, #main_combo_box?, #combo_box?, #return_combo_box_showing_all_exam_questions, #return_combo_box_available_exam_topics)

  # === combobox_available_exam_topics?.

• #connect_the_notebook_tab(window = main_window?, , padding_to_use = 2) ⇒ Object

  # === connect_the_notebook_tab.

• #connect_the_skeleton ⇒ Object

  # === connect_the_skeleton (connect tag) ========================================================================= #.

• #consider_making_available_the_show_ten_aliases_widget ⇒ Object

  # === consider_making_available_the_show_ten_aliases_widget ========================================================================= #.

• #consider_running_rinstall2 ⇒ Object

  # === consider_running_rinstall2 ========================================================================= #.

• #context_menu? ⇒ Boolean

  # === context_menu? ========================================================================= #.

• #control_panel? ⇒ Boolean

  # === control_panel? ========================================================================= #.

• #create_entry_n_total_exam_questions ⇒ Object (also: #create_the_entry_containing_n_questions)

  # === create_entry_n_total_exam_questions ========================================================================= #.

• #create_scrolled_window3(i = textview3? ) ⇒ Object

  # === create_scrolled_window3.

• #create_text_buffer_for_the_answer ⇒ Object

  # === create_text_buffer_for_the_answer ========================================================================= #.

• #create_the_button_ask_the_exam_question ⇒ Object (also: #create_the_ask_the_exam_question_button)

  # === create_the_button_ask_the_exam_question ========================================================================= #.

• #create_the_button_solve_the_question ⇒ Object

  # === create_the_button_solve_the_question ========================================================================= #.

• #create_the_button_update_n_questions_were_answered ⇒ Object

  # === create_the_button_update_n_questions_were_answered (update tag) ========================================================================= #.

• #create_the_button_use_random_entry_from_the_ten_aliases ⇒ Object

  # === create_the_button_use_random_entry_from_the_ten_aliases ========================================================================= #.

• #create_the_buttons ⇒ Object

  # === create_the_buttons (buttons tag, button tag) ========================================================================= #.

• #create_the_checkbox_shall_we_reveal_the_answer(entry_delay_to_use = entry_delay_to_use? ) ⇒ Object

  # === create_the_checkbox_shall_we_reveal_the_answer ========================================================================= #.

• #create_the_combobox(use_these_exam_topics = :default_exam_topics) ⇒ Object

  # === create_the_combobox.

• #create_the_context_menu ⇒ Object

  # === create_the_context_menu.

• #create_the_editor ⇒ Object

  # === create_the_editor (editor tag).

• #create_the_emoji_toggle_widget ⇒ Object

  # === create_the_emoji_toggle_widget.

• #create_the_entries(use_this_font = :default_font) ⇒ Object

  # === create_the_entries (entries tag, entry tag) ========================================================================= #.

• #create_the_entry_for_sleeping_n_seconds ⇒ Object

  # === create_the_entry_for_sleeping_n_seconds ========================================================================= #.

• #create_the_entry_for_the_current_exam_topic ⇒ Object

  # === create_the_entry_for_the_current_exam_topic ========================================================================= #.

• #create_the_entry_n_answered_exam_questions(use_this_font = :default_font) ⇒ Object (also: #create_the_entry_containing_n_answered_exam_questions)

  # === create_the_entry_n_answered_exam_questions ========================================================================= #.

• #create_the_entry_n_unanswered_questions ⇒ Object (also: #create_the_entry_containing_n_unanswered_questions, #create_the_entry_containing_n_unanswered_exam_questions)

  # === create_the_entry_n_unanswered_questions ========================================================================= #.

• #create_the_entry_percentage(use_this_font = smaller_font? ) ⇒ Object

  # === create_the_entry_percentage ========================================================================= #.

• #create_the_labels ⇒ Object

  # === create_the_labels ========================================================================= #.

• #create_the_notebook_tab ⇒ Object

  # === create_the_notebook_tab (notebook tag) ========================================================================= #.

• #create_the_reveal_the_answer_button ⇒ Object (also: #create_the_reveal_button)

  # === create_the_reveal_the_answer_button.

• #create_the_skeleton ⇒ Object (also: #create_skeleton)

  # === create_the_skeleton (create tag, skeleton tag) ========================================================================= #.

• #create_the_textview_that_will_contain_the_exam_question(text_buffer_for_the_question = :default_buffer) ⇒ Object

  # === create_the_textview_that_will_contain_the_exam_question ========================================================================= #.

• #create_the_textviews ⇒ Object

  # === create_the_textviews ========================================================================= #.

• #create_the_thumbs_up_emoji ⇒ Object

  # === create_the_thumbs_up_emoji ========================================================================= #.

• #create_the_widget_for_the_exam_answer(use_this_text_buffer = @text_buffer_for_the_answer) ⇒ Object (also: #create_text_view_for_the_answer)

  # === create_the_widget_for_the_exam_answer (answer tag, answers tags) ========================================================================= #.

• #create_the_widget_for_the_freeform_textview ⇒ Object

  # === create_the_widget_for_the_freeform_textview ========================================================================= #.

• #create_then_return_the_default_grid ⇒ Object (also: #create_the_main_grid)

  # === create_then_return_the_default_grid ========================================================================= #.

• #current_exam_topic_from_the_entry? ⇒ Boolean (also: #current_exam_topic_as_a_string?)

  # === current_exam_topic_from_the_entry? ========================================================================= #.

• #debug ⇒ Object

  # === debug ========================================================================= #.

• #default_exam_topic? ⇒ Boolean

  # === default_exam_topic? ========================================================================= #.

• #delay_to_use? ⇒ Boolean (also: #default_delay?)

  # === default_delay? ========================================================================= #.

• #deselect_the_entry_containing_the_exam_topic(i = entry_for_the_current_exam_topic? ) ⇒ Object

  # === deselect_the_entry_containing_the_exam_topic ========================================================================= #.

• #do_assign_a_new_exam_topic ⇒ Object

  # === do_assign_a_new_exam_topic ========================================================================= #.

• #do_assign_the_default_exam_topic_to_the_correct_entry ⇒ Object

  # === do_assign_the_default_exam_topic_to_the_correct_entry ======================================================================= #.

• #do_clear_the_free_form_textarea ⇒ Object

  # === do_clear_the_free_form_textarea ========================================================================= #.

• #do_clear_the_question_buffer ⇒ Object (also: #clear_question_buffer, #clear_questions_buffer)

  # === do_clear_the_question_buffer.

• #do_interactively_change_the_font ⇒ Object

  # === do_interactively_change_the_font.

• #do_jump_into_the_entry_containing_the_current_exam_topic ⇒ Object

  # === do_jump_into_the_entry_containing_the_current_exam_topic ========================================================================= #.

• #do_open_the_current_exam_topic_file(use_this_as_exam_topic = current_exam_topic_from_the_entry? ) ⇒ Object

  # === do_open_the_current_exam_topic_file.

• #do_popup_the_array_of_all_exam_questions(array = :infer) ⇒ Object

  # === do_popup_the_array_of_all_exam_questions.

• #do_popup_the_you_have_to_provide_an_exam_topic ⇒ Object

  # === do_popup_the_you_have_to_provide_an_exam_topic ========================================================================= #.

• #do_sleep_now(i = :default, use_this_as_timeout = 0) ⇒ Object

  # === do_sleep_now (sleep tag) ========================================================================= #.

• #do_style_all_buttons_uniformly(i = return_all_buttons) ⇒ Object

  # === do_style_all_buttons_uniformly (style tag) ========================================================================= #.

• #do_update_the_entries_n_answered_and_n_unanswered ⇒ Object

  # === do_update_the_entries_n_answered_and_n_unanswered ========================================================================= #.

• #do_update_the_entry_n_questions(current_exam_topic = current_exam_topic? ) ⇒ Object

  # === do_update_the_entry_n_questions ========================================================================= #.

• #do_update_the_entry_n_unanswered_questions ⇒ Object (also: #update_the_entry_n_unanswered_questions, #update_n_unanswered)

  # === do_update_the_entry_n_unanswered_questions.

• #enable_all_key_combinations ⇒ Object

  # === enable_all_key_combinations ========================================================================= #.

• #enable_alt_1_key_combination ⇒ Object

  # === enable_alt_1_key_combination ========================================================================= #.

• #enable_alt_w_key_combination(i = @accel_group) ⇒ Object

  # === enable_alt_w_key_combination.

• #enable_alt_y_key_combination ⇒ Object

  # === enable_alt_y_key_combination ========================================================================= #.

• #enable_the_main_key_combinations(use_this_hash = HASH_DESIGNATED_KEY_COMBINATIONS) ⇒ Object

  # === enable_the_main_key_combinations ========================================================================= #.

• #enhance_entry_n_answered_exam_questions(use_this_font = :default_font, entry = entry_n_answered_exam_questions? ) ⇒ Object

  # === enhance_entry_n_answered_exam_questions.

• #enhance_the_entry_containing_n_questions(use_this_font = smaller_font?, , entry = ) ⇒ Object

  # === enhance_the_entry_containing_n_questions ========================================================================= #.

• #enhance_the_entry_for_sleeping_n_seconds(i = entry_for_sleeping_n_seconds? ) ⇒ Object

  # === enhance_the_entry_for_sleeping_n_seconds ========================================================================= #.

• #enhance_the_entry_percentage(use_this_font = nil) ⇒ Object

  # === enhance_the_entry_percentage ========================================================================= #.

• #entry_delay_value? ⇒ Boolean

  # === entry_delay_value? ========================================================================= #.

• #entry_exam_topic_in_use? ⇒ Boolean (also: #entry_for_the_current_exam_topic?, #entry_for_the_exam_topic?, #entry_holding_all_exam_topics?, #entry_current_exam_topic?)

  # === entry_exam_topic_in_use? ======================================================================= #.

• #entry_for_sleeping_n_seconds? ⇒ Boolean (also: #entry_delay_to_use?, #entry_sleep_n_seconds?, #entry_delay?, #return_entry_for_sleeping_n_seconds, #return_the_entry_sleep_n_seconds)

  # === entry_for_sleeping_n_seconds? ========================================================================= #.

• #entry_n_answered_exam_questions? ⇒ Boolean (also: #entry_containing_n_answers?)

  # === entry_n_answered_exam_questions? ========================================================================= #.

• #entry_n_total_exam_questions? ⇒ Boolean (also: #entry_containing_n_questions?)

  # === entry_n_total_exam_questions? ========================================================================= #.

• #entry_n_unanswered_questions? ⇒ Boolean (also: #entry_containing_n_unanswered_questions?, #entry_containing_n_unanswered_questions)

  # === entry_n_unanswered_questions? ========================================================================= #.

• #entry_percentage? ⇒ Boolean (also: #return_entry_percentage)

  # === entry_percentage? ========================================================================= #.

• #exam_answer? ⇒ Boolean

  # === exam_answer? ========================================================================= #.

• #exam_question? ⇒ Boolean (also: #current_exam_question?)

  # === exam_question? ========================================================================= #.

• #exam_question_object? ⇒ Boolean

  # === exam_question_object? ========================================================================= #.

• #exam_topic_from_the_correct_entry? ⇒ Boolean (also: #entry_ask_questions_from_this_topic?, #current_exam_topic?, #main_exam_topic?, #exam_topic?, #current_topic?, #entry_exam_topic?, #entry_ask_questions?, #entry_exam_topic_as_string?)

  # === exam_topic_from_the_correct_entry?.

• #find_completion_for_the_entry_for_the_current_exam_topic ⇒ Object

  # === find_completion_for_the_entry_for_the_current_exam_topic ========================================================================= #.

• #handle_CSS ⇒ Object

  # === handle_CSS (CSS tag) ========================================================================= #.

• #handle_the_combo_box_available_exam_topics_on_changed_event ⇒ Object (also: #do_handle_the_combobox_available_exam_topics_on_changed_event, #sync_the_current_exam_topic_onto_the_exam_topic_entry)

  # === handle_the_combo_box_available_exam_topics_on_changed_event ======================================================================= #.

• #hash_dataset_of_all_lectures? ⇒ Boolean

  # === hash_dataset_of_all_lectures? ========================================================================= #.

• #initialize(commandline_arguments = nil, run_already = true) ⇒ ExamTrainer constructor

  # === initialize ========================================================================= #.

• #instantiate_the_control_panel ⇒ Object

  # === instantiate_the_control_panel.

• #label_n_questions_were_answered? ⇒ Boolean

  # === label_n_questions_were_answered? ========================================================================= #.

• #larger_font? ⇒ Boolean

  # === larger_font? ========================================================================= #.

• #let_the_scrolled_window_for_the_answer_parse_URLs(scrolled_window_for_the_answer = scrolled_window_for_the_answer? ) ⇒ Object

  # === let_the_scrolled_window_for_the_answer_parse_URLs ========================================================================= #.

• #main_font? ⇒ Boolean

  # === main_font? ========================================================================= #.

• #main_grid? ⇒ Boolean

  # === main_grid? ========================================================================= #.

• #may_we_reveal_the_answer_after_a_delay? ⇒ Boolean (also: #may_we_reveal_the_answer?)

  # === may_we_reveal_the_answer_after_a_delay? ========================================================================= #.

• #notify_the_user_that_all_questions_have_been_answered_in_this_topic(this_topic = current_exam_topic?, , this_widget = button_reveal_the_answer? ) ⇒ Object

  # === notify_the_user_that_all_questions_have_been_answered_in_this_topic ========================================================================= #.

• #one_two_three(use_this_topic = exam_topic_from_the_correct_entry? ) ⇒ Object (also: #update_n_questions, #update_three_important_widgets)

  # === one_two_three (one_two_three tag) ========================================================================= #.

• #original_return_available_exam_topics ⇒ Object

  # === original_return_available_exam_topics.

• #padding? ⇒ Boolean

  # === padding? ========================================================================= #.

• #parse_for_URL(i = text_view_for_the_answer?.buffer.text) ⇒ Object

  # === parse_for_URL.

• #parse_the_commandline_arguments ⇒ Object

  # === parse_the_commandline_arguments ========================================================================= #.

• #populate_the_main_grid(grid = main_grid? ) ⇒ Object

  # === populate_the_main_grid (grid tag, populate tag).

• #populate_the_notebook_tab ⇒ Object

  # === populate_the_notebook_tab ========================================================================= #.

• #popup_pick_a_new_font ⇒ Object

  # === popup_pick_a_new_font ========================================================================= #.

• #question_is? ⇒ Boolean

  # === question_is? ========================================================================= #.

• #reset ⇒ Object

  # === reset (reset tag) ========================================================================= #.

• #reset_the_shared_module ⇒ Object

  # === reset_the_shared_module ========================================================================= #.

• #reset_the_shared_variables ⇒ Object

  # === reset_the_shared_variables ========================================================================= #.

• #resize_the_notebook_tab_towards_the_primary_width_and_height ⇒ Object

  # === resize_the_notebook_tab_towards_the_primary_width_and_height ========================================================================= #.

• #return_button_ask_the_exam_question(use_emoji = false) ⇒ Object (also: #return_button_ask_an_exam_question)

  # === return_button_ask_the_exam_question (ask tag) ========================================================================= #.

• #return_button_open_exam_topic_file ⇒ Object

  # === return_button_open_exam_topic_file.

• #return_button_solve_the_question ⇒ Object

  # === return_button_solve_the_question.

• #return_checkbox_shall_we_reveal_the_answer ⇒ Object (also: #checkbox?, #checkbox_shall_we_reveal_the_answer?)

  # === return_checkbox_shall_we_reveal_the_answer.

• #return_event_box_for_asking_a_random_exam_topic ⇒ Object

  # === return_event_box_for_asking_a_random_exam_topic.

• #return_event_box_with_face_glasses ⇒ Object

  # === return_event_box_with_face_glasses.

• #return_eventbox_with_an_image_to_exit_the_application ⇒ Object

  # === return_eventbox_with_an_image_to_exit_the_application.

• #return_frame_containing_the_label_exam_topic ⇒ Object

  # === return_frame_containing_the_label_exam_topic ========================================================================= #.

• #return_hbox_containing_two_icons_and_instructions_what_to_do_with_the_free_form_textarea ⇒ Object

  # === return_hbox_containing_two_icons_and_instructions_what_to_do_with_the_free_form_textarea.

• #return_n_answers_from_the_currently_selected_topic(i = current_exam_topic_as_a_string? ) ⇒ Object

  # === return_n_answers_from_the_currently_selected_topic ========================================================================= #.

• #return_n_questions_from_the_currently_selected_topic(i = current_exam_topic? ) ⇒ Object

  # === return_n_questions_from_the_currently_selected_topic.

• #return_string_how_many_exam_questions_are_already_answered ⇒ Object

  # === return_string_how_many_exam_questions_are_already_answered ========================================================================= #.

• #return_wikipedia_widget ⇒ Object

  # === return_wikipedia_widget (wikipedia tag).

• #reveal_the_exam_answer(may_we_reveal_the_exam_answer = may_we_reveal_the_answer_after_a_delay? ) ⇒ Object

  # === reveal_the_exam_answer ========================================================================= #.

• #rinstall2 ⇒ Object (also: #r2)

  # === rinstall2 ========================================================================= #.

• #run ⇒ Object

  # === run (run tag) ========================================================================= #.

• #sanitize_the_answer(i, apply_these_filters = []) ⇒ Object (also: #sanitize_this_answer)

  # === sanitize_the_answer.

• #save_the_buffer ⇒ Object

  # === save_the_buffer ========================================================================= #.

• #scrolled_window1? ⇒ Boolean

  # === scrolled_window1? ========================================================================= #.

• #scrolled_window2? ⇒ Boolean (also: #return_scrolled_window_containing_the_text_view_for_the_answer, #scrolled_window_for_the_answer?, #scrolled_window_containing_the_textarea2?)

  # === scrolled_window2? ========================================================================= #.

• #scrolled_window3? ⇒ Boolean (also: #return_widget_for_the_freeform_textview, #scrolled_window_containing_the_textarea3, #return_scrolled_window3, #return_scrolled_window_containing_the_textarea3)

  # === scrolled_window3? ========================================================================= #.

• #select_not_yet_completed_exam_topics(i) ⇒ Object

  # === select_not_yet_completed_exam_topics ========================================================================= #.

• #set_delay_to_use(i = DEFAULT_DELAY) ⇒ Object

  # === set_delay_to_use ========================================================================= #.

• #set_editor_buffer(i) ⇒ Object

  # === set_editor_buffer ========================================================================= #.

• #set_exam_answer(i = answer_is?, , apply_these_filters = [:filter_away_tags]) ⇒ Object (also: #set_answer, #reveal_the_answer_to_the_exam_question)

  # === set_exam_answer (answer tag) ========================================================================= #.

• #set_exam_question(i = exam_question_object?.question?, apply_these_filters = [:remove_tags]) ⇒ Object (also: #set_question)

  # === set_exam_question.

• #set_exam_topic(i = :default) ⇒ Object (also: #set_current_exam_topic)

  # === set_exam_topic.

• #set_n_exam_questions_are_unanswered(i) ⇒ Object (also: #set_n_unanswered_questions)

  # === set_n_exam_questions_are_unanswered ========================================================================= #.

• #set_n_exam_questions_exist_in_total(i) ⇒ Object

  # === set_n_exam_questions_exist_in_total.

• #set_n_exam_questions_were_already_answered(i) ⇒ Object

  # === set_n_exam_questions_were_already_answered ========================================================================= #.

• #set_n_percentage_of_questions_answered(i) ⇒ Object (also: #set_n_percentage, #update_the_percentage_entry, #do_update_this_entry_with_that_exam_topic_for_its_percentage_value)

  # === set_n_percentage_of_questions_answered.

• #set_save_into_this_local_file(i) ⇒ Object

  # === set_save_into_this_local_file.

• #shall_we_create_the_gtk_editor? ⇒ Boolean

  # === shall_we_create_the_gtk_editor? ========================================================================= #.

• #show_ten_aliases? ⇒ Boolean

  # === show_ten_aliases? ========================================================================= #.

• #simply_assign_this_as_the_new_exam_topic_onto_the_primary_combobox(i) ⇒ Object

  # === simply_assign_this_as_the_new_exam_topic_onto_the_primary_combobox.

• #smallest_font? ⇒ Boolean

  # === smallest_font? ========================================================================= #.

• #sync_combo_box_entry_onto_the_current_exam_entry(i = combo_box?.entry?) ⇒ Object

  # === sync_combo_box_entry_onto_the_current_exam_entry ======================================================================= #.

• #sync_entry_holding_all_exam_topics_onto_the_combo_box(value = Studium.find_corresponding_exam_topic( entry_for_the_current_exam_topic?.text? )) ⇒ Object (also: #sync_entry_holding_all_exam_topics_onto_the_main_combo_box)

  # === sync_entry_holding_all_exam_topics_onto_the_combo_box ========================================================================= #.

• #textview1? ⇒ Boolean (also: #widget_for_the_questions?, #text_view_for_the_question?, #return_widget_for_the_questions, #return_text_view_for_the_question, #return_scrolled_window_for_the_text_view_for_the_question, #text_view_containing_the_current_question?, #text_buffer_for_the_question?, #textarea1?, #question_buffer, #question_buffer?)

  # === textview1? ========================================================================= #.

• #textview2? ⇒ Boolean (also: #return_widget_for_the_answers, #text_view_for_the_answer, #text_view_for_the_answer?, #textarea2?, #answer_buffer?, #answer_buffer)

  # === textview2? ========================================================================= #.

• #textview3? ⇒ Boolean (also: #text_view_for_the_freeform_input?, #text_view_for_the_freeform_input, #free_form_textarea?, #return_textarea_number_three)

  # === textview3? ========================================================================= #.

• #the_first_notebook_tab_is_active ⇒ Object

  # === the_first_notebook_tab_is_active ========================================================================= #.

• #top_textbuffer? ⇒ Boolean

  # === top_textbuffer? ========================================================================= #.

• #update_array_all_exam_questions ⇒ Object

  # === update_array_all_exam_questions ========================================================================= #.

• #update_hash_dataset_of_all_lectures ⇒ Object

  # === update_hash_dataset_of_all_lectures ========================================================================= #.

• #update_n_answered(i = :infer) ⇒ Object (also: #do_update_the_entry_n_answered)

  # === update_n_answered ========================================================================= #.

• #update_the_label_n_questions_were_answered(i = @label_n_questions_were_answered) ⇒ Object (also: #update_the_label_containing_the_last_exam_question)

  # === update_the_label_n_questions_were_answered ========================================================================= #.

• #use_emoji? ⇒ Boolean

  # === use_emoji? ========================================================================= #.

• #use_the_internal_editor? ⇒ Boolean

  # === use_the_internal_editor? ========================================================================= #.

• #use_this_editor? ⇒ Boolean

  # === use_this_editor? ========================================================================= #.

• #we_may_not_reveal_the_exam_answer_anymore ⇒ Object

  # === we_may_not_reveal_the_exam_answer_anymore ========================================================================= #.

• #we_may_reveal_the_exam_answer ⇒ Object

  # === we_may_reveal_the_exam_answer ========================================================================= #.

Constructor Details

#initialize(commandline_arguments = nil, run_already = true) ⇒ ExamTrainer

#

initialize

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 180

def initialize(
    commandline_arguments = nil,
    run_already           = true
  )
  # ======================================================================= #
  # We first have to determine the GUI that is to be used, even before
  # calling reset(). The reason is that this will also require some
  # files, such as the Gdk namespace, which may be used by the GUI
  # related parts for ruby-gtk3, for instance.
  # ======================================================================= #
  determine_the_GUI_to_be_used(commandline_arguments)
  # super(:vertical) This should be for ruby-gtk3, for a BaseModuleBox.
  reset
  set_commandline_arguments(
    commandline_arguments
  )
  run if run_already
end

Class Method Details

.[](i = ARGV) ⇒ Object

#

Studium::GUI::UniversalWidgets::ExamTrainer[]

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 3252

def self.[](i = ARGV)
  new(i)
end

.gtk_accel_group ⇒ Object

#

Studium::GUI::UniversalWidgets::ExamTrainer.gtk_accel_group

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1645

def self.gtk_accel_group
  ::Gtk::AccelGroup.new
end

.run(i = ARGV) ⇒ Object

#

Studium::GUI::UniversalWidgets::ExamTrainer.run

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2606

def self.run(
    i = ARGV
  )
  require 'gtk_paradise/run'
  _ = ::Studium::GUI::UniversalWidgets::ExamTrainer.new(i)
  r = ::Gtk.run
  r << _
  _.set_parent_widget(r) # Designate it as the parent widget.
  _.enable_the_main_key_combinations
  r.add_context_menu_with_the_default_accel_group
  r.on_button_press_event { |widget, event|
    if ::Gtk.right_mouse_click?(event) # right mouse click event.
      _.context_menu?.popup_based_on_this_event(event)
    end
  }
  r.automatic_size_then_automatic_title
  r.enable_quick_exit
  r.move_to(x: 15, y: 0)
  r.run
end

Instance Method Details

#activate_the_third_textview ⇒ Object

#

activate_the_third_textview

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1724

def activate_the_third_textview
  free_form_textarea?.do_focus_on_it
end

#add_the_status_icon ⇒ Object

#

add_the_status_icon

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1541

def add_the_status_icon
  if use_gtk3?
    status_icon = return_status_icon
    status_icon.favicon = Studium.project_base_directory?+
                          'images/studies_favicon.png'
    status_icon.hint = 'Exam-question widget: train your brain!'
    begin # Need to fix this later.
      menu = create_menu
      button_hello_world = create_image_menu_item(stock: ::Gtk::Stock::FIND)
      button_hello_world.signal_connect(:activate) {
        e 'A click-event has been detected.'
      }
      menu << button_hello_world
      quit_button = create_image_menu_item(stock: ::Gtk::Stock::QUIT)
      quit_button.signal_connect(:activate) { ::Gtk.main_quit }
      menu.append(quit_button)
      menu.show_all
      status_icon.signal_connect(:popup_menu) { |icon, button, time|
        menu.popup(nil, nil, button, time)
      }
    rescue Exception => error
      pp error
    end
  end
end

#all_questions_have_been_answered_in_this_topic?(this_topic = current_exam_topic? ) ⇒ Boolean

#

all_questions_have_been_answered_in_this_topic?

This method has to determine how many questions have been answered in the current exam topic.

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1265

def all_questions_have_been_answered_in_this_topic?(
    this_topic = current_exam_topic?
  )
  (Studium.return_n_percent_solved_from_this_topic(this_topic).to_i == 100)
end

#all_textviews? ⇒ Boolean

#

all_textviews?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 490

def all_textviews?
  [
    textview1?,
    textview2?,
    textview3?
  ]
end

#allow_external_applications? ⇒ Boolean

#

allow_external_applications?

This is mostly useful when the main application allows add-ons, such as the TenAliases widget. It is not so important for standalone widgets.

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1574

def allow_external_applications?
  true
end

#always_reset_the_delay_before_using_another_delay ⇒ Object

#

always_reset_the_delay_before_using_another_delay

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 3167

def always_reset_the_delay_before_using_another_delay
  we_may_not_reveal_the_exam_answer_anymore
end

#always_reveal_the_exam_answer_via_this_method ⇒ Object

#

always_reveal_the_exam_answer_via_this_method

This method will ALWAYS reveal the exam-answer.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2942

def always_reveal_the_exam_answer_via_this_method
  set_exam_answer
  always_reset_the_delay_before_using_another_delay
end

#answer_is? ⇒ Boolean

#

answer_is?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1938

def answer_is?
  @internal_hash[:exam_question_object].answer?
end

#array_all_exam_questions? ⇒ Boolean Also known as: all_exam_questions

#

array_all_exam_questions?

Query-method to keep track of all exam-questions that were asked in the current run.

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2665

def array_all_exam_questions?
  @internal_hash[:array_all_exam_questions]
end

#available_exam_topics_in_short_form? ⇒ Boolean Also known as: return_available_exam_topics, available_exam_topics?, exam_topics_short_form?

#

available_exam_topics_in_short_form?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1581

def available_exam_topics_in_short_form?
  array = Studium.available_exam_topics_in_short_form?
  array = array.sort_by {|entry| entry.downcase }
  return array
end

#border_size? ⇒ Boolean

#

border_size?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 303

def border_size?
  0
end

#button_ask_the_exam_question? ⇒ Boolean Also known as: question_button?, button_ask_the_question?

#

button_ask_the_exam_question?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1390

def button_ask_the_exam_question?
  @internal_hash[:button_ask_the_exam_question]
end

#button_ask_the_exam_question_was_clicked(use_this_topic = :obtain_the_exam_topic_from_the_relevant_entry) ⇒ Object Also known as: do_handle_the_click_event_for_the_ask_question_button, ask_an_exam_question, do_ask_the_exam_question, do_ask_a_new_question, trigger_the_event_when_the_ask_exam_question_button_was_clicked, do_ask_an_exam_question, do_ask_a_new_exam_question, the_button_ask_the_question_was_clicked, the_button_ask_the_exam_question_was_clicked

#

button_ask_the_exam_question_was_clicked (clicked tag)

This is the most important button of this GUI.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2839

def button_ask_the_exam_question_was_clicked(
    use_this_topic = 
      :obtain_the_exam_topic_from_the_relevant_entry
  )
  case use_this_topic
  # ======================================================================= #
  # === :obtain_the_exam_topic_from_the_relevant_entry
  # ======================================================================= #
  when :obtain_the_exam_topic_from_the_relevant_entry
    use_this_topic = entry_exam_topic_in_use?.text?.to_s
  end
  we_may_reveal_the_exam_answer
  one_two_three(use_this_topic)
end

#button_clear? ⇒ Boolean

#

button_clear?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1652

def button_clear?
  @button_clear
end

#button_clear_was_clicked ⇒ Object

#

button_clear_was_clicked

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1126

def button_clear_was_clicked
  all_textviews?.each {|entry|
    entry.clear
  }
  @internal_hash[:may_we_reveal_the_answer_after_a_delay] = false
end

#button_reveal_the_answer? ⇒ Boolean

#

button_reveal_the_answer?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 543

def button_reveal_the_answer?
  @internal_hash[:button_reveal_the_answer]
end

#button_reveal_the_answer_was_clicked ⇒ Object Also known as: the_button_reveal_the_answer_was_clicked

#

button_reveal_the_answer_was_clicked

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 3113

def button_reveal_the_answer_was_clicked
  if all_questions_have_been_answered_in_this_topic?
    notify_the_user_that_all_questions_have_been_answered_in_this_topic(
      current_topic?,
      _
    )
  else
    always_reveal_the_exam_answer_via_this_method
    we_may_not_reveal_the_exam_answer_anymore
  end
end

#button_solve_the_exam_question? ⇒ Boolean

#

button_solve_the_exam_question?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1698

def button_solve_the_exam_question?
  @button_solve_the_exam_question
end

#button_solve_the_exam_question_was_clicked ⇒ Object Also known as: mark_the_exam_question_as_solved, do_solve_the_exam_question, the_current_exam_question_is_now_solved

#

button_solve_the_exam_question_was_clicked (solved tag, solve tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1705

def button_solve_the_exam_question_was_clicked
  # the_current_exam_question_is_now_solved
  # update_three_important_widgets
  _ = Studium::Exams::Solved.new(ARGV) { :do_not_run_yet }
  _.set_commandline
  _.run
  consider_running_rinstall2
  # ======================================================================= #
  # Also update the appropriate label next, whenever the solve-exam
  # question was clicked.
  # ======================================================================= #
  update_the_label_n_questions_were_answered
end

#button_update_n_questions_were_answered? ⇒ Boolean

#

button_update_n_questions_were_answered?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2417

def button_update_n_questions_were_answered?
  @internal_hash[:button_update_n_questions_were_answered]
end

#button_use_random_entry_from_the_ten_aliases? ⇒ Boolean

#

button_use_random_entry_from_the_ten_aliases?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 733

def button_use_random_entry_from_the_ten_aliases?
  @internal_hash[:button_use_random_entry_from_the_ten_aliases]
end

#change_to_a_happy_smiley_before_reverting_to_the_prior_default_again(delay_to_use = 5_000) ⇒ Object

#

change_to_a_happy_smiley_before_reverting_to_the_prior_default_again

This method is used to turn the thinking-smiley to a happy-smiley, before reverting again to the prior default.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1734

def change_to_a_happy_smiley_before_reverting_to_the_prior_default_again(
    delay_to_use = 5_000 # This refers to 5 seconds.
  )
  @a_thinking_smiley_emoji.toggle
  GLib::Timeout.add(delay_to_use) {
    @a_thinking_smiley_emoji.revert_to_the_initial_state # This reverts to the initial state again.
    false # Must end it.
  }
end

#clear_the_exam_answer ⇒ Object Also known as: clear_reveal_the_answer, clear_answers, clear_answers_buffer, clear_answer_buffer, clear_the_answer_buffer

#

clear_the_exam_answer (clear tag)

This method may only ever call set_exam_answer() - no other method is allowed to be called here.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 465

def clear_the_exam_answer
  set_exam_answer('') # Simply set the answer to an empty String here.
end

#combobox_available_exam_topics? ⇒ Boolean Also known as: return_the_combobox, combo_box_available_exam_topics?, main_combo_box?, combo_box?, return_combo_box_showing_all_exam_questions, return_combo_box_available_exam_topics

#

combobox_available_exam_topics?

This combo box will contain all available (registered) exam topics.

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2405

def combobox_available_exam_topics?
  @internal_hash[:combobox_available_exam_topics]
end

#connect_the_notebook_tab(window = main_window?, , padding_to_use = 2) ⇒ Object

#

connect_the_notebook_tab

This method will connect the notebook with the main Gtk::Window in use.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2510

def connect_the_notebook_tab(
    window         = main_window?,
    padding_to_use = 2
  )
  # @notebook_tab.halign = 0.5
  scrolled_window = create_scrolled_window(@notebook_tab)
  scrolled_window.show_all
  window.add(scrolled_window) # , padding_to_use)
  window.show_all
end

#connect_the_skeleton ⇒ Object

#

connect_the_skeleton (connect tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 3207

def connect_the_skeleton
  abort_on_exception
  add_the_status_icon
  r = create_window_or_runner(nil, width?, height?, title?)
  properly_prepare_this_window(
    r,
    return_the_default_hash_for_properly_preparing_this_window
  )
  do_style_all_buttons_uniformly
  do_assign_the_default_exam_topic_to_the_correct_entry
  let_the_scrolled_window_for_the_answer_parse_URLs
  deselect_the_entry_containing_the_exam_topic
  do_jump_into_the_entry_containing_the_current_exam_topic
  parse_the_commandline_arguments
  populate_the_main_grid(main_grid?) # Populate the main grid here next.
  populate_the_notebook_tab
  connect_the_notebook_tab(r)
  r.top_left
  set_parent_widget(r) # Designate it as the parent widget.
  enable_the_main_key_combinations
  r.add_context_menu_with_the_default_accel_group
  r.on_button_press_event { |widget, event|
    if ::Gtk.right_mouse_click?(event) # right mouse click event.
      _.context_menu?.popup_based_on_this_event(event)
    end
  }
  # r.automatic_size_then_automatic_title
  r.show_all
  the_first_notebook_tab_is_active
  r.enable_quick_exit
  r.set_default_size(width?, height?)
  # resize_the_notebook_tab_towards_the_primary_width_and_height
  run_main
end

#consider_making_available_the_show_ten_aliases_widget ⇒ Object

#

consider_making_available_the_show_ten_aliases_widget

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 3184

def consider_making_available_the_show_ten_aliases_widget
  # ======================================================================= #
  # The next if-clause must come after @internal_hash has been
  # defined.
  # ======================================================================= #
  if Object.const_defined?(:Roebe)
    begin
      require 'roebe/gui/gtk3/show_ten_aliases/show_ten_aliases.rb'
      @internal_hash[:show_ten_aliases] = ::Roebe::GUI::Gtk::ShowTenAliases.new
    rescue LoadError; end
  end
end

#consider_running_rinstall2 ⇒ Object

#

consider_running_rinstall2

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 603

def consider_running_rinstall2
  if is_on_roebe? and Object.const_defined?(:Roebe)
    rinstall2 # Run rinstall2 here, to update the local copy.
  end
end

#context_menu? ⇒ Boolean

#

context_menu?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 536

def context_menu?
  @context_menu
end

#control_panel? ⇒ Boolean

#

control_panel?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 864

def control_panel?
  @control_panel
end

#create_entry_n_total_exam_questions ⇒ Object Also known as: create_the_entry_containing_n_questions

#

create_entry_n_total_exam_questions

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1230

def create_entry_n_total_exam_questions
  # ======================================================================= #
  # === @entry_n_total_exam_questions
  # ======================================================================= #
  @internal_hash[:entry_n_total_exam_questions] = entry('', 12) # The 12 is for jruby specifically.
  enhance_the_entry_containing_n_questions
  return @internal_hash[:entry_n_total_exam_questions]
end

#create_scrolled_window3(i = textview3? ) ⇒ Object

#

create_scrolled_window3

This method will return the textarea-widget that can be used for “free typing” by the user - in other words, where the user can simply write whatever he/she wants to.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1083

def create_scrolled_window3(
    i = textview3?
  )
  # ======================================================================= #
  # The next scrolled-window is called "textview3", as it is the third
  # textarea to be seen in the main widget. The rationale for this
  # method was briefly mentioned above.
  # ======================================================================= #
  _ = create_scrolled_window(i) { :only_top_to_bottom }
  _.set_name('textview3')
  _.width_height(900, 180)
  _.pad4px
  _.do_show_the_scrollbars
  _.min_content_width  =  80
  _.min_content_height = 120
  # ======================================================================= #
  # Next, enable select-all-on-click events:
  # ======================================================================= #
  _.signal_connect(:event) {|widget, event|
    case event.event_type.name.to_s
    when 'GDK_BUTTON_PRESS'
      # e 'The left mouse-button was clicked! Selecting everything next.'
      # @text_view_for_simply_typing_anything.signal_emit(:select_all, event)
      i.select_everything(event)
    end
  }
  @scrolled_window3 = _
  return _ # And return it here as well, just in case.
end

#create_text_buffer_for_the_answer ⇒ Object

#

create_text_buffer_for_the_answer

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 550

def create_text_buffer_for_the_answer
  # ======================================================================= #
  # === @text_buffer_for_the_answer
  # ======================================================================= #
  @text_buffer_for_the_answer = create_text_buffer
end

#create_the_button_ask_the_exam_question ⇒ Object Also known as: create_the_ask_the_exam_question_button

#

create_the_button_ask_the_exam_question

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1398

def create_the_button_ask_the_exam_question
  # ======================================================================= #
  # === @internal_hash[:button_ask_the_exam_question]
  # ======================================================================= #
  @internal_hash[:button_ask_the_exam_question] = return_button_ask_the_exam_question(use_emoji?)
end

#create_the_button_solve_the_question ⇒ Object

#

create_the_button_solve_the_question

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1380

def create_the_button_solve_the_question
  # ======================================================================= #
  # === @button_solve_the_question
  # ======================================================================= #
  @button_solve_the_exam_question = return_button_solve_the_question
end

#create_the_button_update_n_questions_were_answered ⇒ Object

#

create_the_button_update_n_questions_were_answered (update tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1952

def create_the_button_update_n_questions_were_answered
  # ======================================================================= #
  # === The update-button is created next. It had the cat emoji in the
  #     past, aka 🐈️, but not every computer system has access to such
  #     an emoji, so this was replaced via an image.
  #
  #     The old text was: '🐈️ Update ➡️ '
  #
  # ======================================================================= #
  _ = bold_button('Update ➡️ ')
  _.on_hover(:lightblue)
  _.hint =
    'Click this button to update the entry to the right side.'
  _.on_clicked {
    update_the_label_n_questions_were_answered
  }
  # ======================================================================= #
  # Last but not least, assign it:
  # ======================================================================= #
  @internal_hash[:button_update_n_questions_were_answered] = _
end

#create_the_button_use_random_entry_from_the_ten_aliases ⇒ Object

#

create_the_button_use_random_entry_from_the_ten_aliases

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 689

def create_the_button_use_random_entry_from_the_ten_aliases
  # ======================================================================= #
  # === @internal_hash[:button_use_random_entry_from_the_ten_aliases]
  #
  # This is an eventbox rather than a button, but I think this is still
  # fine. The unicode character "🕵" (U+1F575) is the spy character.
  # ======================================================================= #
  if use_emoji?
    label = create_label('🕵️')
  else
    # label = image_avatar_default # This will be a gtk-image for ruby-gtk3.
    # In December 2023, the above was changed to an image.
    label = create_image(
      Gtk.project_base_directory?+'images/misc/investigate.png'
    )
  end
  # ======================================================================= #
  # === @internal_hash[:button_use_random_entry_from_the_ten_aliases]
  # ======================================================================= #
  _ = create_eventbox(label)
  _.on_clicked {
    if show_ten_aliases?
      set_exam_topic(
        show_ten_aliases?.return_random_entry
      )
      one_two_three
    end
  }
  _.set_size_request(40, 40)
  _.on_hover_lightblue
  # Provide some helpful message to help the user make use of this
  # button.
  _.hint = 
    'Click on this small widget to randomly assign one of '\
    'the 10 exam-topics currently being studied as the '\
    'new main exam-topic in use.'
  # This is actually an event box rather than a button.
  @internal_hash[:button_use_random_entry_from_the_ten_aliases] = _ # And assign it here too.
  return _
end

#create_the_buttons ⇒ Object

#

create_the_buttons (buttons tag, button tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1490

def create_the_buttons
  create_the_button_ask_the_exam_question
  # ======================================================================= #
  # === @button_solve_the_exam_question
  # ======================================================================= #
  create_the_button_solve_the_question
  # ======================================================================= #
  # === @button_clear
  # ======================================================================= #
  @button_clear = bold_button('_Clear all entries', self, :use_mnemonic) {
    :button_clear_was_clicked
  }
  create_the_button_update_n_questions_were_answered
  create_the_reveal_the_answer_button
  # ======================================================================= #
  # Next style these four buttons uniformly
  # ======================================================================= #
  [
    button_ask_the_exam_question?,
    button_reveal_the_answer?,
    button_solve_the_exam_question?,
    @button_clear,
    button_update_n_questions_were_answered?
  ].each {|this_button|
    this_button.clear_background
    this_button.bblack2
    this_button.on_hover(:lightgreen)
  }
  create_the_button_use_random_entry_from_the_ten_aliases # This one should come last here.
end

#create_the_checkbox_shall_we_reveal_the_answer(entry_delay_to_use = entry_delay_to_use? ) ⇒ Object

#

create_the_checkbox_shall_we_reveal_the_answer

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2801

def create_the_checkbox_shall_we_reveal_the_answer(
    entry_delay_to_use = entry_delay_to_use?
  )
  _ = create_checkbox(
    " Automatically reveal the \n answer after a delay"
  )
  _.set_font(smallest_font?)
  # ======================================================================= #
  # Next determine whether the checkbox is active, on startup, or whether
  # it is not active when the GUI starts up.
  # ======================================================================= #
  _.mark_as_checked # Should be checked as-is.
  _.hint =
    'Deselect this if you do not want to automatically reveal the answer. '\
    'In that case you have to manually click on the Answer button.'
  _.on_toggled { |widget|
    if _.active?
      entry_delay_to_use.grey_in
    elsif not _.active?
      entry_delay_to_use.grey_out
    end
  }
  if _.is_it_active?
    entry_delay_to_use.grey_in
  else
    entry_delay_to_use.grey_out
  end
  # ======================================================================= #
  # === @internal_hash[:checkbox_shall_we_reveal_the_answer]
  # ======================================================================= #
  @internal_hash[:checkbox_shall_we_reveal_the_answer] = _
end

#create_the_combobox(use_these_exam_topics = :default_exam_topics) ⇒ Object

#

create_the_combobox

This method will create the combo-box that contains all exam-topics. It will be a bit truncated, largely for display-reasons rather than any other reason.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1751

def create_the_combobox(
    use_these_exam_topics = :default_exam_topics
  )
  case use_these_exam_topics
  # ===================================================================== #
  # === :default_exam_topics
  # ===================================================================== #
  when :default_exam_topics
    use_these_exam_topics = available_exam_topics_in_short_form?.
                            map(&:downcase).sort
  end
  # ===================================================================== #
  # Next truncate these exam-topics a bit:
  # ===================================================================== #
  use_this_sorted_array = use_these_exam_topics.uniq.map {|entry|
    if entry.size > 25 # Truncate it a bit in this case here.
      entry = entry[0 .. 25]
    end
    entry
  }.sort
  _ = create_combobox_text # Create the combo-box here.
  # use_this_sorted_array.each {|entry|
  #   entry = entry.to_s
  #   _.append_text(entry) if entry and !entry.empty?
  # }
  _.fill_up(use_this_sorted_array)
  _.first_entry_is_active
  _.bblack1
  _.set_size_request(100, 28)
  # ======================================================================= #
  # Wrap-width determines how many entries per row are shown when the
  # combo-box is expanded. We stick to the default of 1 here.
  # ======================================================================= #
  _.set_wrap_width(1)
  # ======================================================================= #
  # The event where the combo-box is changed is handled next.
  # ======================================================================= #
  _.on_changed {
    handle_the_combo_box_available_exam_topics_on_changed_event
  }
  @internal_hash[:combobox_available_exam_topics] = _ # And assign it here.
  return _
end

#create_the_context_menu ⇒ Object

#

create_the_context_menu

This is the context-menu which will appear on a right-mouse click event. It currently only works on ruby-gtk3.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 638

def create_the_context_menu
  # ======================================================================= #
  # === @context_menu
  # ======================================================================= #
  @context_menu = create_context_menu(self) {{
    numbered_actions: {
      'Ask an exam question':                   :ask_an_exam_question,
      'Reveal the answer to the exam question': :reveal_the_answer_to_the_exam_question,
      'Mark the exam question as solved':       :mark_the_exam_question_as_solved,
      'Pick a new font (show the widget)':      :popup_pick_a_new_font,
      'Debug':                                  :debug
      #'Change the font in use':                :do_interactively_change_the_font,
    }
  }}
  @context_menu.make_bold
  @context_menu.set_font(:hack_18)
end

#create_the_editor ⇒ Object

#

create_the_editor (editor tag)

This method only makes sense for ruby-gtk3.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1526

def create_the_editor
  if shall_we_create_the_gtk_editor?
    require 'gtk_paradise/widgets/gtk3/editor/editor.rb'
    # ===================================================================== #
    # === @editor
    # ===================================================================== #
    @editor = ::Gtk::Editor.new { :do_not_use_the_colour_box_widget }
  else
    @editor = nil
  end
end

#create_the_emoji_toggle_widget ⇒ Object

#

create_the_emoji_toggle_widget

Note that in order to use EmojiToggleWidget, we have to pull in the right file, either ruby-gtk3 or ruby-gtk2.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1458

def create_the_emoji_toggle_widget
  require 'gtk_paradise/widgets/gtk3/emoji_toggle_widget/emoji_toggle_widget.rb'
  @a_thinking_smiley_emoji = ::Gtk::EmojiToggleWidget.new(
    :use_two_smileys
  )
  @a_thinking_smiley_emoji.make_selectable
end

#create_the_entries(use_this_font = :default_font) ⇒ Object

#

create_the_entries (entries tag, entry tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 871

def create_the_entries(
    use_this_font = :default_font
  )
  # ======================================================================= #
  # The entry "n percentage" will be created first:
  # ======================================================================= #
  create_the_entry_percentage
  # ======================================================================= #
  # === The entry for n exam questions in total comes next
  # ======================================================================= #
  create_the_entry_containing_n_questions
  create_the_entry_for_the_current_exam_topic
  create_the_entry_n_unanswered_questions
  # ======================================================================= #
  # === :entry_for_sleeping_n_seconds
  # ======================================================================= #
  create_the_entry_for_sleeping_n_seconds
  create_the_entry_n_answered_exam_questions(use_this_font)
end

#create_the_entry_for_sleeping_n_seconds ⇒ Object

#

create_the_entry_for_sleeping_n_seconds

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1174

def create_the_entry_for_sleeping_n_seconds
  # ======================================================================= #
  # === :entry_for_sleeping_n_seconds
  #
  # Next create the delay-entry that keeps track how many seconds to wait,
  # before revealing the answer (IF the user has decided to make use of
  # that functionality).
  # ======================================================================= #
  _ = entry('', 5) # entry('', 5) is primarily for jruby.
  _ << default_delay?.to_s.dup # Default delay.
  @internal_hash[:entry_for_sleeping_n_seconds] = _
  enhance_the_entry_for_sleeping_n_seconds
  return @internal_hash[:entry_for_sleeping_n_seconds]
end

#create_the_entry_for_the_current_exam_topic ⇒ Object

#

create_the_entry_for_the_current_exam_topic

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1819

def create_the_entry_for_the_current_exam_topic
  # ======================================================================= #
  # === @internal_hash[:entry_exam_topic_in_use]
  #
  # This is the entry that contains the current exam topics. The user can
  # modify the content of this entry at his or her own  discretion. It
  # is the most important entry for this widget, among all entries
  # used in this GUI application.
  #
  # This entry is positioned rather close to the top of the main widget,
  # on the left hand side. The user can thus simply manipulate it by
  # clicking on it; most users will look at the top left (or middle)
  # first.
  #
  # Another entry of this widget may depend on this entry here, so it
  # should come early in the create-entries method - aka on top of
  # this method.
  #
  # We use a completionable-entry here, but only for ruby-gtk3.
  # ======================================================================= #
  _ = entry_with_this_completion(
    available_exam_topics_in_short_form?
  )
  _.clear_background
  _.bblack1
  _.very_light_yellow_background
  _.width_height(400, 20)
  _.set_font(smaller_font?)
  _.hint = 'This is the entry that keeps '\
           'track of the current exam topic.'
  # ======================================================================= #
  # We need this entry to be fairly wide, hence the following method call.
  # ======================================================================= #
  _.set_size_request(500, 40)
  _.set_hexpand(false)
  _.set_vexpand(false)
  # ======================================================================= #
  # Allow for scroll-events.
  # ======================================================================= #
  _.enable_scroll_events
  _.on_enter {
    find_completion_for_the_entry_for_the_current_exam_topic
    the_button_ask_the_exam_question_was_clicked
  }
  _.on_scroll_event {|widget, event|
    # ===================================================================== #
    # For now this simply sets a new, random topic.
    # ===================================================================== #
    if scroll_up?(event)
      set_exam_topic(
        available_exam_topics?.sample.downcase
      )
      sync_entry_holding_all_exam_topics_onto_the_combo_box # Sync towards the combo-box.
    elsif scroll_down?(event)
      set_exam_topic(
        available_exam_topics?.sample.downcase
      )
      sync_entry_holding_all_exam_topics_onto_the_combo_box # Sync towards the combo-box.
    end
  }
  # ======================================================================= #
  # Respond to the enter-key pressed next.
  # ======================================================================= #
  # _.on_enter_key_pressed { |widget, event|
  #   sync_entry_holding_all_exam_topics_onto_the_main_combo_box
  # }
  # ======================================================================= #
  # Assign the entry-widget finally:
  # ======================================================================= #
  @internal_hash[:entry_exam_topic_in_use] = _ # And assign it here as well.
end

#create_the_entry_n_answered_exam_questions(use_this_font = :default_font) ⇒ Object Also known as: create_the_entry_containing_n_answered_exam_questions

#

create_the_entry_n_answered_exam_questions

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2231

def create_the_entry_n_answered_exam_questions(
    use_this_font = :default_font
  )
  # ======================================================================= #
  # === The entry keeping track as to how many answers have been
  #     given for that particular exam-topic.
  # ======================================================================= #
  @internal_hash[:entry_n_answered_exam_questions] = entry('', 12)
  enhance_entry_n_answered_exam_questions(use_this_font)
  return entry_n_answered_exam_questions? # And return it here.
end

#create_the_entry_n_unanswered_questions ⇒ Object Also known as: create_the_entry_containing_n_unanswered_questions, create_the_entry_containing_n_unanswered_exam_questions

#

create_the_entry_n_unanswered_questions

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1152

def create_the_entry_n_unanswered_questions
  # ======================================================================= #
  # === @entry_n_unanswered_questions
  # ======================================================================= #
  @entry_n_unanswered_questions = create_entry
  enhance_entry_containing_n_unanswered_questions(
    :default_font,
    @entry_n_unanswered_questions
  )
end

#create_the_entry_percentage(use_this_font = smaller_font? ) ⇒ Object

#

create_the_entry_percentage

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 832

def create_the_entry_percentage(
    use_this_font = smaller_font?
  )
  # ======================================================================= #
  # === Next create the percentage-entry
  # ======================================================================= #
  _ = entry('', 12)
  @internal_hash[:entry_percentage] = _
  enhance_the_entry_percentage(use_this_font) # This has to happen after the ^^^ above.
  return _
end

#create_the_labels ⇒ Object

#

create_the_labels

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2375

def create_the_labels
  # ======================================================================= #
  # === @label_n_questions_were_answered
  # ======================================================================= #
  @label_n_questions_were_answered = selectable_label
  update_the_label_n_questions_were_answered(@label_n_questions_were_answered)
end

#create_the_notebook_tab ⇒ Object

#

create_the_notebook_tab (notebook tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2524

def create_the_notebook_tab
  # ======================================================================= #
  # === @notebook_tab
  # ======================================================================= #
  @notebook_tab = create_notebook { :make_it_scrollable }
  @notebook_tab.css_class('notebook_for_the_exam_trainer')
  @notebook_tab.the_tabs_appear_on_top
  @notebook_tab.can_be_rearranged
  @notebook_tab.do_show_the_tabs
  @notebook_tab.do_show_the_border
end

#create_the_reveal_the_answer_button ⇒ Object Also known as: create_the_reveal_button

#

create_the_reveal_the_answer_button

This is the so-called “reveal button”.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2893

def create_the_reveal_the_answer_button
  # ======================================================================= #
  # === @internal_hash[:button_reveal_the_answer]              (answer tag)
  #
  # The reveal-button is created next, also known as the "answer button".
  # The mnemonic-key is set to "A", so that we can toggle between
  # "Q" and "A" for "Question" and "Answer" respectively.
  # ======================================================================= #
  _ = bold_button('Reveal the _Answer', self, true) { # This was the old emoji: ❗
    :the_button_reveal_the_answer_was_clicked
  }
  _.set_size_request(78, 30)
  #_.on_hover_lightblue
  _.hint = 'Click on this button in order to '\
    'reveal the answer to the current exam question at hand.'
  @internal_hash[:button_reveal_the_answer] = _
end

#create_the_skeleton ⇒ Object Also known as: create_skeleton

#

create_the_skeleton (create tag, skeleton tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2488

def create_the_skeleton
  create_the_entries # Should come fairly early - definitely before the grid is created.
  create_the_checkbox_shall_we_reveal_the_answer # ← Must come after the entries were created.
  create_text_buffer_for_the_answer # Must come before create_the_textviews().
  create_the_textviews
  create_the_combobox
  create_the_buttons
  create_the_editor
  create_the_labels # Should come after the editor was created.
  # create_the_emoji_toggle_widget # This currently does not work.
  create_the_thumbs_up_emoji
  create_the_context_menu # The context-menu can come last.
  # instantiate_the_control_panel # This one must come before the notebook tab is populated.
  create_the_main_grid
  create_the_notebook_tab  # This must come late.
end

#create_the_textview_that_will_contain_the_exam_question(text_buffer_for_the_question = :default_buffer) ⇒ Object

#

create_the_textview_that_will_contain_the_exam_question

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1290

def create_the_textview_that_will_contain_the_exam_question(
    text_buffer_for_the_question = :default_buffer
  )
  # ======================================================================= #
  # === @internal_hash[:textview1]
  # ======================================================================= #
  _ = create_textview(text_buffer_for_the_question)
  _.set_left_right_margin(USE_THIS_MARGIN)
  _.word_wrap
  scrolled_window_containing_the_textarea1 = create_scrolled_window(
    _
  ) { :only_up_and_bottom }
  scrolled_window_containing_the_textarea1.set_name('textview1_for_the_studium_gem') # Contains the question.
  scrolled_window_containing_the_textarea1.set_size_request(920, 180)
  @internal_hash[:textview1] = _
  @internal_hash[:scrolled_window_containing_the_textarea1] = scrolled_window_containing_the_textarea1
end

#create_the_textviews ⇒ Object

#

create_the_textviews

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1342

def create_the_textviews
  create_the_textview_that_will_contain_the_exam_question
  # ======================================================================= #
  # === @internal_hash[:textview2]
  # ======================================================================= #
  create_the_widget_for_the_exam_answer
  # ======================================================================= #
  # === @internal_hash[:textview3]
  # ======================================================================= #
  create_the_widget_for_the_freeform_textview
  create_scrolled_window3 # And create the scrolled-window3 here as well.
end

#create_the_thumbs_up_emoji ⇒ Object

#

create_the_thumbs_up_emoji

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1012

def create_the_thumbs_up_emoji
  # ======================================================================= #
  # Add the thumbs-up emoji, but only if we use emojis.
  # ======================================================================= #
  if use_emoji?
    event_box_for_the_thumbs_up_emoji = create_event_box(label(' 👍'))
  else
    event_box_for_the_thumbs_up_emoji = create_event_box(image_trophy_gold)
  end
  @thumbs_up_emoji = event_box_for_the_thumbs_up_emoji.on_clicked {
    do_ask_a_new_exam_question
  }
end

#create_the_widget_for_the_exam_answer(use_this_text_buffer = @text_buffer_for_the_answer) ⇒ Object Also known as: create_text_view_for_the_answer

#

create_the_widget_for_the_exam_answer (answer tag, answers tags)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1358

def create_the_widget_for_the_exam_answer(
    use_this_text_buffer = @text_buffer_for_the_answer
  )
  _ = create_textview(use_this_text_buffer)
  _.set_left_right_margin(USE_THIS_MARGIN)
  _.word_wrap
  @internal_hash[:textview2] = _
  scrolled_window = create_scrolled_window(
    _
  ) { :only_up_and_bottom }
  scrolled_window.set_name('textview2_for_the_studium_gem') # Contains the answer.
  scrolled_window.set_size_request(1000, 150)
  scrolled_window.min_content_width  = 100
  scrolled_window.min_content_height = 200
  scrolled_window.do_show_the_scrollbars
  @scrolled_window_containing_the_textarea2 = scrolled_window
  return _ # And return it too, just in case.
end

#create_the_widget_for_the_freeform_textview ⇒ Object

#

create_the_widget_for_the_freeform_textview

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1051

def create_the_widget_for_the_freeform_textview
  # ======================================================================= #
  # === @internal_hash[:textview3]
  # ======================================================================= #
  _ = create_textview
  _.bblack1
  _.set_left_right_margin(USE_THIS_MARGIN)
  # ======================================================================= #
  # The next code sets up a default placeholder text. Upon a focus-in-event
  # that default placeholder text is removed.
  # ======================================================================= #
  _.buffer.set_placeholder_text(
    DEFAULT_PLACEHOLDER_TEXT
  )
  _.buffer.sync_placeholder_text
  _.word_wrap
  _.focus_in_event {
    if _.buffer.text? == DEFAULT_PLACEHOLDER_TEXT
      _.buffer.clear # Remove that placeholder text in this case.
    end
  }
  @internal_hash[:textview3] = _
  return _
end

#create_then_return_the_default_grid ⇒ Object Also known as: create_the_main_grid

#

create_then_return_the_default_grid

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2475

def create_then_return_the_default_grid
  grid = default_grid # main_grid?
  grid.pad2px
  grid.default_spacing(8)
  grid.width_height(width?,     height?)
  grid.set_size_request(width?, height?)
  @internal_hash[:main_grid] = grid
  return grid
end

#current_exam_topic_from_the_entry? ⇒ Boolean Also known as: current_exam_topic_as_a_string?

#

current_exam_topic_from_the_entry?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2293

def current_exam_topic_from_the_entry?
  entry_for_the_current_exam_topic?.text?.to_s
end

#debug ⇒ Object

#

debug

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 430

def debug
  pp array_all_exam_questions?
  pp array_all_exam_questions?.size
end

#default_exam_topic? ⇒ Boolean

#

default_exam_topic?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 455

def default_exam_topic?
  USE_THIS_AS_THE_DEFAULT_EXAM_TOPIC
end

#delay_to_use? ⇒ Boolean Also known as: default_delay?

#

default_delay?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1945

def delay_to_use?
  @internal_hash[:delay_to_use]
end

#deselect_the_entry_containing_the_exam_topic(i = entry_for_the_current_exam_topic? ) ⇒ Object

#

deselect_the_entry_containing_the_exam_topic

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1325

def deselect_the_entry_containing_the_exam_topic(
    i = entry_for_the_current_exam_topic?
  )
  i.deselect
  text_view_containing_the_current_question?.set_focus(true)
end

#do_assign_a_new_exam_topic ⇒ Object

#

do_assign_a_new_exam_topic

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 950

def do_assign_a_new_exam_topic
  clear_reveal_the_answer
  this_topic = select_not_yet_completed_exam_topics(
    available_exam_topics?
  ).sample # Obtain a random exam topic here.
  entry_for_the_current_exam_topic?.set_text(this_topic.to_s)
  sync_entry_holding_all_exam_topics_onto_the_combo_box
  do_ask_an_exam_question
end

#do_assign_the_default_exam_topic_to_the_correct_entry ⇒ Object

#

do_assign_the_default_exam_topic_to_the_correct_entry

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1318

def do_assign_the_default_exam_topic_to_the_correct_entry
  set_exam_topic(USE_THIS_AS_THE_DEFAULT_EXAM_TOPIC)
end

#do_clear_the_free_form_textarea ⇒ Object

#

do_clear_the_free_form_textarea

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1483

def do_clear_the_free_form_textarea
  free_form_textarea?.set_text('')
end

#do_clear_the_question_buffer ⇒ Object Also known as: clear_question_buffer, clear_questions_buffer

#

do_clear_the_question_buffer

Clear the question-buffer via this method.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 908

def do_clear_the_question_buffer
  text_buffer_for_the_question?.set_text('')
end

#do_interactively_change_the_font ⇒ Object

#

do_interactively_change_the_font

This does not work. :(

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 521

def do_interactively_change_the_font
  require 'gtk_paradise/widgets/gtk3/text_entry_widget/text_entry_widget.rb'
  require 'gtk_paradise/examples/gtk3/gtk_dialog_sample.rb'
  _ = ::Gtk::TextEntryWidget.run
  ::Gtk::DialogSample.new(_)
  ::Gtk.main
  e 'The selection was:'
  e
  pp _.selection?
  e
end

#do_jump_into_the_entry_containing_the_current_exam_topic ⇒ Object

#

do_jump_into_the_entry_containing_the_current_exam_topic

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 423

def do_jump_into_the_entry_containing_the_current_exam_topic
  entry_for_the_current_exam_topic?.do_focus_on_it
end

#do_open_the_current_exam_topic_file(use_this_as_exam_topic = current_exam_topic_from_the_entry? ) ⇒ Object

#

do_open_the_current_exam_topic_file

This method can either open the exam-file in the bluefish editor, or in the integrated ruby-gtk editor. Since as of July 2021 we will try the integrated variant. Unfortunately ruby-gtk is somehow buggy - reading a large file leads to a BadAlloc error, so this was changed to open an external editor instead.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2306

def do_open_the_current_exam_topic_file(
    use_this_as_exam_topic = current_exam_topic_from_the_entry?
  )
  use_this_as_exam_topic = Studium.find_corresponding_exam_topic(use_this_as_exam_topic)
  if use_this_as_exam_topic.empty?
    do_popup_the_you_have_to_provide_an_exam_topic
  end
  # ======================================================================= #
  # We must obtain the correct path next, to then send into the editor:
  # ======================================================================= #
  use_this_as_exam_topic = Studium.path_to_exam_topic?+
                           File.basename(use_this_as_exam_topic)
  if use_the_internal_editor? # This here is when we use the internal editor.
    set_save_into_this_local_file(use_this_as_exam_topic)
    set_editor_buffer(File.read(use_this_as_exam_topic))
    @notebook_tab.focus_on_this_tab(2)
  else
    # ======================================================================= #
    # Or simply use bluefish or whatever else the editor is.
    # ======================================================================= #
    _ = "#{use_this_editor?} #{use_this_as_exam_topic}"
    esystem(_)
  end
end

#do_popup_the_array_of_all_exam_questions(array = :infer) ⇒ Object

#

do_popup_the_array_of_all_exam_questions

This method will be called then whe icon-with-glasses is clicked.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2681

def do_popup_the_array_of_all_exam_questions(
    array = :infer
  )
  case array
  # ======================================================================= #
  # === :infer
  # ======================================================================= #
  when :infer
    array = Studium.return_all_exam_questions_from_this_topic(
      entry_exam_topic_as_string?
    )
  end
  content = array.map.with_index {|line, index| index += 1
    line = line.dup
    line.prepend(
      "(#{index}) "
    )
    line
  }.join("\n")
  text_buffer = create_text_buffer(content)
  text_view   = create_text_view(text_buffer)
  scrolled_window = create_scrolled_window(text_view)
  scrolled_window.width_height(1200, 700)
  scrolled_window.pad8px
  # scrolled_window.add(text_view)
  scrolled_window.show_all
  popup_over_this_widget(
    scrolled_window,
    text_view,
    entry_for_the_exam_topic?
  ).popup
end

#do_popup_the_you_have_to_provide_an_exam_topic ⇒ Object

#

do_popup_the_you_have_to_provide_an_exam_topic

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2717

def do_popup_the_you_have_to_provide_an_exam_topic
  bold_popover_message = bold_label(
    "You have to provide an exam-topic, in the exam-topic entry.\n\n"\
    "The arrow should indicate the proper entry."
  )
  popover_message( # Nudge the user here.
    bold_popover_message,
    entry_for_the_exam_topic?
  ).popup
end

#do_sleep_now(i = :default, use_this_as_timeout = 0) ⇒ Object

#

do_sleep_now (sleep tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2957

def do_sleep_now(
    i                   = :default,
    use_this_as_timeout = 0
  )
  case i
  # ======================================================================= #
  # === :default
  #
  # This will always obtain the value from the proper entry.
  # ======================================================================= #
  when :default,
       :use_the_correct_entry_for_the_delay
    i = entry_sleep_n_seconds?.text?
  end
  i = i.to_f # Always use a float here.
  # ======================================================================= #
  # An alternative to sleep() would be this:
  #
  #   GLib::Timeout.add(use_this_as_timeout) {
  #     @text_view_for_the_answer.set_text(answer)
  #     false
  #   }
  #
  # ======================================================================= #
  if use_this_as_timeout >= 0 and
     checkbox_shall_we_reveal_the_answer?.is_it_active?
    sleep(i)
  end
end

#do_style_all_buttons_uniformly(i = return_all_buttons) ⇒ Object

#

do_style_all_buttons_uniformly (style tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1242

def do_style_all_buttons_uniformly(
    i = return_all_buttons
  )
  # ======================================================================= #
  # Style all buttons uniformly next, via CSS.
  # ======================================================================= #
  i.each {|this_button|
    # ===================================================================== #
    # Use the same CSS rule for each button.
    # ===================================================================== #
    this_button.clear_background
    this_button.bblack2
    this_button.set_size_request(75, 28)
    this_button.set_name('button_hover_transition')
  }
end

#do_update_the_entries_n_answered_and_n_unanswered ⇒ Object

#

do_update_the_entries_n_answered_and_n_unanswered

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 740

def do_update_the_entries_n_answered_and_n_unanswered
  do_update_the_entry_n_unanswered_questions
  update_n_unanswered 
end

#do_update_the_entry_n_questions(current_exam_topic = current_exam_topic? ) ⇒ Object

#

do_update_the_entry_n_questions

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 340

def do_update_the_entry_n_questions(
    current_exam_topic =
      current_exam_topic?
  )
  set_n_exam_questions(
    return_n_questions_from_the_currently_selected_topic(current_exam_topic).to_s
  )
end

#do_update_the_entry_n_unanswered_questions ⇒ Object Also known as: update_the_entry_n_unanswered_questions, update_n_unanswered

#

do_update_the_entry_n_unanswered_questions

This method depends on two entries being set correctly.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2759

def do_update_the_entry_n_unanswered_questions
  _ = entry_containing_n_questions?.text?.to_i -
      entry_containing_n_answers?.text?.to_i 
  entry_containing_n_unanswered_questions?.set_text(_.to_s)
end

#enable_all_key_combinations ⇒ Object

#

enable_all_key_combinations

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1592

def enable_all_key_combinations
  # ======================================================================= #
  # === @accel_group
  # ======================================================================= #
  @accel_group = create_and_add_gtk_accel_group
  enable_alt_w_key_combination
  enable_alt_y_key_combination
  enable_alt_1_key_combination
end

#enable_alt_1_key_combination ⇒ Object

#

enable_alt_1_key_combination

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 767

def enable_alt_1_key_combination
  # ======================================================================= #
  # Add alt+1 key combination:
  # ======================================================================= #
  use_this_key = Gdk::Keyval::KEY_1
  @accel_group.connect(use_this_key, :mod1_mask, :visible) { # alt+1
    entry_ask_questions?.set_focus(true)
  }
end

#enable_alt_w_key_combination(i = @accel_group) ⇒ Object

#

enable_alt_w_key_combination

This method will specifically enable the “alt+w” shortcut.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2278

def enable_alt_w_key_combination(
    i = @accel_group
  )
  # ======================================================================= #
  # Add alt+w key combination, to open the current exam topic file:
  # ======================================================================= #
  use_this_key = ::Gdk::Keyval::KEY_W
  i.connect(use_this_key, :mod1_mask, :visible) { # alt+w
    do_open_the_current_exam_topic_file
  }
end

#enable_alt_y_key_combination ⇒ Object

#

enable_alt_y_key_combination

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 780

def enable_alt_y_key_combination
  # ======================================================================= #
  # Add alt+y key combination, to assign a new exam topic:
  # ======================================================================= #
  use_this_key = Gdk::Keyval::KEY_Y
  @accel_group.connect(use_this_key, :mod1_mask, :visible) { # alt+y
    do_assign_a_new_exam_topic
  }
end

#enable_the_main_key_combinations(use_this_hash = HASH_DESIGNATED_KEY_COMBINATIONS) ⇒ Object

#

enable_the_main_key_combinations

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1994

def enable_the_main_key_combinations(
    use_this_hash = HASH_DESIGNATED_KEY_COMBINATIONS
  )
  enable_these_key_combinations(
    use_this_hash
  )
end

#enhance_entry_n_answered_exam_questions(use_this_font = :default_font, entry = entry_n_answered_exam_questions? ) ⇒ Object

#

enhance_entry_n_answered_exam_questions

This method can be used to enhance the entry “n answered exam questions”.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2206

def enhance_entry_n_answered_exam_questions(
    use_this_font = :default_font,
    entry         = entry_n_answered_exam_questions?
  )
  case use_this_font
  # ======================================================================= #
  # === :default_font
  # ======================================================================= #
  when :default_font, nil
    use_this_font = smaller_font?
  end
  # ======================================================================= #
  # === @internal_hash[:entry_n_answered_exam_questions]
  # ======================================================================= #
  entry.set_font(use_this_font) if use_this_font
  entry.width_height(320, 22)
  entry.bblack1
  entry.very_light_yellow_background
  entry.center
  entry.readonly
end

#enhance_the_entry_containing_n_questions(use_this_font = smaller_font?, , entry = ) ⇒ Object

#

enhance_the_entry_containing_n_questions

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2188

def enhance_the_entry_containing_n_questions(
    use_this_font = smaller_font?,
    entry         = @internal_hash[:entry_n_total_exam_questions]
  )
  entry.set_font(use_this_font) if use_this_font
  entry.clear_background
  entry.width_height(350, 22)
  entry.bblack1
  entry.center
  entry.readonly
  entry.very_light_yellow_background
end

#enhance_the_entry_for_sleeping_n_seconds(i = entry_for_sleeping_n_seconds? ) ⇒ Object

#

enhance_the_entry_for_sleeping_n_seconds

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2152

def enhance_the_entry_for_sleeping_n_seconds(
    i = entry_for_sleeping_n_seconds?
  )
  i.width_height(45, 20)
  i.center
  i.bblack1
  i.set_name('BG_bisque')
  i.hint =
    'Provide the delay here, as <b>n seconds</b>. This will only work '\
    'if the checkbox to the right side <b>active</b>.'
end

#enhance_the_entry_percentage(use_this_font = nil) ⇒ Object

#

enhance_the_entry_percentage

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2167

def enhance_the_entry_percentage(
    use_this_font = nil
  )
  _ = entry_percentage?
  _.hint =
    "This field denotes how many questions have already\n"\
    "been answered successfully, <b>in percent</b>.\n\n"\
    "Note that this requires a specific exam topic to "\
    "have been set, so no percentage value may be "\
    "shown initially.\n\nSimply assign to an exam topic "\
    "and it should work fine."
  _.do_center
  _.disable_user_input # The user can not change this entry.
  _.set_font(use_this_font) if use_this_font
  _.set_name('BG_bisque')
  _.bblack1
end

#entry_delay_value? ⇒ Boolean

#

entry_delay_value?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2877

def entry_delay_value?
  entry_for_sleeping_n_seconds?.text?.to_f
end

#entry_exam_topic_in_use? ⇒ Boolean Also known as: entry_for_the_current_exam_topic?, entry_for_the_exam_topic?, entry_holding_all_exam_topics?, entry_current_exam_topic?

#

entry_exam_topic_in_use?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2464

def entry_exam_topic_in_use?
  @internal_hash[:entry_exam_topic_in_use]
end

#entry_for_sleeping_n_seconds? ⇒ Boolean Also known as: entry_delay_to_use?, entry_sleep_n_seconds?, entry_delay?, return_entry_for_sleeping_n_seconds, return_the_entry_sleep_n_seconds

#

entry_for_sleeping_n_seconds?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2866

def entry_for_sleeping_n_seconds?
  @internal_hash[:entry_for_sleeping_n_seconds]
end

#entry_n_answered_exam_questions? ⇒ Boolean Also known as: entry_containing_n_answers?

#

entry_n_answered_exam_questions?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1167

def entry_n_answered_exam_questions?
  @internal_hash[:entry_n_answered_exam_questions]
end

#entry_n_total_exam_questions? ⇒ Boolean Also known as: entry_containing_n_questions?

#

entry_n_total_exam_questions?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1638

def entry_n_total_exam_questions?
  @internal_hash[:entry_n_total_exam_questions]
end

#entry_n_unanswered_questions? ⇒ Boolean Also known as: entry_containing_n_unanswered_questions?, entry_containing_n_unanswered_questions

#

entry_n_unanswered_questions?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1690

def entry_n_unanswered_questions?
  @entry_n_unanswered_questions
end

#entry_percentage? ⇒ Boolean Also known as: return_entry_percentage

#

entry_percentage?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1192

def entry_percentage?
  @internal_hash[:entry_percentage]
end

#exam_answer? ⇒ Boolean

#

exam_answer?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2933

def exam_answer?
  @internal_hash[:exam_answer]
end

#exam_question? ⇒ Boolean Also known as: current_exam_question?

#

exam_question?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 3106

def exam_question?
  @internal_hash[:exam_question]
end

#exam_question_object? ⇒ Boolean

#

exam_question_object?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2884

def exam_question_object?
  @internal_hash[:exam_question_object]
end

#exam_topic_from_the_correct_entry? ⇒ Boolean Also known as: entry_ask_questions_from_this_topic?, current_exam_topic?, main_exam_topic?, exam_topic?, current_topic?, entry_exam_topic?, entry_ask_questions?, entry_exam_topic_as_string?

#

exam_topic_from_the_correct_entry?

This method must always return a string, hence the .to_s call.

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2733

def exam_topic_from_the_correct_entry?
  entry_exam_topic_in_use?.text?.to_s.strip # This must always be a String.
end

#find_completion_for_the_entry_for_the_current_exam_topic ⇒ Object

#

find_completion_for_the_entry_for_the_current_exam_topic

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 325

def find_completion_for_the_entry_for_the_current_exam_topic
  _ = entry_for_the_current_exam_topic?
  current_text = _.text?
  new_text     = Studium.exam_topic_completion(current_text) { :be_quiet } # Expand it here.
  if new_text
    unless new_text == current_text
      set_exam_topic(new_text)
    end
    one_two_three # The old call was: do_update_the_entry_n_questions
  end
end

#handle_CSS ⇒ Object

#

handle_CSS (CSS tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 508

def handle_CSS
  use_gtk_paradise_project_css_file
  append_project_css_file(
    Studium.project_base_directory?+'css/project.css'
  )
  apply_the_CSS_rules
end

#handle_the_combo_box_available_exam_topics_on_changed_event ⇒ Object Also known as: do_handle_the_combobox_available_exam_topics_on_changed_event, sync_the_current_exam_topic_onto_the_exam_topic_entry

#

handle_the_combo_box_available_exam_topics_on_changed_event

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2787

def handle_the_combo_box_available_exam_topics_on_changed_event
  clear_question_buffer
  # ===================================================================== #
  # Now we need to sync from the combo-box towards the current
  # exam-entry.
  # ===================================================================== #
  sync_combo_box_entry_onto_the_current_exam_entry
  one_two_three
end

#hash_dataset_of_all_lectures? ⇒ Boolean

#

hash_dataset_of_all_lectures?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1311

def hash_dataset_of_all_lectures?
  @internal_hash[:hash_dataset_of_all_lectures]
end

#instantiate_the_control_panel ⇒ Object

#

instantiate_the_control_panel

This only works for ruby-gtk3.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 661

def instantiate_the_control_panel
  require 'studium/gui/gtk3/control_panel/control_panel.rb'
  # ======================================================================= #
  # === @control_panel
  # ======================================================================= #
  @control_panel = ::Studium::GUI::Gtk::ControlPanel.new(self)
  @control_panel.use_this_font(main_font?)
end

#label_n_questions_were_answered? ⇒ Boolean

#

label_n_questions_were_answered?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2386

def label_n_questions_were_answered?
  @label_n_questions_were_answered
end

#larger_font? ⇒ Boolean

#

larger_font?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 416

def larger_font?
  LARGER_FONT
end

#let_the_scrolled_window_for_the_answer_parse_URLs(scrolled_window_for_the_answer = scrolled_window_for_the_answer? ) ⇒ Object

#

let_the_scrolled_window_for_the_answer_parse_URLs

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 352

def let_the_scrolled_window_for_the_answer_parse_URLs(
    scrolled_window_for_the_answer = scrolled_window_for_the_answer?
  )
  # ======================================================================= #
  # The scrolled-window for the answer allows the user to click on 
  # hyperlinks - or at the least this is the idea. It does not
  # work 100% yet because we need to get the selection first
  # rather than select the whole entry.
  # ======================================================================= #
  scrolled_window_for_the_answer.on_button_release_event {
    parse_for_URL(text_view_for_the_answer?.text?)
  } if scrolled_window_for_the_answer
end

#main_font? ⇒ Boolean

#

main_font?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 448

def main_font?
  USE_THIS_FONT
end

#main_grid? ⇒ Boolean

#

main_grid?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2457

def main_grid?
  @internal_hash[:main_grid]
end

#may_we_reveal_the_answer_after_a_delay? ⇒ Boolean Also known as: may_we_reveal_the_answer?

#

may_we_reveal_the_answer_after_a_delay?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2950

def may_we_reveal_the_answer_after_a_delay?
  @internal_hash[:may_we_reveal_the_answer_after_a_delay]
end

#notify_the_user_that_all_questions_have_been_answered_in_this_topic(this_topic = current_exam_topic?, , this_widget = button_reveal_the_answer? ) ⇒ Object

#

notify_the_user_that_all_questions_have_been_answered_in_this_topic

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1136

def notify_the_user_that_all_questions_have_been_answered_in_this_topic(
    this_topic  = current_exam_topic?,
    this_widget = button_reveal_the_answer?
  )
  bold_popover_message = create_bold_label(
    'All questions have been answered for '+this_topic+'. \o/'
  )
  popover_message(
    bold_popover_message,
    this_widget
  ).popup
end

#one_two_three(use_this_topic = exam_topic_from_the_correct_entry? ) ⇒ Object Also known as: update_n_questions, update_three_important_widgets

#

one_two_three (one_two_three tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2990

def one_two_three(
    use_this_topic =
      exam_topic_from_the_correct_entry?
  )
  update_array_all_exam_questions
  if use_this_topic.empty?
    # ===================================================================== #
    # First protect against empty exam topics, with a helpful message to
    # the user.
    # ===================================================================== #
    do_popup_the_you_have_to_provide_an_exam_topic
  end
  unless ::Studium.is_this_exam_topic_available?(use_this_topic)
    # ===================================================================== #
    # Here we must notify the user that this exam-topic is not registered
    # aka not available.
    # ===================================================================== #
    popover_message( # Nudge the user here.
      text(
        ' <b>⚠️</b> No exam-entry called <b>'+use_this_topic.to_s+
        '</b> is available. <b>⚠️</b>'
      ),
      entry_for_the_exam_topic?
    ).popup
    return
  end
  local_file = Studium.local_exam_file(use_this_topic)
  if File.exist?(local_file)
    update_hash_dataset_of_all_lectures
    # ===================================================================== #
    # (1) Pass the current exam topic into a method that will return
    #     an Array.
    # ===================================================================== #
    # array = Studium.return_an_array_for_this_exam_topic(use_this_topic)
    dataset = Studium.read_in_unanswered_exam_questions_from_this_file(local_file)
    sample = dataset.sample
    n_exam_questions_in_total   = Studium.n_exam_questions_in_this_topic?(File.basename(local_file))
    n_unanswered_exam_questions = dataset.size
    n_answered_exam_questions   = n_exam_questions_in_total - n_unanswered_exam_questions 
    # ===================================================================== #
    # (3) Next we must update various entries:
    # ===================================================================== #
    set_n_exam_questions_exist_in_total(n_exam_questions_in_total)
    set_n_unanswered_questions(n_unanswered_exam_questions)
    set_n_exam_questions_were_already_answered(n_answered_exam_questions)
    set_n_percentage(
      n_answered_exam_questions.to_f * 100.0 / n_exam_questions_in_total
    )
    if entry_percentage?.text?.to_f == 100.0
      # =================================================================== #
      # Handle the case where the exam-topic at hand has been answered
      # completely.
      # =================================================================== #
      bold_popover_message = label(
        "All questions have been answered for the topic <b>"\
        "#{current_exam_topic?}</b>.\n\n       <b>Please choose another exam topic</b>.\n"
      )
      popover_message(
        bold_popover_message,
        button_ask_the_exam_question?
      ).popup
    else
      # =================================================================== #
      # Next keep a backup-reference
      # =================================================================== #
      ::Studium.set_last_exam_question_line(sample)
      # =================================================================== #
      # Keep a reference to the exam-question object:
      # =================================================================== #
      @internal_hash[:exam_question_object] = Studium::Exams::ExamQuestion.new(sample)
      @internal_hash[:may_we_reveal_the_answer_after_a_delay] = true
      clear_the_exam_answer
      last_exam_question_asked = current_exam_question?
      set_exam_question(
        @internal_hash[:exam_question_object].question?,
        :remove_tags
      )
      Thread.new {
        if may_we_reveal_the_answer_after_a_delay?
          do_sleep_now(:use_the_correct_entry_for_the_delay)
          unless last_exam_question_asked == current_exam_question?
            reveal_the_exam_answer(:but_only_if_we_may)
          end
        end
      }
    end
  else
    e "No file exists at `#{local_file}`."
  end
end

#original_return_available_exam_topics ⇒ Object

#

original_return_available_exam_topics

This variant is probably no longer necessary, but it is retained for now.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 628

def original_return_available_exam_topics
  Studium.return_available_exam_topics
end

#padding? ⇒ Boolean

#

padding?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 310

def padding?
  8
end

#parse_for_URL(i = text_view_for_the_answer?.buffer.text) ⇒ Object

#

parse_for_URL

This method can be used to return all URLs in a given text.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1031

def parse_for_URL(
    i = text_view_for_the_answer?.buffer.text
  )
  array = ::Studium.return_all_URLs_from(i)
  if array.size > 0
    first_entry = array.first
    # ===================================================================== #
    # We first have to assign it to the GUI part. Note that the "browser"
    # is part of the control-panel since the rewrite in January 2021.
    # ===================================================================== #
    if respond_to?(:control_panel?) and control_panel?.respond_to?(:browser?)
      control_panel?.browser?.assign_this_text(first_entry)
    end
    ::Studium.open_this_remote_url(first_entry)
  end
end

#parse_the_commandline_arguments ⇒ Object

#

parse_the_commandline_arguments

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1659

def parse_the_commandline_arguments
  _ = commandline_arguments?
  unless _.empty?
    new_topic = _.first
    # ===================================================================== #
    # === Handle numbers given as input here:
    #
    # Example:
    #
    #   ruby misc.rb 5
    #
    # ===================================================================== #
    if new_topic =~ /^\d+$/ # A number - and only a number - was given to this class here.
      new_topic = new_topic.to_i
      new_topic = Studium.exam_topic_number?(new_topic).to_s
    end
    new_topic = Studium.find_corresponding_exam_topic(new_topic)
    entry_for_the_current_exam_topic?.set_text(new_topic)
    # ===================================================================== #
    # Next, we must also update the combo-box.
    # This is currently not enabled:
    # _.find_and_try_to_select_this_entry(new_topic)
    # simply_assign_this_as_the_new_exam_topic_onto_the_primary_combobox(new_topic)
    # ===================================================================== #
    one_two_three
  end
end

#populate_the_main_grid(grid = main_grid? ) ⇒ Object

#

populate_the_main_grid (grid tag, populate tag)

In order to populate the grid, all widgets have to be designated.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2007

def populate_the_main_grid(
    grid = main_grid?
  )
  reset_the_grid_counter # Just to be safe.
  ::Gtk::Grid.full_width = 3 # 3 entries per row.
  grid.left(
    return_frame_containing_the_label_exam_topic
  )
  grid.middle(
    entry_exam_topic_in_use?
  )
  mini_hbox = create_hbox
  mini_hbox.maximal(combobox_available_exam_topics?,    2)
  mini_hbox.minimal(return_event_box_with_face_glasses, 2)
  # ======================================================================= #
  # The event-box comes next to the box with face-glasses:
  # ======================================================================= #
  mini_hbox.minimal(return_eventbox_with_an_image_to_exit_the_application, 2)

  grid.right(mini_hbox) # One row has been completed here.

  grid.full_line(scrolled_window1?)
  grid.full_line(scrolled_window_containing_the_textarea2?)
  # ========================================================================= #
  # Show a little helpful text how to use the textview3:
  # ========================================================================= # 
  grid.full_line(return_hbox_containing_two_icons_and_instructions_what_to_do_with_the_free_form_textarea)
  # ======================================================================= #
  # Next add the free-form widget:
  # ======================================================================= #
  grid.full_line(return_scrolled_window3)
  # ======================================================================= #
  # Next synchronize the design layout of the three scrolled windows:
  # ======================================================================= #
  [
    scrolled_window1?,
    scrolled_window2?,
    scrolled_window3?
  ].each {|this_widget|
    this_widget.pad8px
  }

  # ======================================================================= #
  # Next comes the middle-part of the GUI                      (middle tag)
  # ======================================================================= #

  # ======================================================================= #
  # === n questions in total
  #
  # This will show the "n questions in total" text.
  # ======================================================================= #
  text = selectable_text(N_EXAM_QUESTIONS_IN_TOTAL)
  text.set_font(smaller_font?)
  text.pad6px
  mini_hbox = create_hbox(text, entry_n_total_exam_questions?)
  grid.left(mini_hbox)

  # ======================================================================= #
  # === n unanswered questions
  # ======================================================================= #
  text = selectable_text(N_UNANSWERED_EXAM_QUESTIONS)
  text.set_font(smaller_font?)
  text.pad6px
  mini_hbox = create_hbox(text, entry_n_unanswered_questions?)
  grid.middle(mini_hbox)

  # ======================================================================= #
  # === n answered exam questions
  #
  # This is the text that goes along the lines of
  # "n answered exam questions".
  # ======================================================================= #
  text = selectable_text(N_ANSWERED_EXAM_QUESTIONS)
  text.set_font(smaller_font?)
  text.pad6px
  text.royalblue
  text.make_bold
  mini_hbox = create_hbox(text, entry_n_answered_exam_questions?)
  grid.right(mini_hbox)

  # ======================================================================= #
  # === The entry "percentage solved" comes next
  # ======================================================================= #
  text = selectable_text(N_PERCENT_SOLVED)
  text.set_font(smaller_font?)
  text.pad6px
  mini_hbox = create_hbox
  mini_hbox.minimal(text, 1)
  mini_hbox.maximal(entry_percentage?, 1)
  grid.left(mini_hbox)

  # ======================================================================= #
  # === sleep n seconds solved
  #
  # Next we add the delay-n-seconds entry.
  # ======================================================================= #
  text = selectable_text(SLEEP_N_SECONDS)
  text.set_font(smaller_font?)
  text.pad6px
  mini_hbox = create_hbox
  mini_hbox.minimal(text, 1)
  mini_hbox.maximal(entry_for_sleeping_n_seconds?, 1)
  grid.middle(mini_hbox)
  grid.right(checkbox?)

  # ======================================================================= #
  # Add three buttons next:
  # ======================================================================= #
  grid.left(button_ask_the_exam_question?)
  grid.middle(button_reveal_the_answer?)
  grid.right(button_solve_the_exam_question?)

  # ======================================================================= #
  # And two more buttons:
  # ======================================================================= #
  grid.left(button_clear?)
  mini_hbox.set_hexpand(true)

  mini_hbox = create_hbox
  mini_hbox.minimal(return_wikipedia_widget,                         2)
  mini_hbox.minimal(return_event_box_for_asking_a_random_exam_topic, 2)
  mini_hbox.minimal(button_use_random_entry_from_the_ten_aliases?,   2)
  mini_hbox.minimal(return_button_open_exam_topic_file,              2)
  # ======================================================================= #
  # We could also add smiley-emojis next:
  #
  #   mini_hbox.minimal(@a_thinking_smiley_emoji,                    2)
  #   mini_hbox.minimal(@thumbs_up_emoji,                            2)
  #
  # ======================================================================= #
  grid.two_width(mini_hbox)
  grid.new_line
  # ======================================================================= #
  # Next add the label that the ^^^ button can update:
  # ======================================================================= #
  grid.left(button_update_n_questions_were_answered?)
  grid.two_width(label_n_questions_were_answered?)
  grid.new_line
  mini_hbox = create_hbox
  return grid
end

#populate_the_notebook_tab ⇒ Object

#

populate_the_notebook_tab

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2546

def populate_the_notebook_tab
  # ======================================================================= #
  # We could display a Curriculum in a notebook-tab. Unfortunately, in
  # 2021, this is a bit wide, and makes the whole notebook appear too
  # large, so it was disabled again, until we improve on it. We probably
  # have to decrease its size from the get go, and manage it at all
  # times via scrolled-widgets.
  #
  # The old code is shown next:
  #
  #   label4 = modify_bold_label('Curriculum Viewer', @internal_hash[:colour_to_use_for_the_notebook_labels])
  #   @notebook_tab.add_tab(::Studium::GUI::Gtk::CurriculumViewer.new, label4)
  #
  # ======================================================================= #
  show_ten_aliases = show_ten_aliases?
  # ======================================================================= #
  # === Add the first tab, containing the "Exam Trainer" widget next
  #
  # This will be contained in @first_vbox, which in turn contains
  # the @horizontal_pane variable.
  # ======================================================================= #
  @notebook_tab.append_page(
    main_grid?,
    modify_bold_label('Exam trainer', @internal_hash[:colour_to_use_for_the_notebook_labels])
  )
  if use_the_internal_editor?
    # ===================================================================== #
    # Append the editor in this event:
    # ===================================================================== #
    @notebook_tab.append_page(@editor, bold_text('editor'))
  end
  if Object.const_defined?(:Roebe) and show_ten_aliases
    # ===================================================================== #
    # Designate the parent widget next:
    # ===================================================================== #
    show_ten_aliases.set_parent_widget(self)
    # ===================================================================== #
    # And append the show-ten-aliases widget next:
    # ===================================================================== #
    @notebook_tab.append_page(
      show_ten_aliases,
      modify_bold_label(
        'Current top-ten exams', @internal_hash[:colour_to_use_for_the_notebook_labels]
      )
    )
  end
  @notebook_tab.the_first_tab_is_active
  # ======================================================================= #
  # === Add the tab that includes the Control Panel
  # ======================================================================= #
  # label2 = modify_bold_label('Control Panel', @internal_hash[:colour_to_use_for_the_notebook_labels])
  # @notebook_tab.append_page(
  #   @control_panel,
  #   label2
  # )
end

#popup_pick_a_new_font ⇒ Object

#

popup_pick_a_new_font

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 793

def popup_pick_a_new_font
  _ = create_hbox
  _.minimal(text(' → '))
  file_chooser_widget = button('Choose font here')
  file_chooser_widget.set_size_request(800, 660)
  file_chooser_widget.bblack2
  file_chooser_widget.disallow_resizing
  _.minimal(file_chooser_widget) # Add the file-chooser widget here.
  file_chooser_widget.on_click {
    result = gtk_font_chooser_dialog
    set_use_this_font(::Gtk.main_file?)
    result.destroy
  }
  # ======================================================================= #
  # Next create the popup for the font-choosing.
  # ======================================================================= #
  popup_widget = popup_over_this_widget(
    text_view_for_the_question?,
    '',
    _
  )
  # popup_widget.no_arrow # ← This will only work on gtk4, I think.
  popup_widget.popup
end

#question_is? ⇒ Boolean

#

question_is?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1931

def question_is?
  @internal_hash[:exam_question_object].question?
end

#reset ⇒ Object

#

reset (reset tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 202

def reset
  super() if respond_to?(:super)
  reset_the_internal_variables
  reset_the_base_module # This must come after reset_the_internal_variables().
  reset_the_shared_module
  infer_the_namespace
  reset_the_shared_variables
  Studium.set_runmode :gui # Make it known that we use the gui-runmode in this case.
  # ======================================================================= #
  # === @configuration
  # ======================================================================= #
  @configuration = [true, __dir__, namespace?]
  # ======================================================================= #
  # === Set the title; this must come after we delegate to the
  #     @configuration object
  # ======================================================================= #
  set_title(
    return_the_title_from_the_config_file(true, @configuration)
  )
  # ======================================================================= #
  # === Set the title, width, height and the font in use.
  # ======================================================================= #
  title_width_height_font(title?, WIDTH, HEIGHT, USE_THIS_FONT)
  handle_CSS if use_gtk3?
  enable_all_key_combinations # This should come after CSS was handled.
  infer_the_size_automatically
  # ======================================================================= #
  # === @delay_to_use
  # ======================================================================= #
  set_delay_to_use(DEFAULT_DELAY)
  # ======================================================================= #
  # === @internal_hash[:may_we_reveal_the_answer]
  # ======================================================================= #
  @internal_hash[:may_we_reveal_the_answer] = true
  # ======================================================================= #
  # === :prefer_emoji_or_images
  #
  # This variable can have two different states:
  #
  #   :emoji
  #   :images
  #
  # If :emoji is active then we will use emojis to enhance the
  # user interface. If :images is active then we will use different
  # images from the main icon theme in use instead.
  #
  # The reason why this was added in May 2021 was because the host
  # system may not support this or that emoji. If the emoji is
  # not supported then the user will see only garbage, which isn't
  # great. Thus, the default is now for :images since as of May
  # 2021, but with the intended goal to retain support for emojis
  # as well, should a user ever want to change this.
  # ======================================================================= #
  @internal_hash[:prefer_emoji_or_images] = :images
  # ======================================================================= #
  # === :use_this_editor
  #
  # The value of this variable may be :bluefish or :internal usually.
  # ======================================================================= #
  @internal_hash[:use_this_editor] = :bluefish # :internal
  # ======================================================================= #
  # === :show_ten_aliases
  #
  # This is only in use if the roebe-gem is available. Many users of this
  # class won't need it though.
  # ======================================================================= #
  @internal_hash[:show_ten_aliases] = nil
  # ======================================================================= #
  # === @internal_hash[:colour_to_use_for_the_notebook_labels]
  # ======================================================================= #
  @internal_hash[:colour_to_use_for_the_notebook_labels] = 'darkblue'
  # ======================================================================= #
  # === @internal_hash[:smaller_font]
  # ======================================================================= #
  @internal_hash[:smaller_font] = SMALLER_FONT
  consider_making_available_the_show_ten_aliases_widget
  upon_delete_event_quit_the_application
end

#reset_the_shared_module ⇒ Object

#

reset_the_shared_module

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 757

def reset_the_shared_module
  # ======================================================================= #
  # === :array_all_exam_questions
  # ======================================================================= #
  @internal_hash[:array_all_exam_questions] = []
end

#reset_the_shared_variables ⇒ Object

#

reset_the_shared_variables

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 284

def reset_the_shared_variables
  # ======================================================================= #
  # === :hash_dataset_of_all_lectures
  #
  # This is the Hash that looks like this:
  #
  #   :biopolymers => {:n_total_questions=>4,  :n_questions_answered=>0,  :percentage_of_questions_answered=>0.0},
  #   :biophysik   => {:n_total_questions=>28, :n_questions_answered=>0,  :percentage_of_questions_answered=>0.0},
  #
  # In other words: it will keep track of how many exam questions and
  # exam answers are in that Hash.
  # ======================================================================= #
  @internal_hash[:hash_dataset_of_all_lectures] =
    Studium::Statistics::ReportHowManyExamQuestionsWereAnswered.new { :be_quiet }.internal_dataset
end

#resize_the_notebook_tab_towards_the_primary_width_and_height ⇒ Object

#

resize_the_notebook_tab_towards_the_primary_width_and_height

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2630

def resize_the_notebook_tab_towards_the_primary_width_and_height
  _ = @notebook_tab
  _.set_size_request(width?, height?)
end

#return_button_ask_the_exam_question(use_emoji = false) ⇒ Object Also known as: return_button_ask_an_exam_question

#

return_button_ask_the_exam_question (ask tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 3128

def return_button_ask_the_exam_question(
    use_emoji = false
  )
  # ======================================================================= #
  # Add the ask-exam-question button next. Note that its click-event
  # is handled separately via a method call.
  #
  # The question mark emoji is Unicode Character "❓" (U+2753).
  # ======================================================================= #
  if use_emoji?
    _ = bold_button(mnemonic: 'Ask an exam _Question ❓')
  else
    _ = bold_button(mnemonic: 'Ask an exam _Question')
  end
  _.clear_background
  _.width_height(780, 38)
  _.pad2px
  _.hint =
    'Click on this button to ask an exam-question. '\
    '(Or, use alt+q as shortcut)'
  _.on_clicked {
    # ===================================================================== #
    # Determine what happens next when the ask-question button is clicked.
    # ===================================================================== #
    trigger_the_event_when_the_ask_exam_question_button_was_clicked
  }
  return _
end

#return_button_open_exam_topic_file ⇒ Object

#

return_button_open_exam_topic_file

This button should be next to the event box that will ask a random exam topic.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2337

def return_button_open_exam_topic_file
  # ======================================================================= #
  # This button will have the symbol for :open_file, an emoji - if
  # emojis are used. Otherwise an image will be used instead.
  # ======================================================================= #
  if use_emoji?
    _ = button(return_emoji(:open_box))
  else
    _ = button_with_this_image(image_open_file)
  end
  _.no_relief
  _.on_hover_lightblue
  _.hint = 'Click on this button to <b>open the current exam-topic file</b>.'
  _.on_clicked {
    do_open_the_current_exam_topic_file
  }
  return _
end

#return_button_solve_the_question ⇒ Object

#

return_button_solve_the_question

The old String was:

'_Solve the exam question'

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2643

def return_button_solve_the_question
  _ = bold_button('😁️ Mark the question as _solved ✓', self, :use_a_mnemonic) {
    :button_solve_the_exam_question_was_clicked
  }
  # ======================================================================= #
  # .set_size_request() is not necessary as we use a separate method
  # that controls the size of the widget at hand.
  # ======================================================================= #
  _.hint =
    'Use this button to <span weight="bold" foreground="lightgreen">mark '\
    'the question as solved</span> - that is, it is now '\
    '<b>correctly answered</b>).'
  # button_solve_the_question.set_size_request(78, 30)
  return _
end

#return_checkbox_shall_we_reveal_the_answer ⇒ Object Also known as: checkbox?, checkbox_shall_we_reveal_the_answer?

#

return_checkbox_shall_we_reveal_the_answer

This will only return the checkbox; creation must happen before this method is called.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2438

def return_checkbox_shall_we_reveal_the_answer
  @internal_hash[:checkbox_shall_we_reveal_the_answer]
end

#return_event_box_for_asking_a_random_exam_topic ⇒ Object

#

return_event_box_for_asking_a_random_exam_topic

This event-box can be used for asking a question from a random exam topic.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 985

def return_event_box_for_asking_a_random_exam_topic
  # ======================================================================= #
  # Next create the actual event box:
  # ======================================================================= #
  event_box_for_image_view_refresh_symbolic_symbolic = create_event_box(
    image_view_refresh_symbolic_symbolic
  )
  # ======================================================================= #
  # Provide useful hints how to use this event-box:
  # ======================================================================= #
  event_box_for_image_view_refresh_symbolic_symbolic.hint =
    'Click on this icon to <span weight="bold" foreground="lightgreen">set a random exam topic</span>, '\
    "and then ask an exam question from this topic.\n\n"\
    'Note that since as of <b>August 2022</b> this will ignore '\
    'exam topics that were already solved.'
  # ======================================================================= #
  # Let the event-box respond to an on-click event.
  # ======================================================================= #
  event_box_for_image_view_refresh_symbolic_symbolic.on_clicked {
    do_assign_a_new_exam_topic
  }
  return event_box_for_image_view_refresh_symbolic_symbolic
end

#return_event_box_with_face_glasses ⇒ Object

#

return_event_box_with_face_glasses

This one belongs close to the top of the widget.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 937

def return_event_box_with_face_glasses
  event_box = create_event_box
  image = create_icon('face-glasses')
  event_box.add(image)
  event_box.on_clicked {
    do_popup_the_array_of_all_exam_questions
  }
  return event_box
end

#return_eventbox_with_an_image_to_exit_the_application ⇒ Object

#

return_eventbox_with_an_image_to_exit_the_application

This method bundles together a quit-the-application functionality.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1979

def return_eventbox_with_an_image_to_exit_the_application
  application_exit_image = return_this_image_based_on_the_default_icon_theme(
    'system-log-out-symbolic.symbolic'
  ) # Or: :application_exit
  _ = create_eventbox(application_exit_image)
  _.hint = 'Click on this image to exit the program.'
  _.on_clicked {
    exit_application
  }
  return _
end

#return_frame_containing_the_label_exam_topic ⇒ Object

#

return_frame_containing_the_label_exam_topic

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1605

def return_frame_containing_the_label_exam_topic
  # ======================================================================= #
  # Create the exam-topic label next, showing a watermelon emoji on the
  # left-hand side. The watermelon emoji used to be 🍉️; but it was
  # replaced with the electric light bulb emoji in January 2021, which
  # is 💡️. Unfortunately this does not work on every system, so it
  # was decided to replace this with an image that is determined by
  # the icon theme at hand.
  # ======================================================================= #
  label_exam_topic = bold_text(' Exam topic ')
  label_emoji = right_arrow_emoji
  label_emoji.set_size_request(22, 22)
  label_emoji.align_right
  event_box_for_the_label_emoji = create_event_box(label_emoji)
  event_box_for_the_label_emoji.on_clicked {
    do_jump_into_the_entry_containing_the_current_exam_topic
  }
  tiny_hbox = create_hbox
  tiny_hbox.minimal(label_exam_topic)
  tiny_hbox.maximal(event_box_for_the_label_emoji)
  tiny_hbox.minimal(text(' ')) # Just a "spacer".
  frame_containing_the_label_exam_topic = create_frame(tiny_hbox)
  frame_containing_the_label_exam_topic.modify_background(:normal, :oldlace)
  frame_containing_the_label_exam_topic.bblack1
  # frame_containing_the_label_exam_topic.set_font(smaller_font?)
  label_exam_topic.hint = 'Denote <b>the current exam </b> topic '\
                          'to the <b>right</b> of this text.'
  return frame_containing_the_label_exam_topic
end

#return_hbox_containing_two_icons_and_instructions_what_to_do_with_the_free_form_textarea ⇒ Object

#

return_hbox_containing_two_icons_and_instructions_what_to_do_with_the_free_form_textarea

This widget returned by this method here, should come before the free-form widget is added.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1202

def return_hbox_containing_two_icons_and_instructions_what_to_do_with_the_free_form_textarea
  hbox_with_two_icons = create_hbox
  first_eventbox = create_event_box(image_accessories_text_editor)
  first_eventbox.on_clicked {
    do_clear_the_free_form_textarea
  }
  hbox_with_two_icons.minimal(first_eventbox, 2)
  text = text(
           'Below this text you can input your assumed '\
           'answer to the exam question at hand.'
         )
  text.left_align
  text.make_selectable
  text.set_font(:hack_18)
  hbox_with_two_icons.maximal(text, 4)
  event_box_for_image_accessories_text_editor = create_event_box(image_accessories_text_editor)
  event_box_for_image_accessories_text_editor.hint =
    'Click here to empty the free-form textarea below this icon.'
  event_box_for_image_accessories_text_editor.on_clicked {
    do_clear_the_free_form_textarea
  }
  hbox_with_two_icons.minimal(event_box_for_image_accessories_text_editor, 2)
  return hbox_with_two_icons
end

#return_n_answers_from_the_currently_selected_topic(i = current_exam_topic_as_a_string? ) ⇒ Object

#

return_n_answers_from_the_currently_selected_topic

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2359

def return_n_answers_from_the_currently_selected_topic(
    i = current_exam_topic_as_a_string?
  )
  ::Studium.n_answers_available_in_this_topic(i)
end

#return_n_questions_from_the_currently_selected_topic(i = current_exam_topic? ) ⇒ Object

#

return_n_questions_from_the_currently_selected_topic

This method will return how many exam questions exist in the selected exam topic.

This method is no longer that important as of December 2023.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1474

def return_n_questions_from_the_currently_selected_topic(
    i = current_exam_topic?
  )
  ::Studium.n_questions_available_in_this_topic(i)
end

#return_string_how_many_exam_questions_are_already_answered ⇒ Object

#

return_string_how_many_exam_questions_are_already_answered

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1924

def return_string_how_many_exam_questions_are_already_answered
  ::Studium.return_string_how_many_exam_questions_are_already_answered
end

#return_wikipedia_widget ⇒ Object

#

return_wikipedia_widget (wikipedia tag)

This method will return the widget that, upon user-mouse-button-click event, will open the corresponding wikipedia entry. This defaults to the german wikipedia entry right now; if others want to change the default then this could be changed easily.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 383

def return_wikipedia_widget
  begin
    require 'roebe/classes/wikipedia.rb'
  rescue LoadError; end

  hbox = create_hbox
  wikipedia_entry = entry
  wikipedia_entry.clear_background
  wikipedia_entry.bblack1
  wikipedia_entry.center
  wikipedia_entry.pad3px
  wikipedia_entry.lightgreen_background
  wikipedia_entry.width_height(650, 30)
  wikipedia_entry.hint =
    'Click the "<b>enter</b>" key to open the assorted keyword in the '\
    'german-wikipedia. Simply replace <b>de</b> with <b>en</b> in '\
    'the URL to have the english wikipedia.'
  wikipedia_entry.on_enter {
    if Object.const_defined?(:Roebe) and
      Roebe.const_defined?(:Wikipedia)
      Roebe::Wikipedia.new(wikipedia_entry.text?) # Instantiate a new wrapper.
    else
      e 'You need to install the '+steelblue('roebe')+
        ' gem for this functionality.'
    end
  }
  hbox.minimal(wikipedia_entry, 2)
  return hbox
end

#reveal_the_exam_answer(may_we_reveal_the_exam_answer = may_we_reveal_the_answer_after_a_delay? ) ⇒ Object

#

reveal_the_exam_answer

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 3085

def reveal_the_exam_answer(
    may_we_reveal_the_exam_answer = may_we_reveal_the_answer_after_a_delay?
  )
  case may_we_reveal_the_exam_answer
  # ========================================================================= #
  # === true
  # ========================================================================= #
  when true
    set_exam_answer
  # ========================================================================= #
  # === :but_only_if_we_may
  # ========================================================================= #
  when :but_only_if_we_may
    may_we_reveal_the_exam_answer = may_we_reveal_the_answer_after_a_delay?
    set_exam_answer if may_we_reveal_the_exam_answer
  end
end

#rinstall2 ⇒ Object Also known as: r2

#

rinstall2

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 438

def rinstall2
  Roebe.rinstall2(
    use_this_directory: Studium.ruby_src_dir_at_home?+
                        'studium/'
  )
end

#run ⇒ Object

#

run (run tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 3245

def run
  run_super
end

#sanitize_the_answer(i, apply_these_filters = []) ⇒ Object Also known as: sanitize_this_answer

#

sanitize_the_answer

This is called from within set_exam_answer().

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 562

def sanitize_the_answer(
    i,
    apply_these_filters = []
  )
  i = i.to_s
  if apply_these_filters.is_a? Symbol
    apply_these_filters = [apply_these_filters]
  end
  if apply_these_filters and !apply_these_filters.empty?
    apply_these_filters.each {|this_filter|
      case this_filter
      # =================================================================== #
      # === :remove_tags
      # =================================================================== #
      when :remove_tags,
           :filter_away_tags
        i = Studium.remove_tags_from_this_input(i)
      end
    }
  end
  if i.include? 'URL: '
    i.gsub!(/URL: /,"\nURL: ")
  end
  if i.include?('(2)')
    i.gsub!(/\(1\)/, "\n  (1)")
    i.gsub!(/\(2\)/, "\n  (2)")
    i.gsub!(/\(3\)/, "\n  (3)")
    i.gsub!(/\(4\)/, "\n  (4)")
    i.gsub!(/\(5\)/, "\n  (5)")
    i.gsub!(/\(6\)/, "\n  (6)")
    i.gsub!(/\(7\)/, "\n  (7)")
    i.gsub!(/\(8\)/, "\n  (8)")
  end
  i = Studium.remove_html(i)
  i = word_wrap(i, threshold: WORD_WRAP_AT_N_CHARACTERS)
  return i.rstrip
end

#save_the_buffer ⇒ Object

#

save_the_buffer

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 847

def save_the_buffer
  editor?.save_the_buffer
  # ======================================================================= #
  # Check whether we use the internal editor or not.
  # ======================================================================= #
  if use_the_internal_editor? and is_on_roebe?
    # ===================================================================== #
    # In this case jump to the first tab.
    # ===================================================================== #
    @notebook_tab.focus_on_this_tab(0)
    rinstall2
  end
end

#scrolled_window1? ⇒ Boolean

#

scrolled_window1?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1335

def scrolled_window1?
  @internal_hash[:scrolled_window_containing_the_textarea1]
end

#scrolled_window2? ⇒ Boolean Also known as: return_scrolled_window_containing_the_text_view_for_the_answer, scrolled_window_for_the_answer?, scrolled_window_containing_the_textarea2?

#

scrolled_window2?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 369

def scrolled_window2?
  @scrolled_window_containing_the_textarea2
end

#scrolled_window3? ⇒ Boolean Also known as: return_widget_for_the_freeform_textview, scrolled_window_containing_the_textarea3, return_scrolled_window3, return_scrolled_window_containing_the_textarea3

#

scrolled_window3?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1116

def scrolled_window3?
  @scrolled_window3
end

#select_not_yet_completed_exam_topics(i) ⇒ Object

#

select_not_yet_completed_exam_topics

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1914

def select_not_yet_completed_exam_topics(i)
  if i and i.is_a?(Array)
    return ::Studium.reject_already_completed_exam_topics(i, hash_dataset_of_all_lectures?)
  end
  return i # else return the original input unmodified.
end

#set_delay_to_use(i = DEFAULT_DELAY) ⇒ Object

#

set_delay_to_use

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 748

def set_delay_to_use(
    i = DEFAULT_DELAY
  )
  @internal_hash[:delay_to_use] = i.to_f
end

#set_editor_buffer(i) ⇒ Object

#

set_editor_buffer

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 501

def set_editor_buffer(i)
  editor?.set_buffer(i.to_s)
end

#set_exam_answer(i = answer_is?, , apply_these_filters = [:filter_away_tags]) ⇒ Object Also known as: set_answer, reveal_the_answer_to_the_exam_question

#

set_exam_answer (answer tag)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2914

def set_exam_answer(
    i                   = answer_is?,
    apply_these_filters = [:filter_away_tags]
  )
  i = sanitize_the_answer(i.to_s, apply_these_filters)
  i = ::Gtk.replace_all_URL_entries_in_this_string(i)
  i.lstrip!
  i.sub!(/A: /,'') if i.start_with? 'A: '
  # ================================================================= #
  # Replace all "(2) foo" entries with "(2) foo\n" entries.
  # ================================================================= #
  i = ::Studium.add_newlines_to_numbered_exam_question(i)
  @internal_hash[:exam_answer] = i
  textview2?.set_text(i)
end

#set_exam_question(i = exam_question_object?.question?, apply_these_filters = [:remove_tags]) ⇒ Object Also known as: set_question

#

set_exam_question

The second argument can be a filter. For instance, if the Symbol :remove_tags is passed, then all HTML tags will be removed from the given input at hand. This is actually the default behaviour.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1412

def set_exam_question(
    i                   = exam_question_object?.question?,
    apply_these_filters = [:remove_tags]
  )
  i = i.to_s.dup
  i[0,2] = '' if i.start_with?('- ') # We don't ever want leading '-' here.
  if apply_these_filters.is_a? Symbol
    apply_these_filters = [apply_these_filters]
  end
  # ======================================================================= #
  # Replace all URL entries with <a href> entries next:
  # ======================================================================= #
  if i
    i = ::Gtk.replace_all_URL_entries_in_this_string(i)
  end
  # ======================================================================= #
  # The following line may have to be re-evaluated again in the future -
  # in the past, in 2021, this had a bug and things crashed, but this
  # may no longer be the case - let's see, eventually.
  #
  #   editor?.update_the_main_buffer(dataset)
  #
  # ======================================================================= #
  if apply_these_filters and !apply_these_filters.empty?
    apply_these_filters.each {|this_filter|
      case this_filter
      # =================================================================== #
      # === :remove_tags
      # =================================================================== #
      when :remove_tags,
           :no_tags,
           :default
        i = Studium.remove_tags_from_this_input(i)
      end
    }
  end
  @internal_hash[:exam_question] = i
  textview1?.set_text(i) # This is the widget for the exam-questions.
end

#set_exam_topic(i = :default) ⇒ Object Also known as: set_current_exam_topic

#

set_exam_topic

This will set towards the entry that holds the current exam topic.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1800

def set_exam_topic(
    i = :default
  )
  case i
  # ===================================================================== #
  # === :default
  # ===================================================================== #
  when :default
    i = default_exam_topic?.to_s
  end
  i = i.to_s # .downcase # Studium.expand_exam_topic(use_this_topic.to_s)
  if i and !i.empty?
    entry_for_the_current_exam_topic?.set_text(i)
  end
end

#set_n_exam_questions_are_unanswered(i) ⇒ Object Also known as: set_n_unanswered_questions

#

set_n_exam_questions_are_unanswered

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1907

def set_n_exam_questions_are_unanswered(i)
  entry_containing_n_unanswered_questions?.set_text(i.to_s)
end

#set_n_exam_questions_exist_in_total(i) ⇒ Object

#

set_n_exam_questions_exist_in_total

This method exists to set the value of the proper entry, containing how many exam-questions are still unanswered.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2396

def set_n_exam_questions_exist_in_total(i)
  entry_n_total_exam_questions?.set_text(i.to_s)
end

#set_n_exam_questions_were_already_answered(i) ⇒ Object

#

set_n_exam_questions_were_already_answered

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2269

def set_n_exam_questions_were_already_answered(i)
  entry_n_answered_exam_questions?.set_text(i.to_s)
end

#set_n_percentage_of_questions_answered(i) ⇒ Object Also known as: set_n_percentage, update_the_percentage_entry, do_update_this_entry_with_that_exam_topic_for_its_percentage_value

#

set_n_percentage_of_questions_answered

An alternative would be:

percentage_value = Studium.n_percent_questions_answered_of_this_topic?(
  use_this_exam_topic.downcase
)

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2776

def set_n_percentage_of_questions_answered(i)
  percentage_value = -1 if percentage_value == false # Weak "safeguard".
  i = i.to_f.round(1)
  entry_percentage?.set_text("#{i}%") # Sync it onto the proper entry.
end

#set_save_into_this_local_file(i) ⇒ Object

#

set_save_into_this_local_file

This method will only be in use if the internal editor is used.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 682

def set_save_into_this_local_file(i)
  editor?.set_save_into_this_local_file(i.to_s)
end

#shall_we_create_the_gtk_editor? ⇒ Boolean

#

shall_we_create_the_gtk_editor?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2368

def shall_we_create_the_gtk_editor?
  @internal_hash[:use_this_editor] == :internal
end

#show_ten_aliases? ⇒ Boolean

#

show_ten_aliases?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 3200

def show_ten_aliases?
  @internal_hash[:show_ten_aliases]
end

#simply_assign_this_as_the_new_exam_topic_onto_the_primary_combobox(i) ⇒ Object

#

simply_assign_this_as_the_new_exam_topic_onto_the_primary_combobox

This method does not work currently.

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2448

def simply_assign_this_as_the_new_exam_topic_onto_the_primary_combobox(
    i
  )
  combobox_available_exam_topics?.append_text(i.to_s)
end

#smallest_font? ⇒ Boolean

#

smallest_font?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 619

def smallest_font?
  SMALLEST_FONT
end

#sync_combo_box_entry_onto_the_current_exam_entry(i = combo_box?.entry?) ⇒ Object

#

sync_combo_box_entry_onto_the_current_exam_entry

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2747

def sync_combo_box_entry_onto_the_current_exam_entry(
    i = combo_box?.entry?
  )
  _ = ::Studium.find_corresponding_exam_title(i)
  set_current_exam_topic(_)
end

#sync_entry_holding_all_exam_topics_onto_the_combo_box(value = Studium.find_corresponding_exam_topic( entry_for_the_current_exam_topic?.text? )) ⇒ Object Also known as: sync_entry_holding_all_exam_topics_onto_the_main_combo_box

#

sync_entry_holding_all_exam_topics_onto_the_combo_box

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 963

def sync_entry_holding_all_exam_topics_onto_the_combo_box(
    value = Studium.find_corresponding_exam_topic(
              entry_for_the_current_exam_topic?.text?
            )
  )
  # ======================================================================= #
  # Next find the correct index:
  # ======================================================================= #
  # index = array.find_index {|entry| entry.delete('_').include?(value) }
  # if index
  #   combo_box_available_exam_topics?.set_active(index)
  # else
  #   e 'The index was not found. Input was '+steelblue(value)+'.'
  # end
end

#textview1? ⇒ Boolean Also known as: widget_for_the_questions?, text_view_for_the_question?, return_widget_for_the_questions, return_text_view_for_the_question, return_scrolled_window_for_the_text_view_for_the_question, text_view_containing_the_current_question?, text_buffer_for_the_question?, textarea1?, question_buffer, question_buffer?

#

textview1?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 1274

def textview1?
  @internal_hash[:textview1]
end

#textview2? ⇒ Boolean Also known as: return_widget_for_the_answers, text_view_for_the_answer, text_view_for_the_answer?, textarea2?, answer_buffer?, answer_buffer

#

textview2?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 894

def textview2?
  @internal_hash[:textview2]
end

#textview3? ⇒ Boolean Also known as: text_view_for_the_freeform_input?, text_view_for_the_freeform_input, free_form_textarea?, return_textarea_number_three

#

textview3?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 821

def textview3?
  @internal_hash[:textview3]
end

#the_first_notebook_tab_is_active ⇒ Object

#

the_first_notebook_tab_is_active

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2539

def the_first_notebook_tab_is_active
  @notebook_tab.the_first_notebook_tab_is_active
end

#top_textbuffer? ⇒ Boolean

#

top_textbuffer?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 612

def top_textbuffer?
  text_view_for_the_question?.buffer
end

#update_array_all_exam_questions ⇒ Object

#

update_array_all_exam_questions

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2672

def update_array_all_exam_questions
  @internal_hash[:array_all_exam_questions] = []
end

#update_hash_dataset_of_all_lectures ⇒ Object

#

update_hash_dataset_of_all_lectures

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 317

def update_hash_dataset_of_all_lectures
  @internal_hash[:hash_dataset_of_all_lectures] =
    Studium::Statistics::ReportHowManyExamQuestionsWereAnswered.new { :be_quiet }.internal_dataset
end

#update_n_answered(i = :infer) ⇒ Object Also known as: do_update_the_entry_n_answered

#

update_n_answered

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 916

def update_n_answered(
    i = :infer
  )
  case i
  # ======================================================================= #
  # === :infer
  # ======================================================================= #
  when :infer
    current_exam_topic = current_exam_topic_from_the_entry?
    hash = hash_dataset_of_all_lectures? # Always update it here in this case.
    _ = hash[current_exam_topic.tr(' ','_').to_sym]
    i = _[:n_questions_answered]
  end
  set_n_exam_questions_were_already_answered(i)
end

#update_the_label_n_questions_were_answered(i = @label_n_questions_were_answered) ⇒ Object Also known as: update_the_label_containing_the_last_exam_question

#

update_the_label_n_questions_were_answered

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 2424

def update_the_label_n_questions_were_answered(
    i = @label_n_questions_were_answered
  )
  i.set_text(
    return_string_how_many_exam_questions_are_already_answered
  )
end

#use_emoji? ⇒ Boolean

#

use_emoji?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 673

def use_emoji?
  @internal_hash[:prefer_emoji_or_images] == :emoji
end

#use_the_internal_editor? ⇒ Boolean

#

use_the_internal_editor?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 476

def use_the_internal_editor?
  @internal_hash[:use_this_editor] == :internal
end

#use_this_editor? ⇒ Boolean

#

use_this_editor?

#

Returns:

• (Boolean)

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 483

def use_this_editor?
  @internal_hash[:use_this_editor]
end

#we_may_not_reveal_the_exam_answer_anymore ⇒ Object

#

we_may_not_reveal_the_exam_answer_anymore

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 3174

def we_may_not_reveal_the_exam_answer_anymore
  # ======================================================================= #
  # === @internal_hash[:may_we_reveal_the_answer_after_a_delay]
  # ======================================================================= #
  @internal_hash[:may_we_reveal_the_answer_after_a_delay] = false
end

#we_may_reveal_the_exam_answer ⇒ Object

#

we_may_reveal_the_exam_answer

#

# File 'lib/studium/gui/universal_widgets/exam_trainer/exam_trainer.rb', line 3160

def we_may_reveal_the_exam_answer
  @internal_hash[:may_we_reveal_the_answer_after_a_delay] = true
end