MessageBox.Show Methode

Definitie

Geeft een berichtvak weer.

Overloads

Name Description
Show(String)

Hiermee wordt een berichtvak met opgegeven tekst weergegeven.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand en het opgegeven Help-trefwoord.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand en HelpNavigatorHelp-onderwerp.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand en HelpNavigator.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand en het opgegeven Help-trefwoord.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Geeft een berichtvak weer vóór het opgegeven object en met de opgegeven tekst, bijschrift, knoppen, pictogram, standaardknop en opties.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

Geeft een berichtvak weer met de opgegeven tekst, bijschrift, knoppen, pictogram, standaardknop, opties en Help-knop.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand en HelpNavigator.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Geeft een berichtvak weer vóór het opgegeven object en met de opgegeven tekst, bijschrift, knoppen, pictogram en standaardknop.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)

Geeft een berichtvak weer vóór het opgegeven object en met de opgegeven tekst, bijschrift, knoppen en pictogram.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Geeft een berichtvak weer met de opgegeven tekst, bijschrift, knoppen, pictogram en standaardknop.

Show(IWin32Window, String, String, MessageBoxButtons)

Geeft een berichtvak weer vóór het opgegeven object en met de opgegeven tekst, bijschrift en knoppen.

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Hiermee wordt een berichtvak met opgegeven tekst, bijschrift, knoppen en pictogram weergegeven.

Show(IWin32Window, String, String)

Geeft een berichtvak weer vóór het opgegeven object en met de opgegeven tekst en bijschrift.

Show(String, String, MessageBoxButtons)

Hiermee wordt een berichtvak met opgegeven tekst, bijschrift en knoppen weergegeven.

Show(IWin32Window, String)

Geeft een berichtvak weer vóór het opgegeven object en met de opgegeven tekst.

Show(String, String)

Geeft een berichtvak weer met opgegeven tekst en bijschrift.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Geeft een berichtvak weer met de opgegeven tekst, bijschrift, knoppen, pictogram, standaardknop en opties.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand en HelpNavigatorHelp-onderwerp.

Show(String)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Hiermee wordt een berichtvak met opgegeven tekst weergegeven.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text);
public static System.Windows.Forms.DialogResult Show(string text);
public static System.Windows.Forms.DialogResult Show(string? text);
static member Show : string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String) As DialogResult

Parameters

text
String

De tekst die moet worden weergegeven in het berichtvak.

Retouren

Een van de DialogResult waarden.

Voorbeelden

In het volgende codevoorbeeld wordt een eenvoudig berichtvak weergegeven.

private void DisplayMessageBoxText()
{
         MessageBox.Show("Hello, world.");
}
Private Sub DisplayMessageBoxText()

    MessageBox.Show("Hello, world.")
End Sub

Opmerkingen

Standaard wordt in het berichtvak een knop OK weergegeven. Het berichtvak bevat geen bijschrift in de titel.

Van toepassing op

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand en het opgegeven Help-trefwoord.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parameters

owner
IWin32Window

Een implementatie hiervan is de eigenaar van IWin32Window het modale dialoogvenster.

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

options
MessageBoxOptions

Een van de MessageBoxOptions waarden die aangeven welke weergave- en koppelingsopties worden gebruikt voor het berichtvak. U kunt 0 doorgeven als u de standaardinstellingen wilt gebruiken.

helpFilePath
String

Het pad en de naam van het Help-bestand dat moet worden weergegeven wanneer de gebruiker op de knop Help klikt.

keyword
String

Het Trefwoord Help dat moet worden weergegeven wanneer de gebruiker op de knop Help klikt.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

De defaultButton opgegeven is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

options DefaultDesktopOnly ServiceNotificationzowel als .

– of –

