Commentsv2

MyTests/ConfirmationWindow.xaml.cs

@@ -3,29 +3,29 @@ using System.Windows.Input;
 
 namespace MyTests
 {
+    // Окно с подтверждением действия
     public partial class ConfirmationWindow : Window
     {
         public bool answer;
-        public ConfirmationWindow(bool _answer = false)
+        public ConfirmationWindow()
         {
             InitializeComponent();
-            Owner = Application.Current.MainWindow;
-            answer = _answer;
+            Owner = Application.Current.MainWindow; // Устанавливается владелец этого окна, а именно главное окно приложения
         }
         private void YesButton(object sender, RoutedEventArgs e)
         {
-            answer = true;
-            this.Close();
+            answer = true; // Ответ = Да
+            this.Close(); // Закрытие окна
         }
         private void NoButton(object sender, RoutedEventArgs e)
         {
-            answer = false;
-            this.Close();
+            answer = false; // Ответ = Нет
+            this.Close(); // Закрытие окна
         }
         private void Border_MouseDown(object sender, MouseButtonEventArgs e)
         {
-            if (e.LeftButton == MouseButtonState.Pressed)
-                DragMove();
+            if (e.LeftButton == MouseButtonState.Pressed) // Если нажать мышкой на окно и держать
+                DragMove(); // Перетаскивание окна
         }
     }
 }

MyTests/ErrorWindow.xaml.cs

@@ -5,22 +5,21 @@ namespace MyTests
 {
     public partial class ErrorWindow : Window
     {
-        public ErrorWindow(string error)
+        public ErrorWindow(string error) 
         {
             InitializeComponent();
-            Owner = Application.Current.MainWindow;
-            ErrorLabel.Text = error;
+            Owner = Application.Current.MainWindow;// Устанавливается владелец этого окна, а именно главное окно приложения
+            ErrorLabel.Text = error; // Вывод ошибки
         }
         private void BackClick(object sender, RoutedEventArgs e)
         {
-            this.Close();
+            this.Close(); //Закрытие окна
         }
 
         private void Border_MouseDown(object sender, MouseButtonEventArgs e)
         {
-            if (e.LeftButton == MouseButtonState.Pressed)
-                DragMove();
+            if (e.LeftButton == MouseButtonState.Pressed) // Если нажать мышкой на окно и держать
+                DragMove(); // Перетаскивание окна
         }
     }
-}
-
+}

MyTests/MainWindow.xaml.cs

@@ -11,16 +11,16 @@ namespace MyTests
             MainFrame.Content = new Pages.LoginPage();
         }
 
-        #region Menu Bar
+        #region Кнопки закрытия и скрытия приложения
         private void Border_MouseDown(object sender, MouseButtonEventArgs e)
         {
             if (e.LeftButton == MouseButtonState.Pressed)
-                DragMove();
+                DragMove(); // Возможность перетаскивать
         }
 
         private void ButtonMininize_Click(object sender, RoutedEventArgs e)
         {
-            Application.Current.MainWindow.WindowState = WindowState.Minimized;
+            Application.Current.MainWindow.WindowState = WindowState.Minimized; //Скрытие
         }
 
         private void WindowStateButton_Click(object sender, RoutedEventArgs e)
@@ -33,7 +33,7 @@ namespace MyTests
 
         private void CloseButton_Click(object sender, RoutedEventArgs e)
         {
-            Application.Current.Shutdown();
+            Application.Current.Shutdown(); // Закрытие программы
         }
         #endregion
 

MyTests/Pages/ProfilePage.xaml.cs

