Message Box Класс

Определение

Отображает окно сообщения (диалоговое окно) с текстом для пользователя. Displays a message window, also known as a dialog box, which presents a message to the user. Это модальное окно, блокирующее другие действия в приложении, пока пользователь не закроет его. It is a modal window, blocking other actions in the application until the user closes it. MessageBox может содержать текст, кнопки и символы для отображения пользователю информации и инструкций. A MessageBox can contain text, buttons, and symbols that inform and instruct the user.

Примеры

В следующем примере кода показано, как использовать объект MessageBox для информирования пользователя об отсутствующей записи в TextBox . The following code example shows how to use a MessageBox to inform the user of a missing entry in a TextBox. Для этого примера требуется, чтобы метод вызывался из существующей формы с TextBox именем ServerName . This example requires that the method is called from an existing form with a TextBox named ServerName on it.

В следующем примере кода показано, как задать пользователю да или нет вопроса и принять решение, основанное на ответе. The following code example shows how to ask the user a yes or no question and make a decision based on the response.

Комментарии

Нельзя создать новый экземпляр MessageBox класса. You cannot create a new instance of the MessageBox class. Чтобы отобразить окно сообщения, вызовите static метод MessageBox.Show . To display a message box, call the static method MessageBox.Show. Заголовок, сообщение, кнопки и значки, отображаемые в окне сообщения, определяются параметрами, передаваемыми этому методу. The title, message, buttons, and icons displayed in the message box are determined by parameters that you pass to this method.

Методы

Определяет, равен ли указанный объект текущему объекту. Determines whether the specified object is equal to the current object.

(Унаследовано от Object) GetHashCode()

Служит хэш-функцией по умолчанию. Serves as the default hash function.

(Унаследовано от Object) GetType()

Возвращает объект Type для текущего экземпляра. Gets the Type of the current instance.

(Унаследовано от Object) MemberwiseClone()

Создает неполную копию текущего объекта Object. Creates a shallow copy of the current Object.

(Унаследовано от Object) Show(IWin32Window, String)

Отображает перед заданным объектом окно сообщения, содержащее заданный текст. Displays a message box in front of the specified object and with the specified text.

Отображает перед заданным объектом окно сообщения, содержащее заданный текст и заголовок. Displays a message box in front of the specified object and with the specified text and caption.

Отображает перед заданным объектом окно сообщения, содержащее заданный текст, заголовок и кнопки. Displays a message box in front of the specified object and with the specified text, caption, and buttons.

Отображает перед заданным объектом окно сообщения, содержащее заданный текст, заголовок, кнопки и значок. Displays a message box in front of the specified object and with the specified text, caption, buttons, and icon.

Отображает перед заданным объектом окно сообщения, содержащее заданный текст, заголовок, кнопки, значок и кнопку по умолчанию. Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, and default button.

Отображает перед заданным объектом окно сообщения, содержащее заданный текст, заголовок, кнопки, значок, кнопку по умолчанию и параметры. Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, default button, and options.

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой «Справка», используя заданный файл справки. Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой «Справка», используя заданный файл справки и HelpNavigator . Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator .

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой «Справка», используя заданный файл справки, HelpNavigator и раздел справки. Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator , and Help topic.

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой «Справка», используя заданный файл справки и Ключевое слово справки. Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

Отображает окно сообщения с заданным текстом. Displays a message box with specified text.

Отображает окно сообщения с заданным текстом и заголовком. Displays a message box with specified text and caption.

Отображает окно сообщения с заданным текстом, заголовком и кнопками. Displays a message box with specified text, caption, and buttons.

Отображает окно сообщения с заданным текстом, заголовком, кнопками и значком. Displays a message box with specified text, caption, buttons, and icon.

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком и кнопкой по умолчанию. Displays a message box with the specified text, caption, buttons, icon, and default button.

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию и параметрами для выбора. Displays a message box with the specified text, caption, buttons, icon, default button, and options.

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора и кнопкой «Справка». Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button.

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой «Справка», используя заданный файл справки. Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой «Справка», используя заданный файл справки и HelpNavigator . Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator .

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой «Справка», используя заданный файл справки, HelpNavigator и раздел справки. Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator , and Help topic.

Отображает окно сообщения с заданным текстом, заголовком, кнопками, значком, кнопкой по умолчанию, параметрами для выбора, кнопкой «Справка», используя заданный файл справки и Ключевое слово справки. Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

Возвращает строку, представляющую текущий объект. Returns a string that represents the current object.

Message Box Icon Перечисление

Определение

Задает константы, определяющие отображаемые сведения. Specifies constants defining which information to display.

Окно сообщения содержит символ, состоящий из строчной буквы в кружке. The message box contains a symbol consisting of a lowercase letter i in a circle.

Окно сообщения содержит символ, состоящий из белого X в кружке с красным фоном. The message box contains a symbol consisting of white X in a circle with a red background.

Окно сообщения содержит символ, состоящий из восклицательного знака в треугольнике с желтым фоном. The message box contains a symbol consisting of an exclamation point in a triangle with a yellow background.