buttons een ongeldige combinatie van MessageBoxButtons.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een berichtvak weergeeft dat boven het hoofdvenster staat. In het berichtvak wordt een Help-knop weergegeven. Wanneer de gebruiker op de knop Help klikt, wordt het Mspaint.chm Help-bestand geopend en wordt het onderwerp weergegeven dat door het mspaint.chm::/paint_brush.htm trefwoord wordt geïdentificeerd. Voor het voorbeeld moet het Mspaint.chm Help-bestand zijn geïnstalleerd.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r8 = MessageBox::Show( this, "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r8 = MessageBox.Show (this, "Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r8 As DialogResult = MessageBox.Show(Me, "Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Opmerkingen

Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden. U kunt de owner parameter gebruiken om een bepaald object op te geven, waarmee de IWin32Window interface wordt geïmplementeerd, die als eigenaar van het dialoogvenster op het hoogste niveau fungeert.

Wanneer de gebruiker op de knop Help klikt, wordt het Help-bestand dat is opgegeven in de helpFilePath parameter geopend en wordt het trefwoordonderwerp Help weergegeven dat is geïdentificeerd door de keyword parameter. Het formulier dat eigenaar is van het berichtvak (of het actieve formulier) ontvangt ook de HelpRequested gebeurtenis.

Zie ook

Van toepassing op

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand en HelpNavigatorHelp-onderwerp.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show(string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
public static System.Windows.Forms.DialogResult Show(string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parameters

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

options
MessageBoxOptions

Een van de MessageBoxOptions waarden die aangeven welke weergave- en koppelingsopties worden gebruikt voor het berichtvak. U kunt 0 doorgeven als u de standaardinstellingen wilt gebruiken.

helpFilePath
String

Het pad en de naam van het Help-bestand dat moet worden weergegeven wanneer de gebruiker op de knop Help klikt.

navigator
HelpNavigator

Een van de HelpNavigator waarden.

param
Object

De numerieke id van het Help-onderwerp dat moet worden weergegeven wanneer de gebruiker op de knop Help klikt.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

De defaultButton opgegeven is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

options DefaultDesktopOnly ServiceNotificationzowel als .

– of –

buttons een ongeldige combinatie van MessageBoxButtons.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een berichtvak met een Help-knop kunt weergeven. Wanneer de gebruiker op de knop Help klikt, wordt het Mspaint.chm Help-bestand geopend en wordt het tabblad Help-index en het onderwerp dat door het ovals trefwoord wordt geïdentificeerd, weergegeven. Voor het voorbeeld moet het Mspaint.chm Help-bestand zijn geïnstalleerd.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r5 = MessageBox::Show( "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r5 = MessageBox.Show ("Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");
' Display a message box. The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r5 As DialogResult = MessageBox.Show("Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Opmerkingen

Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden.

Wanneer de gebruiker op de knop Help klikt, wordt het Help-bestand dat is opgegeven in de helpFilePath parameter geopend en wordt de Help-inhoud weergegeven die wordt geïdentificeerd door de navigator parameter. Het formulier dat eigenaar is van het berichtvak (of het actieve formulier) ontvangt ook de HelpRequested gebeurtenis.

Gecompileerde Help-bestanden bieden koppelingen naar inhoudsopgave, index, zoekopdrachten en trefwoordkoppelingen op pagina's. U kunt de volgende waarden gebruiken voor navigator: TableOfContents, Find, Indexof Topic.

U kunt de param opdracht verder verfijnen Topic . Als de waarde die is opgegeven in de navigator parameter , TableOfContentsIndexof Find, moet deze waarde zijn null. Als de navigator parameterverwijzingen Topicverwijzen, moet deze waarde verwijzen naar een object dat de numerieke waarde van het onderwerp bevat die moet worden weergegeven.

De helpFilePath parameter kan van het formulier C:\path\sample.chm of /folder/file.htmzijn.

Zie ook

Van toepassing op

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parameters

owner
IWin32Window

Een implementatie hiervan is de eigenaar van IWin32Window het modale dialoogvenster.

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

options
MessageBoxOptions

Een van de MessageBoxOptions waarden die aangeven welke weergave- en koppelingsopties worden gebruikt voor het berichtvak. U kunt 0 doorgeven als u de standaardinstellingen wilt gebruiken.

helpFilePath
String

Het pad en de naam van het Help-bestand dat moet worden weergegeven wanneer de gebruiker op de knop Help klikt.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

De defaultButton opgegeven is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

options DefaultDesktopOnly ServiceNotificationzowel als .

– of –

buttons een ongeldige combinatie van MessageBoxButtons.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een berichtvak weergeeft dat boven het hoofdformulier staat. In het berichtvak wordt een Help-knop weergegeven. Wanneer de gebruiker op de knop Help klikt, wordt het Mspaint.chm Help-bestand geopend. Voor het voorbeeld moet het Mspaint.chm Help-bestand zijn geïnstalleerd.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r2 = MessageBox::Show( this, "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r2 = MessageBox.Show (this, "Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file.
Dim r2 As DialogResult = MessageBox.Show(Me, "Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Opmerkingen

Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden. U kunt de owner parameter gebruiken om een bepaald object op te geven, waarmee de IWin32Window interface wordt geïmplementeerd, die fungeert als het venster op het hoogste niveau en de eigenaar van het dialoogvenster.

Wanneer de gebruiker op de knop Help klikt, wordt het Help-bestand dat is opgegeven in de helpFilePath parameter geopend. Het formulier dat eigenaar is van het berichtvak (of het actieve formulier) ontvangt ook de HelpRequested gebeurtenis.

De helpFilePath parameter kan van het formulier C:\path\sample.chm of /folder/file.htmzijn.

Zie ook

Van toepassing op

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand en HelpNavigator.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show(string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show(string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parameters

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

options
MessageBoxOptions

Een van de MessageBoxOptions waarden die aangeven welke weergave- en koppelingsopties worden gebruikt voor het berichtvak. U kunt 0 doorgeven als u de standaardinstellingen wilt gebruiken.

helpFilePath
String

Het pad en de naam van het Help-bestand dat moet worden weergegeven wanneer de gebruiker op de knop Help klikt.

navigator
HelpNavigator

Een van de HelpNavigator waarden.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

De defaultButton opgegeven is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

options DefaultDesktopOnly ServiceNotificationzowel als .

– of –

buttons een ongeldige combinatie van MessageBoxButtons.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een berichtvak met een Help-knop kunt weergeven. Wanneer de gebruiker op de knop Help klikt, wordt het Mspaint.chm Help-bestand geopend en wordt het tabblad Help-index weergegeven. Voor het voorbeeld moet het Mspaint.chm Help-bestand zijn geïnstalleerd.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
System::Windows::Forms::DialogResult r3 = MessageBox::Show( "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
DialogResult r3 = MessageBox.Show ("Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);
' Display a message box. The Help button opens 
' the Mspaint.chm Help file and shows the Help contents 
' on the Index tab.
Dim r3 As DialogResult = MessageBox.Show("Message with Help file and Help navigator.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.Index)

Opmerkingen

Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden.

Wanneer de gebruiker op de knop Help klikt, wordt het Help-bestand dat is opgegeven in de helpFilePath parameter geopend en wordt de Help-inhoud weergegeven die wordt geïdentificeerd door de navigator parameter. Het formulier dat eigenaar is van het berichtvak (of het actieve formulier) ontvangt ook de HelpRequested gebeurtenis.

Gecompileerde Help-bestanden bieden koppelingen naar inhoudsopgave, index, zoekopdrachten en trefwoordkoppelingen op pagina's. U kunt de volgende waarden gebruiken voor navigator: TableOfContents, Find, Indexof Topic.

De helpFilePath parameter kan van het formulier C:\path\sample.chm of /folder/file.htmzijn.

Zie ook

Van toepassing op

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand en het opgegeven Help-trefwoord.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show(string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
public static System.Windows.Forms.DialogResult Show(string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parameters

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

options
MessageBoxOptions

Een van de MessageBoxOptions waarden die aangeven welke weergave- en koppelingsopties worden gebruikt voor het berichtvak. U kunt 0 doorgeven als u de standaardinstellingen wilt gebruiken.

helpFilePath
String

Het pad en de naam van het Help-bestand dat moet worden weergegeven wanneer de gebruiker op de knop Help klikt.

keyword
String

Het Trefwoord Help dat moet worden weergegeven wanneer de gebruiker op de knop Help klikt.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

De defaultButton opgegeven is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

options DefaultDesktopOnly ServiceNotificationzowel als .

– of –

buttons een ongeldige combinatie van MessageBoxButtons.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een berichtvak met een Help-knop kunt weergeven. Wanneer de gebruiker op de knop Help klikt, wordt het Mspaint.chm Help-bestand geopend en wordt het onderwerp weergegeven dat door het mspaint.chm::/paint_brush.htm trefwoord wordt geïdentificeerd. Voor het voorbeeld moet het Mspaint.chm Help-bestand zijn geïnstalleerd.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r7 = MessageBox::Show( "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r7 = MessageBox.Show ("Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display a message box. The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r7 As DialogResult = MessageBox.Show("Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Opmerkingen

Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden.

Wanneer de gebruiker op de knop Help klikt, wordt het Help-bestand dat is opgegeven in de helpFilePath parameter geopend en wordt het trefwoordonderwerp Help weergegeven dat is geïdentificeerd door de keyword parameter. Het formulier dat eigenaar is van het berichtvak (of het actieve formulier) ontvangt ook de HelpRequested gebeurtenis.

Zie ook

Van toepassing op

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer vóór het opgegeven object en met de opgegeven tekst, bijschrift, knoppen, pictogram, standaardknop en opties.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parameters

owner
IWin32Window

Een implementatie hiervan is de eigenaar van IWin32Window het modale dialoogvenster.

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

options
MessageBoxOptions

Een van de MessageBoxOptions waarden die aangeven welke weergave- en koppelingsopties worden gebruikt voor het berichtvak. U kunt 0 doorgeven als u de standaardinstellingen wilt gebruiken.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

defaultButton is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

options DefaultDesktopOnly ServiceNotificationzowel als .

– of –

optionsopgegeven of DefaultDesktopOnly en opgegeven ServiceNotification een waarde in de owner parameter. Deze twee opties moeten alleen worden gebruikt als u de versie van deze methode aanroept die geen parameter accepteert owner .

– of –

buttons een ongeldige combinatie van MessageBoxButtons.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een MessageBox met de opties kunt weergeven die worden ondersteund door deze overbelasting van Show. Nadat u hebt gecontroleerd of een tekenreeksvariabele leeg is, ServerNamewordt in het voorbeeld een MessageBoxvoorbeeld weergegeven, zodat de gebruiker de optie heeft om de bewerking te annuleren. Als de retourwaarde van de Show methode wordt geëvalueerd Yes, wordt het formulier dat wordt MessageBox weergegeven gesloten.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Opmerkingen

U kunt de owner parameter gebruiken om een bepaald object op te geven, waarmee de IWin32Window interface wordt geïmplementeerd, die fungeert als het venster op het hoogste niveau en de eigenaar van het dialoogvenster. Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden.

U kunt maximaal drie knoppen in het berichtvak hebben.

Zie ook

Van toepassing op

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show(string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
public static System.Windows.Forms.DialogResult Show(string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parameters

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

options
MessageBoxOptions

Een van de MessageBoxOptions waarden die aangeven welke weergave- en koppelingsopties worden gebruikt voor het berichtvak. U kunt 0 doorgeven als u de standaardinstellingen wilt gebruiken.

helpFilePath
String

Het pad en de naam van het Help-bestand dat moet worden weergegeven wanneer de gebruiker op de knop Help klikt.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

De defaultButton opgegeven is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

options DefaultDesktopOnly ServiceNotificationzowel als .

– of –

buttons een ongeldige combinatie van MessageBoxButtons.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een berichtvak met een Help-knop kunt weergeven. Wanneer de gebruiker op de knop Help klikt, wordt het Mspaint.chm Help-bestand geopend. Voor het voorbeeld moet het Mspaint.chm Help-bestand zijn geïnstalleerd.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r1 = MessageBox::Show( "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r1 = MessageBox.Show ("Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box with a help button. 
' The Help button opens the Mspaint.chm Help file.
Dim r1 As DialogResult = MessageBox.Show("Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Opmerkingen

Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden.

Wanneer de gebruiker op de knop Help klikt, wordt het Help-bestand dat is opgegeven in de helpFilePath parameter geopend. Het formulier dat eigenaar is van het berichtvak (of het actieve formulier) ontvangt ook de HelpRequested gebeurtenis.

De helpFilePath parameter kan van het formulier C:\path\sample.chm of /folder/file.htmzijn.

Zie ook

Van toepassing op

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer met de opgegeven tekst, bijschrift, knoppen, pictogram, standaardknop, opties en Help-knop.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, bool displayHelpButton);
public static System.Windows.Forms.DialogResult Show(string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);
public static System.Windows.Forms.DialogResult Show(string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * bool -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, displayHelpButton As Boolean) As DialogResult

Parameters

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

options
MessageBoxOptions

Een van de MessageBoxOptions waarden die aangeven welke weergave- en koppelingsopties worden gebruikt voor het berichtvak. U kunt 0 doorgeven als u de standaardinstellingen wilt gebruiken.

displayHelpButton
Boolean

true om de Knop Help weer te geven; anders, false. De standaardwaarde is false.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

De defaultButton opgegeven is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

options DefaultDesktopOnly ServiceNotificationzowel als .

– of –

buttons een ongeldige combinatie van MessageBoxButtons.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een berichtvak met een Help-knop weergeeft, de Control.HelpRequested gebeurtenis afhandelt en een aangepast Help-venster weergeeft als reactie op de gebeurtenis.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
System::Windows::Forms::DialogResult AlertMessageWithCustomHelpWindow()
{
   
   // Handle the HelpRequested event for the following message.
   this->HelpRequested += gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   this->Tag = "Message with Help button.";
   
   // Show a message box with OK and Help buttons.
   System::Windows::Forms::DialogResult r = MessageBox::Show( "Message with Help button.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, true );
   
   // Remove the HelpRequested event handler to keep the event
   // from being handled for other message boxes.
   this->HelpRequested -= gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   
   // Return the dialog box result.
   return r;
}

void Form1_HelpRequested( System::Object^ sender, System::Windows::Forms::HelpEventArgs^ hlpevent )
{
   
   // Create a custom Help window in response to the HelpRequested event.
   Form^ helpForm = gcnew Form;
   
   // Set up the form position, size, and title caption.
   helpForm->StartPosition = FormStartPosition::Manual;
   helpForm->Size = System::Drawing::Size( 200, 400 );
   helpForm->DesktopLocation = Point(this->DesktopBounds.X + this->Size.Width,this->DesktopBounds.Top);
   helpForm->Text = "Help Form";
   
   // Create a label to contain the Help text.
   Label^ helpLabel = gcnew Label;
   
   // Add the label to the form and set its text.
   helpForm->Controls->Add( helpLabel );
   helpLabel->Dock = DockStyle::Fill;
   
   // Use the sender parameter to identify the context of the Help request.
   // The parameter must be cast to the Control type to get the Tag property.
   Control^ senderControl = dynamic_cast<Control^>(sender);
   helpLabel->Text = String::Format( "Help information shown in response to user action on the '{0}' message.", dynamic_cast<String^>(senderControl->Tag) );
   
   // Set the Help form to be owned by the main form. This helps
   // to ensure that the Help form is disposed of.
   this->AddOwnedForm( helpForm );
   
   // Show the custom Help window.
   helpForm->Show();
   
   // Indicate that the HelpRequested event is handled.
   hlpevent->Handled = true;
}
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
private DialogResult AlertMessageWithCustomHelpWindow ()
{
    // Handle the HelpRequested event for the following message.
    this.HelpRequested += new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    this.Tag = "Message with Help button.";

    // Show a message box with OK and Help buttons.
    DialogResult r = MessageBox.Show ("Message with Help button.", 
                                      "Help Caption", MessageBoxButtons.OK, 
                                      MessageBoxIcon.Question, 
                                      MessageBoxDefaultButton.Button1, 
                                      0, true);

    // Remove the HelpRequested event handler to keep the event
    // from being handled for other message boxes.
    this.HelpRequested -= new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    // Return the dialog box result.
    return r;
}

private void Form1_HelpRequested (System.Object sender, System.Windows.Forms.HelpEventArgs hlpevent)
{
    // Create a custom Help window in response to the HelpRequested event.
    Form helpForm = new Form ();

    // Set up the form position, size, and title caption.
    helpForm.StartPosition = FormStartPosition.Manual;
    helpForm.Size = new Size (200, 400);
    helpForm.DesktopLocation = new Point (this.DesktopBounds.X + 
                                          this.Size.Width, 
                                          this.DesktopBounds.Top);
    helpForm.Text = "Help Form";

    // Create a label to contain the Help text.
    Label helpLabel = new Label ();

    // Add the label to the form and set its text.
    helpForm.Controls.Add (helpLabel);
    helpLabel.Dock = DockStyle.Fill;

    // Use the sender parameter to identify the context of the Help request.
    // The parameter must be cast to the Control type to get the Tag property.
    Control senderControl = sender as Control;

    helpLabel.Text = "Help information shown in response to user action on the '" + 
                      (string)senderControl.Tag + "' message.";

    // Set the Help form to be owned by the main form. This helps
    // to ensure that the Help form is disposed of.
    this.AddOwnedForm (helpForm);

    // Show the custom Help window.
    helpForm.Show ();

    // Indicate that the HelpRequested event is handled.
    hlpevent.Handled = true;
}
' Display a message box with a Help button. Show a custom Help window
' by handling the HelpRequested event.
Private Function AlertMessageWithCustomHelpWindow() As DialogResult

    ' Handle the HelpRequested event for the following message.
    AddHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    Me.Tag = "Message with Help button."

    ' Show a message box with OK and Help buttons.
    Dim r As DialogResult = MessageBox.Show("Message with Help button.", _
                                          "Help Caption", MessageBoxButtons.OK, _
                                          MessageBoxIcon.Question, _
                                          MessageBoxDefaultButton.Button1, _
                                          0, True)

    ' Remove the HelpRequested event handler to keep the event
    ' from being handled for other message boxes.
    RemoveHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    ' Return the dialog box result.
    Return r
End Function

Private Sub Form1_HelpRequested(ByVal sender As System.Object, ByVal hlpevent As System.Windows.Forms.HelpEventArgs)

    ' Create a custom Help window in response to the HelpRequested event.
    Dim helpForm As Form = New Form

    ' Set up the form position, size, and title caption.
    With helpForm
        .StartPosition = FormStartPosition.Manual
        .Size = New Size(200, 400)
        .DesktopLocation = New Point(Me.DesktopBounds.X + _
                                     Me.Size.Width, Me.DesktopBounds.Top)
        .Text = "Help Form"
    End With

    ' Create a label to contain the Help text.
    Dim helpLabel As Label = New Label

    ' Add the label to the form and set its text.
    helpForm.Controls.Add(helpLabel)
    helpLabel.Dock = DockStyle.Fill

    ' Use the sender parameter to identify the context of the Help request.
    ' The parameter must be cast to the Control type to get the Tag property.
    Dim senderControl As Control = CType(sender, Control)

    helpLabel.Text = "Help information shown in response to user action on the '" & _
                      CStr(senderControl.Tag) & "' message."

    ' Set the Help form to be owned by the main form. This helps
    ' to ensure that the Help form is disposed of.
    Me.AddOwnedForm(helpForm)

    ' Show the custom Help window.
    helpForm.Show()

    ' Indicate that the HelpRequested event is handled.
    hlpevent.Handled = True
End Sub

Opmerkingen

Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden.

Wanneer de gebruiker op de knop Help klikt, ontvangt het formulier dat eigenaar is van het berichtvak (of het actieve formulier) de HelpRequested gebeurtenis. HelpRequested De gebeurtenis afhandelen om aangepaste Help-acties uit te voeren.

Zie ook

Van toepassing op

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand en HelpNavigator.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parameters

owner
IWin32Window

Een implementatie hiervan is de eigenaar van IWin32Window het modale dialoogvenster.

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

options
MessageBoxOptions

Een van de MessageBoxOptions waarden die aangeven welke weergave- en koppelingsopties worden gebruikt voor het berichtvak. U kunt 0 doorgeven als u de standaardinstellingen wilt gebruiken.

helpFilePath
String

Het pad en de naam van het Help-bestand dat moet worden weergegeven wanneer de gebruiker op de knop Help klikt.

navigator
HelpNavigator

Een van de HelpNavigator waarden.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

De defaultButton opgegeven is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

options DefaultDesktopOnly ServiceNotificationzowel als .

– of –

buttons een ongeldige combinatie van MessageBoxButtons.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een berichtvak weergeeft dat boven het hoofdvenster staat. In het berichtvak wordt een Help-knop weergegeven. Wanneer de gebruiker op de knop Help klikt, wordt het Mspaint.chm Help-bestand geopend en wordt het tabblad Help-index weergegeven. Voor het voorbeeld moet het Mspaint.chm Help-bestand zijn geïnstalleerd.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
System::Windows::Forms::DialogResult r4 = MessageBox::Show( this, "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
DialogResult r4 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file
' and shows the Help contents on the Index tab.
Dim r4 As DialogResult = MessageBox.Show(Me, _
                                      "Message with Help file and Help navigator.", _
                                      "Help Caption", MessageBoxButtons.OK, _
                                      MessageBoxIcon.Question, _
                                      MessageBoxDefaultButton.Button1, _
                                      0, "mspaint.chm", _
                                      HelpNavigator.Index)

Opmerkingen

Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden. U kunt de owner parameter gebruiken om een bepaald object op te geven, waarmee de IWin32Window interface wordt geïmplementeerd, die fungeert als het venster op het hoogste niveau en de eigenaar van het dialoogvenster.

Wanneer de gebruiker op de knop Help klikt, wordt het Help-bestand dat is opgegeven in de helpFilePath parameter geopend en wordt de Help-inhoud weergegeven die wordt geïdentificeerd door de navigator parameter. Het formulier dat eigenaar is van het berichtvak (of het actieve formulier) ontvangt ook de HelpRequested gebeurtenis.

Gecompileerde Help-bestanden bieden koppelingen naar inhoudsopgave, index, zoekopdrachten en trefwoordkoppelingen op pagina's. U kunt de volgende waarden gebruiken voor navigator: TableOfContents, Find, Indexof Topic.

De helpFilePath parameter kan van het formulier C:\path\sample.chm of /folder/file.htmzijn.

Zie ook

Van toepassing op

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer vóór het opgegeven object en met de opgegeven tekst, bijschrift, knoppen, pictogram en standaardknop.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parameters

owner
IWin32Window

Een implementatie hiervan is de eigenaar van IWin32Window het modale dialoogvenster.

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

defaultButton is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een MessageBox met de opties kunt weergeven die worden ondersteund door deze overbelasting van Show. Nadat u hebt gecontroleerd of een tekenreeksvariabele leeg is, ServerNamewordt in het voorbeeld een MessageBoxvoorbeeld weergegeven, zodat de gebruiker de optie heeft om de bewerking te annuleren. Als de retourwaarde van de Show methode wordt geëvalueerd Yes, wordt het formulier dat wordt MessageBox weergegeven gesloten.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Opmerkingen

U kunt de owner parameter gebruiken om een bepaald object op te geven, waarmee de IWin32Window interface wordt geïmplementeerd, die fungeert als het venster op het hoogste niveau en de eigenaar van het dialoogvenster. Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden.

U kunt maximaal drie knoppen in het berichtvak hebben.

Zie ook

Van toepassing op

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer vóór het opgegeven object en met de opgegeven tekst, bijschrift, knoppen en pictogram.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parameters

owner
IWin32Window

Een implementatie hiervan is de eigenaar van IWin32Window het modale dialoogvenster.

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een MessageBox met de opties kunt weergeven die worden ondersteund door deze overbelasting van Show. Nadat u hebt gecontroleerd of een tekenreeksvariabele leeg is, ServerNamewordt in het voorbeeld een MessageBoxvoorbeeld weergegeven, zodat de gebruiker de optie heeft om de bewerking te annuleren. Als de retourwaarde van de Show methode wordt geëvalueerd Yes, wordt het formulier dat wordt MessageBox weergegeven gesloten.

private:
   void validateUserEntry4()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry4()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry4()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Opmerkingen

U kunt de owner parameter gebruiken om een bepaald object op te geven, waarmee de IWin32Window interface wordt geïmplementeerd, die fungeert als het venster op het hoogste niveau en de eigenaar van het dialoogvenster. Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden.

U kunt maximaal drie knoppen in het berichtvak hebben.

Zie ook

Van toepassing op

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer met de opgegeven tekst, bijschrift, knoppen, pictogram en standaardknop.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show(string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show(string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parameters

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

defaultButton is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een MessageBox met de opties kunt weergeven die worden ondersteund door deze overbelasting van Show. Nadat u hebt gecontroleerd of een tekenreeksvariabele leeg is, ServerNamewordt in het voorbeeld een MessageBox pictogram met een vraagvak weergegeven, zodat de gebruiker de optie heeft om de bewerking te annuleren. Als de retourwaarde van de Show methode wordt geëvalueerd Yes, wordt het formulier dat wordt MessageBox weergegeven gesloten.

private:
   void validateUserEntry3()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1 );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry3()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
        MessageBoxIcon.Question, MessageBoxDefaultButton.Button1);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry3()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question, _
            MessageBoxDefaultButton.Button1)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If
End Sub

Opmerkingen

U kunt maximaal drie knoppen in het berichtvak hebben.

Zie ook

Van toepassing op

Show(IWin32Window, String, String, MessageBoxButtons)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer vóór het opgegeven object en met de opgegeven tekst, bijschrift en knoppen.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parameters

owner
IWin32Window

Een implementatie hiervan is de eigenaar van IWin32Window het modale dialoogvenster.

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een MessageBox met de opties kunt weergeven die worden ondersteund door deze overbelasting van Show. Nadat u hebt gecontroleerd of een tekenreeksvariabele leeg is, ServerNamewordt in het voorbeeld een MessageBoxvoorbeeld weergegeven, zodat de gebruiker de optie heeft om de bewerking te annuleren. Als de retourwaarde van de Show methode wordt geëvalueerd Yes, wordt het formulier dat wordt MessageBox weergegeven gesloten.

private:
   void validateUserEntry5()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry5()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry5()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Opmerkingen

U kunt de owner parameter gebruiken om een bepaald object op te geven, waarmee de IWin32Window interface wordt geïmplementeerd, die fungeert als het venster op het hoogste niveau en de eigenaar van het dialoogvenster. Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden.

U kunt maximaal drie knoppen in het berichtvak hebben.

Zie ook

Van toepassing op

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Hiermee wordt een berichtvak met opgegeven tekst, bijschrift, knoppen en pictogram weergegeven.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show(string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show(string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parameters

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

De buttons opgegeven parameter is geen lid van MessageBoxButtons.

– of –

De icon opgegeven parameter is geen lid van MessageBoxIcon.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

Voorbeelden

In het volgende codevoorbeeld ziet u een van de methoden bij het Show verwerken van de ComboBox.DropDown gebeurtenis. Als u het voorbeeld wilt uitvoeren, plakt u de volgende code in een formulier en roept u de InitializeComboBox methode aan vanuit de constructor of Load methode van het formulier.

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^ e )
   {
      MessageBox::Show( "Typical installation is strongly recommended.",
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }

// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128, 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100, 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text	= "Typical";
    string[] installs = new string[]{"Typical", "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}

' Declare ComboBox1.
Friend WithEvents ComboBox1 As System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128, 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100, 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String = New String() _
        {"Typical", "Compact", "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object, ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.", _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

Opmerkingen

U kunt maximaal drie knoppen in het berichtvak hebben.

Zie ook

Van toepassing op

Show(IWin32Window, String, String)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer vóór het opgegeven object en met de opgegeven tekst en bijschrift.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window owner, string text, string caption);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window? owner, string? text, string? caption);
static member Show : System.Windows.Forms.IWin32Window * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String) As DialogResult

Parameters

owner
IWin32Window

Een implementatie hiervan is de eigenaar van IWin32Window het modale dialoogvenster.

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

Retouren

Een van de DialogResult waarden.

Opmerkingen

U kunt de owner parameter gebruiken om een bepaald object op te geven, waarmee de IWin32Window interface wordt geïmplementeerd, die fungeert als het venster op het hoogste niveau en de eigenaar van het dialoogvenster. Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden.

Standaard wordt in het berichtvak een knop OK weergegeven.

Van toepassing op

Show(String, String, MessageBoxButtons)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Hiermee wordt een berichtvak met opgegeven tekst, bijschrift en knoppen weergegeven.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show(string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show(string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parameters

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

De buttons opgegeven parameter is geen lid van MessageBoxButtons.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een MessageBox met de opties kunt weergeven die worden ondersteund door deze overbelasting van Show. Nadat u hebt gecontroleerd of een tekenreeksvariabele leeg is, ServerNamewordt in het voorbeeld een MessageBoxvoorbeeld weergegeven, zodat de gebruiker de optie heeft om de bewerking te annuleren. Als de retourwaarde van de Show methode wordt geëvalueerd Yes, wordt het formulier dat wordt MessageBox weergegeven gesloten.

private:
   void validateUserEntry()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry()
{
    // Checks the value of the text.
    if(serverName.Text.Length == 0)
    {
        // Initializes the variables to pass to the MessageBox.Show method.
        string message = "You did not enter a server name. Cancel this operation?";
     string caption = "Error Detected in Input";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.
        result = MessageBox.Show(message, caption, buttons);
        if (result == System.Windows.Forms.DialogResult.Yes)
        {
            // Closes the parent form.
            this.Close();
        }
    }
}
Private Sub ValidateUserEntry()
    ' Checks the value of the text.
    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.
        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "Error Detected in Input"
        Dim Buttons As MessageBoxButtons = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays the MessageBox
        Result = MessageBox.Show(Message, Caption, Buttons)

        ' Gets the result of the MessageBox display.
        If Result = System.Windows.Forms.DialogResult.Yes Then
            ' Closes the parent form.
            Me.Close()
        End If
    End If
End Sub

Opmerkingen

U kunt maximaal drie knoppen in het berichtvak hebben.

Zie ook

Van toepassing op

Show(IWin32Window, String)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer vóór het opgegeven object en met de opgegeven tekst.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window owner, string text);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window? owner, string? text);
static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

Parameters

owner
IWin32Window

Een implementatie hiervan is de eigenaar van IWin32Window het modale dialoogvenster.

text
String

De tekst die moet worden weergegeven in het berichtvak.

Retouren

Een van de DialogResult waarden.

Opmerkingen

U kunt de owner parameter gebruiken om een bepaald object op te geven, waarmee de IWin32Window interface wordt geïmplementeerd, die fungeert als het venster op het hoogste niveau en de eigenaar van het dialoogvenster. Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden.

Standaard wordt in het berichtvak een knop OK weergegeven. Het berichtvak bevat geen bijschrift in de titel.

Van toepassing op

Show(String, String)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer met opgegeven tekst en bijschrift.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show(string text, string caption);
public static System.Windows.Forms.DialogResult Show(string? text, string? caption);
static member Show : string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String) As DialogResult

Parameters

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

Retouren

Een van de DialogResult waarden.

Opmerkingen

Standaard wordt in het berichtvak een knop OK weergegeven.

Van toepassing op

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer met de opgegeven tekst, bijschrift, knoppen, pictogram, standaardknop en opties.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show(string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show(string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parameters

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

options
MessageBoxOptions

Een van de MessageBoxOptions waarden die aangeven welke weergave- en koppelingsopties worden gebruikt voor het berichtvak. U kunt 0 doorgeven als u de standaardinstellingen wilt gebruiken.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

De defaultButton opgegeven is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

options DefaultDesktopOnly ServiceNotificationzowel als .

– of –

buttons een ongeldige combinatie van MessageBoxButtons.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een MessageBox met de opties kunt weergeven die worden ondersteund door deze overbelasting van Show. Nadat u hebt gecontroleerd of een tekenreeksvariabele leeg is, ServerNamewordt in het voorbeeld een MessageBox pictogram met een vraagvak weergegeven, zodat de gebruiker de optie heeft om de bewerking te annuleren. In het voorbeeld wordt het RightAlign lid van de MessageBoxOptions opsomming gebruikt om de tekst uit te lijnen op de rechterrand van het dialoogvenster. Als de retourwaarde van de Show methode wordt geëvalueerd Yes, wordt het formulier dat wordt MessageBox weergegeven gesloten.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Opmerkingen

U kunt maximaal drie knoppen in het berichtvak hebben.

Zie ook

Van toepassing op

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs
Bron:
MessageBox.cs

Geeft een berichtvak weer met de opgegeven tekst, bijschriften, knoppen, pictogram, standaardknop, opties en Help-knop, met behulp van het opgegeven Help-bestand en HelpNavigatorHelp-onderwerp.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
public static System.Windows.Forms.DialogResult Show(System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parameters

owner
IWin32Window

Een implementatie hiervan is de eigenaar van IWin32Window het modale dialoogvenster.

text
String

De tekst die moet worden weergegeven in het berichtvak.

caption
String

De tekst die moet worden weergegeven op de titelbalk van het berichtvak.

buttons
MessageBoxButtons

Een van de MessageBoxButtons waarden die aangeeft welke knoppen moeten worden weergegeven in het berichtvak.

icon
MessageBoxIcon

Een van de MessageBoxIcon waarden die aangeeft welk pictogram moet worden weergegeven in het berichtvak.

defaultButton
MessageBoxDefaultButton

Een van de MessageBoxDefaultButton waarden waarmee de standaardknop voor het berichtvak wordt opgegeven.

options
MessageBoxOptions

Een van de MessageBoxOptions waarden die aangeven welke weergave- en koppelingsopties worden gebruikt voor het berichtvak. U kunt 0 doorgeven als u de standaardinstellingen wilt gebruiken.

helpFilePath
String

Het pad en de naam van het Help-bestand dat moet worden weergegeven wanneer de gebruiker op de knop Help klikt.

navigator
HelpNavigator

Een van de HelpNavigator waarden.

param
Object

De numerieke id van het Help-onderwerp dat moet worden weergegeven wanneer de gebruiker op de knop Help klikt.

Retouren

Een van de DialogResult waarden.

Uitzonderingen

buttons is geen lid van MessageBoxButtons.

– of –

icon is geen lid van MessageBoxIcon.

– of –

De defaultButton opgegeven is geen lid van MessageBoxDefaultButton.

Er is een poging gedaan om het MessageBox in een proces weer te geven dat niet wordt uitgevoerd in de interactieve modus van gebruiker. Dit wordt opgegeven door de UserInteractive eigenschap.

options DefaultDesktopOnly ServiceNotificationzowel als .

– of –

buttons een ongeldige combinatie van MessageBoxButtons.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een berichtvak weergeeft dat boven het hoofdvenster staat. In het berichtvak wordt een Help-knop weergegeven. Wanneer de gebruiker op de knop Help klikt, wordt het Mspaint.chm Help-bestand geopend en wordt het tabblad Help-index en het onderwerp dat door het ovals trefwoord wordt geïdentificeerd, weergegeven. Voor het voorbeeld moet het Mspaint.chm Help-bestand zijn geïnstalleerd.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r6 = MessageBox::Show( this, "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r6 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r6 As DialogResult = MessageBox.Show(Me, _
                                   "Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Opmerkingen

Een berichtvak is een modaal dialoogvenster, wat betekent dat er geen invoer (toetsenbord of muisklik) kan optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan plaatsvinden. U kunt de owner parameter gebruiken om een bepaald object op te geven, waarmee de IWin32Window interface wordt geïmplementeerd, die fungeert als het venster op het hoogste niveau en de eigenaar van het dialoogvenster.

Wanneer de gebruiker op de knop Help klikt, wordt het Help-bestand dat is opgegeven in de helpFilePath parameter geopend en wordt de Help-inhoud weergegeven die wordt geïdentificeerd door de navigator parameter. Het formulier dat eigenaar is van het berichtvak (of het actieve formulier) ontvangt ook de HelpRequested gebeurtenis.

Gecompileerde Help-bestanden bieden koppelingen naar inhoudsopgave, index, zoekopdrachten en trefwoordkoppelingen op pagina's. U kunt de volgende waarden gebruiken voor navigator: TableOfContents, Find, Indexof Topic.

U kunt de param opdracht verder verfijnen Topic . Als de waarde die is opgegeven in de navigator parameter , TableOfContentsIndexof Find, moet deze waarde zijn null. Als de navigator parameterverwijzingen Topicverwijzen, moet deze waarde verwijzen naar een object dat de numerieke waarde van het onderwerp bevat die moet worden weergegeven.

De helpFilePath parameter kan van het formulier C:\path\sample.chm of /folder/file.htmzijn.

Zie ook

Van toepassing op