@@ -105,42 +105,51 @@ namespace MyTests.Pages
         {
             try
             {
-                if (((Tests)TestsListBox.SelectedItem) != null)
+                if (((Tests)TestsListBox.SelectedItem) != null) // Если выбран элемент списка с тестами
                 {
+                    // Заполняется переменная, которая хранит в себе открытый тест
                     Session.OpenedTest = cdb.db.Tests.Where(item => item.IdTest == ((TestsClass)TestsListBox.SelectedItem).test.IdTest).FirstOrDefault();
+                    // Сбрасывается количество баллов за ответы на вопросы
                     Session.Points = 0;
+                    // Сбрасывается номер вопроса
                     Session.CurQuestion = 0;
+                    // Массив Content заполняется вопросами из открытого теста
                     Session.Quest.Content = cdb.db.Questions.Where(item => item.IdTest == Session.OpenedTest.IdTest).Select(item => item.Content).ToArray();
+                    // Массив Answer заполняется ответами из открытого теста
                     Session.Quest.Answer = cdb.db.Questions.Where(item => item.IdTest == Session.OpenedTest.IdTest).Select(item => item.Answer).ToArray();
-
-                    NavigationService.Navigate(new Pages.CurTestPage());
+                    // Переход на страницу с прохождением теста
+                    NavigationService.Navigate(new CurTestPage());
                 }
             }
             catch
             {
-                new ErrorWindow("Ошибка открытия теста.").ShowDialog();
+                new ErrorWindow("Ошибка открытия теста.").ShowDialog(); // Вывод ошибки
             }
         }
 
         private void DeleteTestButton_Click(object sender, RoutedEventArgs e)
         {
-            Button btn = (Button)sender;
-            if (btn.DataContext is TestsClass)
+            Button btn = (Button)sender; // Создается кнопка, которая равна sender
+            if (btn.DataContext is TestsClass) // Проверка на содержимое элемента ListBox. Т.е нажато по элементу ListBox или нет
             {
-                ConfirmationWindow confWindow = new ConfirmationWindow();
-                confWindow.ShowDialog();
-                if (confWindow.answer)
+                ConfirmationWindow confWindow = new ConfirmationWindow(); // Открытие окна
+                confWindow.ShowDialog();                                  // с подтверждением действия
+                if (confWindow.answer) // Если ответ "Да"
                 {
+                    // Удаляются все ответы пользователей, которые относились к выбранному тесту
                     foreach (Answers answer in cdb.db.Answers.Where(item => item.Questions.IdTest == ((TestsClass)btn.DataContext).test.IdTest))
                         cdb.db.Answers.Remove(answer);
+                    // Удаляются все вопросы, которые относились к выбранному тесту
                     foreach (Questions question in cdb.db.Questions.Where(item => item.IdTest == ((TestsClass)btn.DataContext).test.IdTest))
                         cdb.db.Questions.Remove(question);
+                    // Удаление теста
                     cdb.db.Tests.Remove(((TestsClass)btn.DataContext).test);
-                    cdb.db.SaveChanges();
-                    TestsLoading();
+                    cdb.db.SaveChanges(); // Сохранение
+                    TestsLoading(); // Обновление списка тестов
                 }
             }
         }