Окно сообщения содержит символ, состоящий из белого X в кружке с красным фоном. The message box contains a symbol consisting of a white X in a circle with a red background.

Окно сообщения содержит символ, состоящий из строчной буквы в кружке. The message box contains a symbol consisting of a lowercase letter i in a circle.

Окно сообщения не содержит символы. The message box contains no symbols.

Окно сообщения содержит символ, состоящий из вопросительного знака в кружке. The message box contains a symbol consisting of a question mark in a circle. Больше не рекомендуется использовать значок вопросительного знака для сообщений, так как он не может четко отразить определенный тип сообщения, а оформление сообщения в виде вопроса может применяться для любого типа сообщений. The question mark message icon is no longer recommended because it does not clearly represent a specific type of message and because the phrasing of a message as a question could apply to any message type. Кроме того, пользователи могут путать вопросительный знак с символом справочной информации. In addition, users can confuse the question mark symbol with a help information symbol. Таким образом, не следует использовать символ вопросительного знака в окнах сообщений. Therefore, do not use this question mark symbol in your message boxes. Система продолжает поддерживать его включение только для обратной совместимости. The system continues to support its inclusion only for backward compatibility.

Окно сообщения содержит символ, состоящий из белого X в кружке с красным фоном. The message box contains a symbol consisting of white X in a circle with a red background.

Окно сообщения содержит символ, состоящий из восклицательного знака в треугольнике с желтым фоном. The message box contains a symbol consisting of an exclamation point in a triangle with a yellow background.

Примеры

В следующем примере кода показано, как использовать объект MessageBox для информирования пользователя об отсутствующей записи в TextBox . The following code example shows how to use a MessageBox to inform the user of a missing entry in a TextBox. Для этого примера требуется, чтобы метод вызывался из существующей формы с Button и TextBox . This example requires that the method is called from an existing form with a Button and a TextBox on it.

Комментарии

Это перечисление используется классом MessageBox. This enumeration is used by the MessageBox class. Описание каждого члена перечисления содержит типичное представление символа. The description of each member of this enumeration contains a typical representation of the symbol. Фактически отображаемый рисунок является функцией констант операционной системы. The actual graphic displayed is a function of the operating system constants. В текущих реализациях существует четыре уникальных символа с несколькими назначенными им значениями. In current implementations there are four unique symbols with multiple values assigned to them.

В следующей таблице показаны различные значки окна сообщения. The following table shows the different message box icons.

Message Box Options Перечисление

Определение

Задает параметры в MessageBox. Specifies options on a MessageBox.

Это перечисление имеет атрибут FlagsAttribute, который разрешает побитовое сочетание значений его элементов.

Данное окно сообщения отображается на активном рабочем столе. The message box is displayed on the active desktop. Эта константа аналогична ServiceNotification , за исключением того, что в системе окно сообщения отображается только на стандартном рабочем столе интерактивного оконного терминала. This constant is similar to ServiceNotification , except that the system displays the message box only on the default desktop of the interactive window station. Приложение, отображающее окно сообщения, теряет фокус, и окно сообщения отображается без стилей оформления. The application that displayed the message box loses focus, and the message box is displayed without using visual styles. Дополнительные сведения см. в разделе Отрисовка элементов управления с помощью визуальных стилей. For more information, see Rendering Controls with Visual Styles.

Текст в окне сообщения выравнивается по правому краю. The message box text is right-aligned.

Указывает, что текст в данном окне сообщения отображается с порядком чтения справа налево. Specifies that the message box text is displayed with right to left reading order.

Данное окно сообщения отображается на активном рабочем столе. The message box is displayed on the active desktop. Вызывающий объект — это служба, которая уведомляет пользователя о событии. The caller is a service notifying the user of an event. Show отображает окно сообщения на активном в настоящий момент рабочем столе, даже если пользователь не вошел в систему. Show displays a message box on the current active desktop, even if there is no user logged on to the computer.

Примеры

В следующем примере показано, как отобразить MessageBox с параметрами, поддерживаемыми перегрузками MessageBox.Show , включающими options параметр. The following example demonstrates how to display a MessageBox with the options supported by the overloads of MessageBox.Show that include an options parameter. После проверки того, что строковая переменная ServerName пуста, в примере отображается MessageBox значок с полем вопроса, предлагающий пользователю отменить операцию. After verifying that a string variable, ServerName , is empty, the example displays a MessageBox with a question box icon, offering the user the option to cancel the operation. В примере MessageBoxOptions.RightAlign элемент перечисления используется для выровняйте текст по правому краю диалогового окна. The example uses the MessageBoxOptions.RightAlign enumeration member to align the text to the right edge of the dialog box. Если Show возвращаемое значение метода равно DialogResult.Yes , то форма, на которой отображается, MessageBox закрывается. If the Show method’s return value evaluates to DialogResult.Yes, the form that displayed the MessageBox is closed.

Комментарии

Это перечисление используется классом MessageBox. This enumeration is used by the MessageBox class.

Если не нужно указывать аргумент при вызове методов в MessageBox , вместо этого можно передать значение 0. If you do not want to specify an argument when calling methods on MessageBox, you can pass in 0 instead.