iscatel_student_list 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,595 @@
1
+ require 'fox16'
2
+ include Fox
3
+
4
+ require_relative '../controller/student_list_controller.rb'
5
+ require_relative '../domain/student.rb'
6
+
7
+ # Главное окно графического интерфейса приложения StudentList (библиотека FXRuby).
8
+ # Отображает таблицу студентов, панель управления CRUD-операциями и элементы пагинации.
9
+ class StudentListView < FXMainWindow
10
+ # Индексы столбцов таблицы (1 — Контакты, 2 — Гит), пустые ячейки которых подсвечиваются
11
+ HIGHLIGHT_EMPTY_COLUMNS = [1, 2].freeze
12
+
13
+ # Цвет заливки пустых ячеек в подсвечиваемых столбцах
14
+ EMPTY_CELL_COLOR = FXRGB(212, 208, 200)
15
+
16
+ # Инициализирует главное окно приложения, виджеты интерфейса и контроллер.
17
+ #
18
+ # @param app [FXApp] экземпляр приложения FOX Toolkit
19
+ def initialize(app)
20
+ super(app, 'StudentList', width: 1280, height: 720)
21
+ @app = app
22
+
23
+ initialize_fonts(app)
24
+ initialize_window
25
+ initialize_table
26
+ initialize_buttons
27
+ end
28
+
29
+ private
30
+
31
+ # Создаёт ресурсы окна на стороне оконной системы, загружает начальные данные и отображает окно.
32
+ #
33
+ # @return [void]
34
+ def create
35
+ super
36
+
37
+ begin
38
+ @controller = StudentListInitialController.new(self)
39
+ @controller.refresh_data
40
+ rescue StandardError => e
41
+ FXMessageBox.error(self, MBOX_OK, 'Ошибка запуска', e.message)
42
+ exit(1)
43
+ end
44
+
45
+ show(PLACEMENT_SCREEN)
46
+ end
47
+
48
+ # Инициализирует шрифты для таблицы и кнопок управления.
49
+ #
50
+ # @param app [FXApp] экземпляр приложения
51
+ # @return [void]
52
+ def initialize_fonts(app)
53
+ @table_font = FXFont.new(app, 'Courier New', 11, FONTWEIGHT_NORMAL)
54
+ @table_font.create
55
+ @button_font = FXFont.new(app, 'Courier New', 12, FONTWEIGHT_NORMAL)
56
+ @button_font.create
57
+ end
58
+
59
+ # Создаёт контейнеры компоновки, таблицу, кнопки CRUD и элементы пагинатора.
60
+ #
61
+ # @return [FXLabel] метка отображения текущей страницы
62
+ def initialize_window
63
+ window_container = FXHorizontalFrame.new(self, opts: LAYOUT_FILL_X | LAYOUT_FILL_Y)
64
+
65
+ table_container = FXVerticalFrame.new(window_container, opts: LAYOUT_FILL_X | LAYOUT_FILL_Y | FRAME_SUNKEN)
66
+ @table = FXTable.new(table_container, opts: LAYOUT_FILL_X | LAYOUT_FILL_Y | TABLE_NO_COLSELECT)
67
+ @anchor_row = nil
68
+ @selected_rows = []
69
+ @cell_icons = {}
70
+
71
+ buttons_container = FXVerticalFrame.new(window_container, opts: LAYOUT_FIX_WIDTH | LAYOUT_FILL_Y | FRAME_SUNKEN, width: 200)
72
+ @button_read = FXButton.new(buttons_container, 'Прочитать', opts: BUTTON_NORMAL | LAYOUT_CENTER_X | LAYOUT_FIX_WIDTH | LAYOUT_FIX_HEIGHT, width: 180, height: 30)
73
+ @button_create = FXButton.new(buttons_container, 'Добавить', opts: BUTTON_NORMAL | LAYOUT_CENTER_X | LAYOUT_FIX_WIDTH | LAYOUT_FIX_HEIGHT, width: 180, height: 30)
74
+ @button_update = FXButton.new(buttons_container, 'Изменить', opts: BUTTON_NORMAL | LAYOUT_CENTER_X | LAYOUT_FIX_WIDTH | LAYOUT_FIX_HEIGHT, width: 180, height: 30)
75
+ @button_delete = FXButton.new(buttons_container, 'Удалить', opts: BUTTON_NORMAL | LAYOUT_CENTER_X | LAYOUT_FIX_WIDTH | LAYOUT_FIX_HEIGHT, width: 180, height: 30)
76
+
77
+ paginator_container = FXHorizontalFrame.new(buttons_container, opts: LAYOUT_FILL_X | LAYOUT_LEFT | LAYOUT_BOTTOM)
78
+ @button_previous_page = FXButton.new(paginator_container, '<', opts: BUTTON_NORMAL | LAYOUT_LEFT | LAYOUT_BOTTOM)
79
+ @button_next_page = FXButton.new(paginator_container, '>', opts: BUTTON_NORMAL | LAYOUT_LEFT | LAYOUT_BOTTOM)
80
+ @pages_label = FXLabel.new(paginator_container, '0/0', opts: LAYOUT_RIGHT | LAYOUT_BOTTOM)
81
+ end
82
+
83
+ # Настраивает обработчики событий мыши и клавиатуры для выделения строк таблицы.
84
+ #
85
+ # @return [FXFont] установленный шрифт таблицы
86
+ def initialize_table
87
+ @table.connect(SEL_LEFTBUTTONPRESS) do |_sender, _sel, event|
88
+ current_row = @table.rowAtY(event.win_y)
89
+ current_column = @table.colAtX(event.win_x)
90
+ if current_row >= 0 && current_row < @table.numRows && current_column >= 0 && current_column < @table.numColumns
91
+ @table.setCurrentItem(current_row, current_column, false)
92
+ select_rows(current_row)
93
+ update_buttons
94
+ end
95
+ true
96
+ end
97
+
98
+ @table.connect(SEL_KEYPRESS) do |_sender, _sel, event|
99
+ if [Fox::KEY_Up, Fox::KEY_Down, Fox::KEY_Left, Fox::KEY_Right].include?(event.code)
100
+ return true if @table.numRows.zero?
101
+
102
+ current_row = [@table.currentRow, 0].max
103
+ target_row = case event.code
104
+ when Fox::KEY_Up then [current_row - 1, 0].max
105
+ when Fox::KEY_Down then [current_row + 1, @table.numRows - 1].min
106
+ else current_row
107
+ end
108
+
109
+ @table.setCurrentItem(target_row, [@table.currentColumn, 0].max)
110
+ select_rows(target_row)
111
+ update_buttons
112
+
113
+ true
114
+ else
115
+ false
116
+ end
117
+ end
118
+
119
+ @table.cornerButton.connect(SEL_COMMAND) do
120
+ next if @table.numRows.zero?
121
+
122
+ start_row = 0
123
+ end_row = @table.numRows - 1
124
+ @table.selectRange(start_row, end_row, 0, @table.numColumns - 1)
125
+ self.selected_rows = (start_row..end_row).to_a
126
+ update_buttons
127
+ end
128
+
129
+ @table.rowHeaderMode = LAYOUT_FIX_WIDTH
130
+
131
+ @table.rowHeader.connect(SEL_COMMAND) do |_sender, _sel, row_index|
132
+ select_single_row(row_index)
133
+ update_buttons
134
+ true
135
+ end
136
+
137
+ @table.connect(SEL_DOUBLECLICKED) do
138
+ true
139
+ end
140
+
141
+ @table.font = @table_font
142
+ end
143
+
144
+ # Привязывает обработчики нажатий ко всем кнопкам управления и пагинации.
145
+ #
146
+ # @return [Array<FXButton>] список кнопок интерфейса
147
+ def initialize_buttons
148
+ @button_update.disable
149
+ @button_delete.disable
150
+
151
+ @button_read.connect(SEL_COMMAND) do
152
+ ReadWindow.new(@app, self, 'Подтверждение чтения', 360, 120, @controller)
153
+ rescue StandardError => e
154
+ FXMessageBox.error(self, MBOX_OK, 'Ошибка', e.message)
155
+ end
156
+
157
+ @button_delete.connect(SEL_COMMAND) do
158
+ DeleteWindow.new(@app, self, 'Подтверждение удаления', 360, 120, @controller)
159
+ rescue StandardError => e
160
+ FXMessageBox.error(self, MBOX_OK, 'Ошибка', e.message)
161
+ end
162
+
163
+ @button_create.connect(SEL_COMMAND) do
164
+ InsertUpdateWindow.new(@app, self, 'Подтверждение добавления', 420, 380, @controller.initialize_insert_controller)
165
+ @controller.refresh_data
166
+ rescue StandardError => e
167
+ FXMessageBox.error(self, MBOX_OK, 'Ошибка', e.message)
168
+ end
169
+
170
+ @button_update.connect(SEL_COMMAND) do
171
+ InsertUpdateWindow.new(@app, self, 'Подтверждение изменения', 420, 380, @controller.initialize_update_controller)
172
+ @controller.refresh_data
173
+ rescue StandardError => e
174
+ FXMessageBox.error(self, MBOX_OK, 'Ошибка', e.message)
175
+ end
176
+
177
+ @button_previous_page.connect(SEL_COMMAND) do
178
+ @controller.previous_page
179
+ @controller.refresh_data
180
+ rescue StandardError => e
181
+ FXMessageBox.error(self, MBOX_OK, 'Ошибка', e.message)
182
+ end
183
+
184
+ @button_next_page.connect(SEL_COMMAND) do
185
+ @controller.next_page
186
+ @controller.refresh_data
187
+ rescue StandardError => e
188
+ FXMessageBox.error(self, MBOX_OK, 'Ошибка', e.message)
189
+ end
190
+
191
+ [@button_read, @button_create, @button_update, @button_delete, @button_previous_page, @button_next_page].each do |button|
192
+ button.font = @button_font
193
+ end
194
+ end
195
+
196
+ # Абстрактный базовый класс для модальных диалоговых окон приложения.
197
+ #
198
+ # @abstract Наследники должны реализовать метод {#initialize_window}.
199
+ class ModalWindow
200
+ # Инициализирует шрифты и запускает построение модального диалога.
201
+ #
202
+ # @param app [FXApp] экземпляр приложения
203
+ # @param parent [FXWindow] родительское окно
204
+ # @param title_text [String] заголовок диалогового окна
205
+ # @param width [Integer] ширина окна в пикселях
206
+ # @param height [Integer] высота окна в пикселях
207
+ # @param controller [Object] контроллер, обслуживающий данное модальное окно
208
+ # @raise [NotImplementedError] при попытке создать экземпляр {ModalWindow} напрямую
209
+ def initialize(app, parent, title_text, width, height, controller)
210
+ raise(NotImplementedError, "#{self.class} не может иметь экземпляров") if self.class == ModalWindow
211
+ @controller = controller
212
+ initialize_fonts(app)
213
+ initialize_window(parent, title_text, width, height)
214
+ end
215
+
216
+ private
217
+
218
+ # Создаёт шрифты для элементов управления модального окна.
219
+ #
220
+ # @param app [FXApp] экземпляр приложения
221
+ # @return [void]
222
+ def initialize_fonts(app)
223
+ @buttons_font = FXFont.new(app, 'Courier New', 12, FONTWEIGHT_NORMAL)
224
+ @buttons_font.create
225
+ @label_font = FXFont.new(app, 'Courier New', 14, FONTWEIGHT_NORMAL)
226
+ @label_font.create
227
+ end
228
+
229
+ # Формирует виджеты и логику модального диалога.
230
+ #
231
+ # @abstract
232
+ # @param _parent [FXWindow] родительское окно
233
+ # @param _title_text [String] заголовок окна
234
+ # @param _width [Integer] ширина окна
235
+ # @param _height [Integer] высота окна
236
+ # @return [void]
237
+ # @raise [NotImplementedError] если метод не переопределён в наследнике
238
+ def initialize_window(_parent, _title_text, _width, _height)
239
+ raise(NotImplementedError, "#{self.class}#initialize_window не реализован")
240
+ end
241
+ end
242
+
243
+ # Модальное окно настройки количества отображаемых записей на одной странице.
244
+ class ReadWindow < ModalWindow
245
+ private
246
+
247
+ # Строит диалоговое окно со счётчиком строк и обрабатывает подтверждение выбора.
248
+ #
249
+ # @param parent [StudentListView] главное окно
250
+ # @param title_text [String] заголовок окна
251
+ # @param width [Integer] ширина окна
252
+ # @param height [Integer] высота окна
253
+ # @return [Integer] код завершения модального диалога
254
+ def initialize_window(parent, title_text, width, height)
255
+ dialogue = FXDialogBox.new(parent, title_text, DECOR_TITLE | DECOR_BORDER, width: width, height: height)
256
+ @selected_number = @controller.get_rows_on_page_count
257
+
258
+ window_container = FXVerticalFrame.new(dialogue, opts: LAYOUT_FILL_X | LAYOUT_FILL_Y, padding: 15)
259
+
260
+ spinner_container = FXHorizontalFrame.new(window_container, opts: LAYOUT_FILL_X)
261
+ label = FXLabel.new(spinner_container, 'Укажите количество:')
262
+ label.font = @label_font
263
+
264
+ spinner = FXSpinner.new(spinner_container, 4, opts: SPIN_NORMAL | FRAME_SUNKEN | FRAME_THICK)
265
+ spinner.range = 1..30
266
+ spinner.value = @selected_number
267
+ spinner.font = @label_font
268
+
269
+ button_container = FXHorizontalFrame.new(window_container, opts: LAYOUT_FILL_X | PACK_UNIFORM_WIDTH)
270
+
271
+ button_ok = FXButton.new(button_container, 'ОК', opts: BUTTON_NORMAL | LAYOUT_FIX_WIDTH, width: 90, height: 32)
272
+ button_ok.font = @buttons_font
273
+ button_ok.connect(SEL_COMMAND) do
274
+ @controller.set_rows_on_page_count(spinner.value)
275
+ @controller.refresh_data
276
+ dialogue.handle(button_ok, FXSEL(SEL_COMMAND, FXDialogBox::ID_ACCEPT), nil)
277
+ rescue StandardError => e
278
+ FXMessageBox.error(dialogue, MBOX_OK, 'Ошибка', e.message)
279
+ end
280
+
281
+ button_cancel = FXButton.new(button_container, 'Отмена', target: dialogue, selector: FXDialogBox::ID_CANCEL, opts: BUTTON_NORMAL | LAYOUT_FIX_WIDTH, width: 90, height: 32)
282
+ button_cancel.font = @buttons_font
283
+
284
+ dialogue.execute(PLACEMENT_OWNER)
285
+ end
286
+ end
287
+
288
+ # Модальное окно подтверждения удаления выбранных записей студентов.
289
+ class DeleteWindow < ModalWindow
290
+ private
291
+
292
+ # Строит окно подтверждения удаления и запускает удаление при нажатии «ОК».
293
+ #
294
+ # @param parent [StudentListView] главное окно
295
+ # @param title_text [String] заголовок окна
296
+ # @param width [Integer] ширина окна
297
+ # @param height [Integer] высота окна
298
+ # @return [Integer] код завершения модального диалога
299
+ def initialize_window(parent, title_text, width, height)
300
+ dialogue = FXDialogBox.new(parent, title_text, DECOR_TITLE | DECOR_BORDER, width: width, height: height)
301
+
302
+ window_container = FXVerticalFrame.new(dialogue, opts: LAYOUT_FILL_X | LAYOUT_FILL_Y, padding: 15)
303
+
304
+ label = FXLabel.new(window_container, 'Удалить студентов?', opts: LAYOUT_CENTER_X | LAYOUT_FILL_Y)
305
+ label.font = @label_font
306
+
307
+ button_container = FXHorizontalFrame.new(window_container, LAYOUT_CENTER_X | PACK_UNIFORM_WIDTH, padTop: 10)
308
+
309
+ button_ok = FXButton.new(button_container, 'ОК', opts: BUTTON_NORMAL | LAYOUT_FIX_WIDTH, width: 90, height: 32)
310
+ button_ok.font = @buttons_font
311
+ button_ok.connect(SEL_COMMAND) do
312
+ @controller.delete_students
313
+ @controller.refresh_data
314
+ dialogue.handle(button_ok, FXSEL(SEL_COMMAND, FXDialogBox::ID_ACCEPT), nil)
315
+ rescue StandardError => e
316
+ FXMessageBox.error(dialogue, MBOX_OK, 'Ошибка', e.message)
317
+ end
318
+
319
+ button_cancel = FXButton.new(button_container, 'Отмена', target: dialogue, selector: FXDialogBox::ID_CANCEL, opts: BUTTON_NORMAL | LAYOUT_FIX_WIDTH, width: 90, height: 32)
320
+ button_cancel.font = @buttons_font
321
+
322
+ dialogue.execute(PLACEMENT_OWNER)
323
+ end
324
+ end
325
+
326
+ # Модальное окно создания и редактирования данных студента с интерактивной валидацией полей.
327
+ class InsertUpdateWindow < ModalWindow
328
+ private
329
+
330
+ # Строит форму ввода полей студента, настраивает живую валидацию и сохранение данных.
331
+ #
332
+ # @param parent [StudentListView] главное окно
333
+ # @param title_text [String] заголовок окна
334
+ # @param width [Integer] ширина окна
335
+ # @param height [Integer] высота окна
336
+ # @return [Integer] код завершения модального диалога
337
+ def initialize_window(parent, title_text, width, height)
338
+ dialogue = FXDialogBox.new(parent, title_text, DECOR_TITLE | DECOR_BORDER, width: width, height: height)
339
+
340
+ window_container = FXVerticalFrame.new(dialogue, opts: LAYOUT_FILL_X | LAYOUT_FILL_Y, padding: 15)
341
+
342
+ form_matrix = FXMatrix.new(window_container, 2, opts: MATRIX_BY_COLUMNS | LAYOUT_FILL_X | LAYOUT_FILL_Y, hSpacing: 10, vSpacing: 8)
343
+
344
+ field_names = {
345
+ last_name: 'Фамилия:',
346
+ first_name: 'Имя:',
347
+ patronymic: 'Отчество:',
348
+ telegram: 'Телеграм:',
349
+ email: 'Почта:',
350
+ phone: 'Телефон:',
351
+ git: 'Git:'
352
+ }
353
+
354
+ @inputs = field_names.to_h do |field_name, field_label|
355
+ label = FXLabel.new(form_matrix, field_label, opts: LAYOUT_LEFT | LAYOUT_CENTER_Y)
356
+ label.font = @label_font
357
+
358
+ text_field = FXTextField.new(form_matrix, 25, opts: TEXTFIELD_NORMAL | LAYOUT_FILL_X | LAYOUT_FILL_COLUMN)
359
+ text_field.font = @label_font
360
+ [field_name, text_field]
361
+ end
362
+
363
+ @field_validation = @inputs.transform_values { false }
364
+
365
+ button_container = FXHorizontalFrame.new(window_container, opts: LAYOUT_CENTER_X | PACK_UNIFORM_WIDTH, padTop: 15)
366
+
367
+ @button_ok = FXButton.new(button_container, 'ОК', opts: BUTTON_NORMAL | LAYOUT_FIX_WIDTH, width: 100, height: 32)
368
+ @button_ok.font = @buttons_font
369
+ @button_ok.disable
370
+ @button_ok.connect(SEL_COMMAND) do
371
+ student_data = @inputs.transform_values { |text_field| text_field.text.empty? ? nil : text_field.text }
372
+ @controller.refresh_data(student_data)
373
+ dialogue.handle(@button_ok, FXSEL(SEL_COMMAND, FXDialogBox::ID_ACCEPT), nil)
374
+ rescue StandardError => e
375
+ FXMessageBox.error(dialogue, MBOX_OK, 'Ошибка', e.message)
376
+ end
377
+
378
+ @button_cancel = FXButton.new(button_container, 'Отмена', target: dialogue, selector: FXDialogBox::ID_CANCEL, opts: BUTTON_NORMAL | LAYOUT_FIX_WIDTH, width: 100, height: 32)
379
+ @button_cancel.font = @buttons_font
380
+
381
+ fill_text_fields(@controller.get_window_data)
382
+
383
+ @inputs.each do |field_name, text_field|
384
+ validate_text_field(field_name, text_field)
385
+ text_field.connect(SEL_CHANGED) do
386
+ validate_text_field(field_name, text_field)
387
+ update_buttons
388
+ end
389
+ end
390
+
391
+ update_buttons
392
+
393
+ dialogue.execute(PLACEMENT_OWNER)
394
+ end
395
+
396
+ # Проверяет корректность значения в текстовом поле и сохраняет результат в +@field_validation+.
397
+ #
398
+ # @param field_name [Symbol] ключ проверяемого поля
399
+ # @param text_field [FXTextField] виджет текстового поля
400
+ # @return [Boolean] результат валидации
401
+ def validate_text_field(field_name, text_field)
402
+ field_data = text_field.text.empty? ? nil : text_field.text
403
+ @field_validation[field_name] = @controller.validate_data(field_name, field_data)
404
+ end
405
+
406
+ # Заполняет текстовые поля формы значениями из переданного хэша.
407
+ #
408
+ # @param student [Hash{Symbol => String, nil}] словарь значений полей студента
409
+ # @return [Hash] обработанный словарь полей
410
+ def fill_text_fields(student)
411
+ @inputs.each do |field_name, text_field|
412
+ text_field.text = student[field_name].to_s
413
+ end
414
+ end
415
+
416
+ # Активирует или блокирует кнопку «ОК» в зависимости от валидности всех полей формы.
417
+ #
418
+ # @return [void]
419
+ def update_buttons
420
+ if @field_validation.values.all?
421
+ @button_ok.enable
422
+ else
423
+ @button_ok.disable
424
+ end
425
+ end
426
+ end
427
+
428
+ # Создаёт или возвращает из кэша прямоугольную иконку заливки заданного размера.
429
+ #
430
+ # @param width [Integer] ширина иконки в пикселях
431
+ # @param height [Integer] высота иконки в пикселях
432
+ # @return [FXIcon] готовая иконка для вставки в ячейку таблицы
433
+ def create_cell_icon(width, height)
434
+ @cell_icons[[width, height]] ||=
435
+ begin
436
+ icon = FXIcon.new(@app, nil, 0, IMAGE_OPAQUE, width, height)
437
+ icon.create
438
+ FXDCWindow.new(icon) do |dc|
439
+ dc.foreground = EMPTY_CELL_COLOR
440
+ dc.fillRectangle(0, 0, width, height)
441
+ end
442
+ icon
443
+ end
444
+ end
445
+
446
+ # Подсвечивает пустые ячейки в указанных столбцах с помощью прямоугольных серых иконок.
447
+ #
448
+ # @param columns [Array<Integer>] индексы проверяемых столбцов таблицы
449
+ # @return [Range<Integer>] диапазон обработанных строк
450
+ def highlight_empty_cells(columns = HIGHLIGHT_EMPTY_COLUMNS)
451
+ (0...@table.numRows).each do |row|
452
+ columns.each do |col|
453
+ next if col >= @table.numColumns
454
+
455
+ if @table.getItemText(row, col).to_s.strip.empty?
456
+ w = [@table.getColumnWidth(col) - 4, 1].max
457
+ h = [@table.getRowHeight(row) - 4, 1].max
458
+ @table.setItemIcon(row, col, create_cell_icon(w, h))
459
+ @table.setItemJustify(row, col, FXTableItem::CENTER_X | FXTableItem::CENTER_Y)
460
+ else
461
+ @table.setItemIcon(row, col, nil)
462
+ end
463
+ end
464
+ end
465
+ end
466
+
467
+ # Обновляет список выделенных строк и передаёт его в контроллер.
468
+ #
469
+ # @param rows [Array<Integer>] массив индексов выделенных строк
470
+ # @return [Array<Integer>] переданный массив индексов
471
+ def selected_rows=(rows)
472
+ @selected_rows = rows
473
+ @controller.refresh_selected_rows(rows)
474
+ end
475
+
476
+ # Автоматически подбирает ширину столбцов и заголовков строк по содержимому ячеек.
477
+ #
478
+ # @param padding [Integer] дополнительный отступ в пикселях
479
+ # @return [Integer] установленная ширина заголовка строк
480
+ def fit_columns(padding = 20)
481
+ @table.numColumns.times do |column|
482
+ min_width = @table.getMinColumnWidth(column)
483
+ @table.setColumnWidth(column, [min_width + padding, 100].max)
484
+ end
485
+ corner_text = @table.cornerButton.text
486
+ @table.rowHeaderWidth = @table.rowHeaderFont.getTextWidth(corner_text) + padding
487
+ end
488
+
489
+ # Выделяет одну строку таблицы и запоминает её как опорную для диапазонного выделения.
490
+ #
491
+ # @param current_row [Integer] индекс выбираемой строки
492
+ # @return [Array<Integer>, nil] массив с индексом выбранной строки
493
+ def select_single_row(current_row)
494
+ if current_row >= 0
495
+ @anchor_row = current_row
496
+ @table.selectRow(current_row, false)
497
+ self.selected_rows = [current_row]
498
+ end
499
+ end
500
+
501
+ # Обрабатывает одиночное или диапазонное (с зажатой клавишей Shift) выделение строк.
502
+ #
503
+ # @param current_row [Integer] индекс строки, по которой выполнен клик или переход
504
+ # @return [Array<Integer>, nil] обновлённый массив выделенных строк
505
+ def select_rows(current_row)
506
+ selected_row = current_row
507
+ if selected_row >= 0
508
+ is_shift = self.app.getKeyState(Fox::KEY_Shift_L) || self.app.getKeyState(Fox::KEY_Shift_R)
509
+
510
+ if is_shift && @anchor_row
511
+ start_row = [@anchor_row, selected_row].min
512
+ end_row = [@anchor_row, selected_row].max
513
+
514
+ @table.selectRange(start_row, end_row, 0, @table.numColumns - 1)
515
+ self.selected_rows = (start_row..end_row).to_a
516
+ else
517
+ select_single_row(current_row)
518
+ end
519
+ end
520
+ end
521
+
522
+ # Обновляет доступность кнопок «Изменить» и «Удалить» в зависимости от числа выделенных строк.
523
+ #
524
+ # @return [void]
525
+ def update_buttons
526
+ if @selected_rows.size > 0
527
+ @button_delete.enable
528
+ if @selected_rows.size == 1
529
+ @button_update.enable
530
+ else
531
+ @button_update.disable
532
+ end
533
+ else
534
+ @button_delete.disable
535
+ @button_update.disable
536
+ end
537
+ end
538
+
539
+ public
540
+
541
+ # Обновляет метку пагинации, доступность кнопок перелистывания, ширину столбцов и подсветку ячеек.
542
+ #
543
+ # @param current_page [Integer] номер текущей страницы
544
+ # @param pages_count [Integer] общее количество страниц
545
+ # @return [void]
546
+ def update_table(current_page, pages_count)
547
+ @pages_label.text = "#{current_page}/#{pages_count}"
548
+ @button_previous_page.enable
549
+ @button_next_page.enable
550
+ @button_previous_page.disable if current_page <= 1
551
+ @button_next_page.disable if current_page >= pages_count
552
+
553
+ fit_columns
554
+ highlight_empty_cells
555
+ @selected_rows = []
556
+ update_buttons
557
+ end
558
+
559
+ # Задаёт размеры таблицы и устанавливает заголовки столбцов и угловой кнопки.
560
+ #
561
+ # @param column_names [Array<String>] массив заголовков (нулевой элемент — заголовок столбца номеров)
562
+ # @param page_entities_count [Integer] количество строк на текущей странице
563
+ # @return [Range<Integer>] диапазон заполненных заголовков столбцов
564
+ def set_table_params(column_names, page_entities_count)
565
+ columns_count = column_names.size - 1
566
+
567
+ @table.setTableSize(page_entities_count, columns_count)
568
+ @table.cornerButton.text = column_names[0]
569
+ (0...columns_count).each { |column| @table.setColumnText(column, column_names[column + 1]) }
570
+ end
571
+
572
+ # Заполняет ячейки таблицы данными из объекта {DataTable} и сбрасывает старые иконки.
573
+ #
574
+ # @param data_table [DataTable] таблица данных для отображения
575
+ # @return [Range<Integer>] диапазон заполненных строк
576
+ def set_table_data(data_table)
577
+ rows_count = data_table.rows
578
+ columns_count = data_table.columns
579
+
580
+ (0...rows_count).each do |i|
581
+ @table.setRowText(i, data_table.element(i, 0).to_s)
582
+ (1...columns_count).each do |j|
583
+ @table.setItemText(i, j - 1, data_table.element(i, j).to_s)
584
+ @table.setItemIcon(i, j - 1, nil)
585
+ end
586
+ end
587
+ end
588
+ end
589
+
590
+ if __FILE__ == $0
591
+ app = FXApp.new
592
+ StudentListView.new(app)
593
+ app.create
594
+ app.run
595
+ end
@@ -0,0 +1,23 @@
1
+ require_relative 'student_list/domain/ValidAttrAccessor'
2
+ require_relative 'student_list/domain/basic_student'
3
+ require_relative 'student_list/domain/student'
4
+ require_relative 'student_list/domain/student_short'
5
+ require_relative 'student_list/model/data_table'
6
+ require_relative 'student_list/model/data_list'
7
+ require_relative 'student_list/model/data_list_student_short'
8
+ require_relative 'student_list/model/student_list'
9
+ require_relative 'student_list/controller/student_list_controller'
10
+ require_relative 'student_list/view/student_list_view'
11
+
12
+ # Точка входа гема StudentList.
13
+ class StudentList
14
+ # Запускает графическое приложение StudentList.
15
+ #
16
+ # @return [void]
17
+ def self.run
18
+ app = Fox::FXApp.new
19
+ StudentListView.new(app)
20
+ app.create
21
+ app.run
22
+ end
23
+ end
@@ -0,0 +1,24 @@
1
+ -- Table: public.student
2
+
3
+ -- DROP TABLE IF EXISTS public.student;
4
+
5
+ CREATE TABLE IF NOT EXISTS public.student
6
+ (
7
+ id integer NOT NULL,
8
+ first_name text COLLATE pg_catalog."default" NOT NULL,
9
+ last_name text COLLATE pg_catalog."default" NOT NULL,
10
+ patronymic text COLLATE pg_catalog."default",
11
+ telegram character varying(33) COLLATE pg_catalog."default",
12
+ email text COLLATE pg_catalog."default",
13
+ phone character varying(16) COLLATE pg_catalog."default",
14
+ git character varying(58) COLLATE pg_catalog."default",
15
+ CONSTRAINT unique_email UNIQUE (email),
16
+ CONSTRAINT unique_git UNIQUE (git),
17
+ CONSTRAINT unique_phone UNIQUE (phone),
18
+ CONSTRAINT unique_telegram UNIQUE (telegram)
19
+ )
20
+
21
+ TABLESPACE pg_default;
22
+
23
+ ALTER TABLE IF EXISTS public.student
24
+ OWNER to postgres;