+        //Класс, хранящий в себе тест и картинку теста
         public class TestsClass
         {
             public Tests test { get; set; }

MyTests/Pages/RegistrationPage.xaml.cs

@@ -15,48 +15,48 @@ namespace MyTests.Pages
         {
             try
             {
-                if (!Functions.IsValidEmail(EmailBox.Text))
-                    new ErrorWindow("Email введен неверно.").Show();
-                else if (Functions.IsEmailAlreadyTaken(EmailBox.Text))
-                    new ErrorWindow("Данный email уже используется.").Show();
-                else if (!Functions.IsValidLength(LogBox.Text.Trim()))
-                    new ErrorWindow("Поле «Логин» должно содержать не менее 5 символов.").Show();
-                else if (!Functions.IsValidLength(PassBox.Password.Trim()))
-                    new ErrorWindow("Поле «Пароль» должно содержать не менее 5 символов.").Show();
-                else if (!Functions.IsLogEqualPass(LogBox.Text, PassBox.Password))
-                    new ErrorWindow(" Поля «Логин» и «Пароль» не должны быть равны").Show();
-                else if (Functions.IsLoginAlreadyTaken(LogBox.Text))
-                    new ErrorWindow("Данный логин уже занят").Show();
-                else
+                if (!Functions.IsValidEmail(EmailBox.Text)) // Проверка на правильность ввода электронной почты
+                    new ErrorWindow("Email введен неверно.").Show(); // Вывод ошибки
+                else if (Functions.IsEmailAlreadyTaken(EmailBox.Text)) // Проверка на свободность электронной почты
+                    new ErrorWindow("Данный email уже используется.").Show();// Вывод ошибки
+                else if (!Functions.IsValidLength(LogBox.Text.Trim())) // Проверка на минтимальную длину логина
+                    new ErrorWindow("Поле «Логин» должно содержать не менее 5 символов.").Show();// Вывод ошибки
+                else if (!Functions.IsValidLength(PassBox.Password.Trim())) // Проверка на минтимальную длину пароля
+                    new ErrorWindow("Поле «Пароль» должно содержать не менее 5 символов.").Show();// Вывод ошибки
+                else if (!Functions.IsLogEqualPass(LogBox.Text, PassBox.Password)) // Проверка на различие логина и пароля
+                    new ErrorWindow(" Поля «Логин» и «Пароль» не должны быть равны").Show();// Вывод ошибки
+                else if (Functions.IsLoginAlreadyTaken(LogBox.Text)) // Проверка на свободность логина
+                    new ErrorWindow("Данный логин уже занят").Show();// Вывод ошибки
+                else // Иначе, т.е если все проверки пройдены
                 {
-                    string[] fio = new string[3];
-                    fio = FIOBox.Text.Split(' ');
-                    Users newUser = new Users()
+                    string[] fio = new string[3]; // Создание массива из 3 элементов
+                    fio = FIOBox.Text.Split(' '); // Заполнение массива ФИО пользователя с разделением по пробелу . т.е Фамилия - [0], Имя - [1], Отчество - [2] 
+                    Users newUser = new Users() // Создание пользователя
                     {
-                        IdUser = cdb.db.Users.Select(p => p.IdUser).DefaultIfEmpty(0).Max() + 1,
+                        IdUser = cdb.db.Users.Select(p => p.IdUser).DefaultIfEmpty(0).Max() + 1, // id = максимальный id +1
                         Login = LogBox.Text,
-                        Password = Functions.EncryptPassword(PassBox.Password),
+                        Password = Functions.EncryptPassword(PassBox.Password), // Шифрование пароля
                         Email = EmailBox.Text,
-                        Post = cdb.db.Users.Count() == 0 ? "Преподаватель" : "Пользователь",
+                        Post = cdb.db.Users.Count() == 0 ? "Преподаватель" : "Пользователь", // Если пользователей 0, то первому выдаются права Преподавателя
                         Surname = fio[0],
                         Name = fio[1],
                         Patronymic = fio[2]
                     };
-                    cdb.db.Users.Add(newUser);
-                    cdb.db.SaveChanges();
-                    new ErrorWindow("Успешная регистрация").ShowDialog();
+                    cdb.db.Users.Add(newUser); // Добавление в базу данных
+                    cdb.db.SaveChanges(); // Сохранение
+                    new ErrorWindow("Успешная регистрация").ShowDialog(); // Вывод диалогового окна
+                    NavigationService.Navigate(new LoginPage()); // Переход на страницу входа
                 }
             }
             catch
             {
-                new ErrorWindow("Ошибка.").ShowDialog();
+                new ErrorWindow("Ошибка.").ShowDialog(); // Вывод ошибки
             }
-            NavigationService.Navigate(new Pages.LoginPage());
         }
 
         private void BackButton_Click(object sender, RoutedEventArgs e)
         {
-            NavigationService.Navigate(new Pages.LoginPage());
+            NavigationService.Navigate(new LoginPage()); // Переход на страницу входа
         }
     }
 }

MyTests/Pages/ResultTestPage.xaml.cs

@@ -5,28 +5,30 @@ using System.Windows.Navigation;
 
 namespace MyTests.Pages
 {
+    // Страница с результатом прохождения теста
     public partial class ResultTestPage : Page
     {
         public ResultTestPage()
         {
             InitializeComponent();
-            if (Session.OpenedTest.IsAnswersVisible == true)
-                CheckAnswersButton.Visibility = Visibility.Visible;
-            ResultTB.Text = $"{Session.Points}/{Session.OpenedTest.Questions.Count}";
+
+            if (Session.OpenedTest.IsAnswersVisible == true) // Если включен просмотр ответов
+                CheckAnswersButton.Visibility = Visibility.Visible; // Кнопка просмотра ответов становится видна
+            ResultTB.Text = $"{Session.Points}/{Session.OpenedTest.Questions.Count}"; // Вывод результата пользователя
         }
 
         private void AnswersButton_Click(object sender, RoutedEventArgs e)
         {
-            NavigationService.Navigate(new Pages.CheckTestResults(Session.OpenedTest, Session.User));
+            NavigationService.Navigate(new CheckTestResults(Session.OpenedTest, Session.User)); // Переход на страницу просмотра результатов
         }
 
         private void ExitButton_Click(object sender, RoutedEventArgs e)
         {
-            NavigationService.Navigate(new Pages.TestsCatalog());
+            NavigationService.Navigate(new TestsCatalog()); // Переход на страницу с каталогом тестов
         }
         private void ProfileButton_Click(object sender, RoutedEventArgs e)
         {
-            NavigationService.Navigate(new Pages.ProfilePage(cdb.db.Users.Where(item => item.IdUser == Session.OpenedTest.IdUser).FirstOrDefault()));
+            NavigationService.Navigate(new ProfilePage(cdb.db.Users.Where(item => item.IdUser == Session.OpenedTest.IdUser).FirstOrDefault())); // Переход на страницу с профилем
         }
     }
 }

MyTests/Pages/TestsCatalog.xaml.cs

@@ -9,97 +9,101 @@ using System.Windows.Navigation;
 
 namespace MyTests.Pages
 {
+    // Каталог тестов
     public partial class TestsCatalog : Page
     {
         public TestsCatalog()
         {
             InitializeComponent();
-            TestsListBox.Items.Clear();
-            if (Session.User.Post == "Преподаватель")
-                AddTestButton.Visibility = Visibility.Visible;
-            LoadingTests();
+            TestsListBox.Items.Clear(); // Очистка списка тестов
+            if (Session.User.Post == "Преподаватель")         // Если пользователь имеет права преподавателя, то
+                AddTestButton.Visibility = Visibility.Visible;// Кнопка "Создать тест" становится видна
+            LoadingTests(); // Обновление списка тестов
         }
 
-        private void AddTest_Click(object sender, RoutedEventArgs e)
+        private void AddTest_Click(object sender, RoutedEventArgs e) // Метод, который вызывается при нажатии на кнопку "создать тест"
         {
-            NavigationService.Navigate(new EditTestPage());
+            NavigationService.Navigate(new EditTestPage()); // Переход на страницу редактирования/создания теста
         }
-        void LoadingTests()
+        void LoadingTests() // Метод, обновляющий список тестов
         {
-            List<Tests> list = cdb.db.Tests.Where(item => item.IsVisible == true && item.Questions.Count > 0).ToList();
-            if (TestNameBox.Text != "Название теста")
-                list = list.Where(item => item.Name.StartsWith(TestNameBox.Text)).ToList();
+            List<Tests> list = cdb.db.Tests.Where(item => item.IsVisible == true && item.Questions.Count > 0).ToList(); // Создается список и заполняется тестами, которые видны пользователям и в которых больше 0 вопросов
+            
+            
+            if (TestNameBox.Text != "Название теста")                                        // 
+                list = list.Where(item => item.Name.StartsWith(TestNameBox.Text)).ToList();  // В списке остаются только тесты, названия которых начинается на содержимое TestNameBox (aka поиск)
 
-            if (AuthorTestBox.Text != "Преподаватель")
-                list = list.Where(item => item.Users.Surname.StartsWith(AuthorTestBox.Text)
-                || item.Users.Name.StartsWith(AuthorTestBox.Text)
-                || item.Users.Patronymic.StartsWith(AuthorTestBox.Text)).ToList();
+            if (AuthorTestBox.Text != "Преподаватель")                                       //
+                list = list.Where(item => item.Users.Surname.StartsWith(AuthorTestBox.Text)  // В списке остаются только тесты, 
+                || item.Users.Name.StartsWith(AuthorTestBox.Text)                            // автор которых начинается на содержимое AuthorTestBox (aka поиск)
+                || item.Users.Patronymic.StartsWith(AuthorTestBox.Text)).ToList();           // Поиск по имени, фамилии и отчеству
 
-            List<TestsClass> testsList = new List<TestsClass>();
+            List<TestsClass> testsList = new List<TestsClass>(); // Создание списка с тестами "для отображения"
 
-            foreach (Tests test in list)
+            foreach (Tests test in list) // Получение всех тестов из списка с тестами
             {
                 TestsClass tc = new TestsClass();
                 tc.test = test;
-                tc.testImage = test.Image == null ? new BitmapImage(new Uri("../Resources/Approval.png", UriKind.RelativeOrAbsolute)) : ImagesFunctions.NewImage(test);
-                testsList.Add(tc);
+                tc.testImage = test.Image == null ? new BitmapImage(new Uri("../Resources/Approval.png", UriKind.RelativeOrAbsolute)) : ImagesFunctions.NewImage(test); // Если у теста нет картинки - устанавливается стандартная. Если есть, то берется из БД
+                testsList.Add(tc);// Добавление теста в список "для отображения"
             }
-
+            // Заполнение содержимым TestsListBox. Т.е сам вывод тестов пользователю
             TestsListBox.ItemsSource = testsList;
 
         }
 
         private void FindTests_Click(object sender, RoutedEventArgs e)
         {
-            LoadingTests();
+            LoadingTests(); // Обновление списка тестов
         }
 
         private void TestNameBox_PreviewMouseDown(object sender, MouseButtonEventArgs e)
         {
-            ((TextBox)sender).Text = String.Empty;
+            ((TextBox)sender).Text = String.Empty; // Очистка строки поиска по названию теста
         }
 
         private void TestNameBox_LostFocus(object sender, RoutedEventArgs e)
         {
-            if (TestNameBox.Text.Trim() == "")
-                TestNameBox.Text = "Название теста";
+            if (TestNameBox.Text.Trim() == "")        //
+                TestNameBox.Text = "Название теста";  // Возврат стандартного текста у поля для ввода названия теста(поиск)
         }
 
         private void AuthorTestBox_PreviewMouseDown(object sender, MouseButtonEventArgs e)
         {
-            ((TextBox)sender).Text = String.Empty;
+            ((TextBox)sender).Text = String.Empty; // Очистка строки поиска по автору
         }
 
         private void AuthorTestBox_LostFocus(object sender, RoutedEventArgs e)
         {
-            if (AuthorTestBox.Text.Trim() == "")
-                AuthorTestBox.Text = "Преподаватель";
+            if (AuthorTestBox.Text.Trim() == "")      //
+                AuthorTestBox.Text = "Преподаватель"; //Возврат стандартного текста у поля для ввода автора теста(поиск)
         }
 
-        private void TestsListBox_SelectionChanged(object sender, SelectionChangedEventArgs e)
+        private void TestsListBox_SelectionChanged(object sender, SelectionChangedEventArgs e) // Вызывается при нажатии на тест
         {
             try
             {
-                if (((TestsClass)TestsListBox.SelectedItem) != null)
+                if (((TestsClass)TestsListBox.SelectedItem) != null) // Доп проверка на то, что выбран именно тест
                 {
+                    // Создание переменной, которая равна выбранному тесту
                     Tests thisTest = cdb.db.Tests.Where(item => item.IdTest == ((TestsClass)TestsListBox.SelectedItem).test.IdTest).FirstOrDefault();
-
-                    if (!thisTest.CanAgain && cdb.db.Answers.Where(item => item.Questions.Tests.IdTest == thisTest.IdTest).Select(item => item.IdUser).Contains(Session.User.IdUser) && Session.User.IdUser != thisTest.IdUser)
-                        new ErrorWindow("Этот тест не может быть пройден повторно.").ShowDialog();
-                    else
+                    
+                    if (!thisTest.CanAgain && cdb.db.Answers.Where(item => item.Questions.Tests.IdTest == thisTest.IdTest).Select(item => item.IdUser).Contains(Session.User.IdUser) && Session.User.IdUser != thisTest.IdUser) // Проверка на возможность пройти тест повторно
+                        new ErrorWindow("Этот тест не может быть пройден повторно.").ShowDialog(); // Вывод ошибки
+                    else // Если пройти повторно или впервые возможно, то
                     {
-                        Session.OpenedTest = thisTest;
-                        Session.Points = 0;
-                        Session.CurQuestion = 0;
-                        Session.Quest.Content = cdb.db.Questions.Where(item => item.IdTest == Session.OpenedTest.IdTest).Select(item => item.Content).ToArray();
-                        Session.Quest.Answer = cdb.db.Questions.Where(item => item.IdTest == Session.OpenedTest.IdTest).Select(item => item.Answer).ToArray();
-                        NavigationService.Navigate(new Pages.CurTestPage());
+                        Session.OpenedTest = thisTest; // Открытый тест = выбранному тесту
+                        Session.Points = 0; // Сброс очков
+                        Session.CurQuestion = 0; // Сброс текущего вопроса
+                        Session.Quest.Content = cdb.db.Questions.Where(item => item.IdTest == Session.OpenedTest.IdTest).Select(item => item.Content).ToArray(); // Заполнение массива вопросами (нужно для отображения вопросов в тесте)
+                        Session.Quest.Answer = cdb.db.Questions.Where(item => item.IdTest == Session.OpenedTest.IdTest).Select(item => item.Answer).ToArray(); // Запонение массива ответами (нужно для подсчета правильных ответов)
+                        NavigationService.Navigate(new CurTestPage()); // Переход на страницу с решением теста
                     }
                 }
             }
             catch
             {
-                new ErrorWindow("Ошибка открытия теста.").ShowDialog();
+                new ErrorWindow("Ошибка открытия теста.").ShowDialog(); // Вывод ошибки
             }
         }
 

MyTests/QuestionAddToTestWindow.xaml.cs

@@ -12,7 +12,7 @@ namespace MyTests
         public QuestionAddToTestWindow(Tests _test)
         {
             InitializeComponent();
-            Owner = Application.Current.MainWindow;
+            Owner = Application.Current.MainWindow; // Устанавливается владелец окна. т.е главное окно
             test = _test;
         }
 
@@ -26,16 +26,16 @@ namespace MyTests
             {
                 try
                 {
-                    Questions newQuestion = new Questions
+                    Questions newQuestion = new Questions // Создание вопроса
                     {
-                        IdQuestion = cdb.db.Questions.Select(p => p.IdQuestion).DefaultIfEmpty(0).Max() + 1,
-                        IdTest = test.IdTest,
-                        Content = QuestionBox.Text,
-                        Answer = AnswerBox.Text
+                        IdQuestion = cdb.db.Questions.Select(p => p.IdQuestion).DefaultIfEmpty(0).Max() + 1, // максимальный id +1
+                        IdTest = test.IdTest,       // Тест - переменная, переданная при запуске этого окна
+                        Content = QuestionBox.Text, // Вопрос = QuestionBox.Text
+                        Answer = AnswerBox.Text     // Ответ  = AnswerBox.Text
                     };
-                    cdb.db.Questions.Add(newQuestion);
-                    cdb.db.SaveChanges();
-                    Close();
+                    cdb.db.Questions.Add(newQuestion); // Добавление в БД
+                    cdb.db.SaveChanges(); //Сохранение
+                    Close(); // Закрытие окна
                 }
                 catch (Exception ex)
                 {

MyTests/Session.cs

@@ -2,11 +2,11 @@
 {
     class Session
     {
-        public static Users User { get; set; }
-        public static Tests OpenedTest { get; set; }
-        public static int Points = 0;
-        public static int CurQuestion = 0;
-        public static class Quest
+        public static Users User { get; set; } // Текущий пользователь
+        public static Tests OpenedTest { get; set; } // Текущий открытый тест
+        public static int Points = 0; // Очки, выдаются за правильный ответ
+        public static int CurQuestion = 0; // Текущий № вопроса
+        public static class Quest // класс, хранит в себе вопросы и ответы на выбранный тест
         {
             public static string[] Content;
             public static string[] Answer;

MyTests/Styles/Style.cs

@@ -8,12 +8,12 @@ namespace MyTests
     public partial class Style : ResourceDictionary
     {
         private void MouseEnter(object sender, MouseEventArgs e)
-        {
+        {//Изменение цвета обводки кнопки при наведении
             ((Border)sender).Background = new SolidColorBrush(Color.FromArgb(0xFF, 0x2F, 0x31, 0x36));
         }
 
         private void MouseLeave(object sender, MouseEventArgs e)
-        {
+        {//Изменение цвета обводки кнопки, когда мышка переносится на другой обьект
             ((Border)sender).Background = new SolidColorBrush(Color.FromArgb(0xFF, 0x33, 0x36, 0x3C));
         }
     }

MyTests/cdb.cs

@@ -1,7 +1,7 @@
 namespace MyTests
 {
     public class cdb
-    {
+    { // Подключение к БД
         public static MyTestsDataBaseEntities db = new MyTestsDataBaseEntities();
     }
 }