次の方法で共有

CommonDialog.HelpRequest イベント

ユーザーがコモン ダイアログ ボックスの [?] ボタンをクリックすると発生します。

Public Event HelpRequest As EventHandler
[C#]
public event EventHandler HelpRequest;
[C++]
public: __event EventHandler* HelpRequest;

[JScript] JScript では、このクラスで定義されているイベントを処理できます。ただし、独自に定義することはできません。

イベント データ

イベント ハンドラが EventArgs 型の引数を受け取りました。

解説

イベント処理の詳細については、「 イベントの利用 」を参照してください。

使用例

[Visual Basic, C#] 次に示すのは、 ShowHelp プロパティの設定方法と、ColorDialog の HelpRequest イベントの処理方法を示すコード例です。この例を実行するには、次のコードをフォームに貼り付けて、フォームのコンストラクタまたは Load メソッドで InitializeColorDialog メソッドを呼び出します。この例は、ボタンの Click イベントが、この例で定義されているイベント処理メソッドに関連付けられていることを前提としています。

 

' This method initializes ColorDialog1 to allow any colors, 
' and combination colors on systems with 256 colors or less, 
' but will not allow the user to set custom colors.  The
' dialog will contain the help button.
Private Sub InitializeColorDialog()
    Me.ColorDialog1 = New System.Windows.Forms.ColorDialog
    Me.ColorDialog1.AllowFullOpen = False
    Me.ColorDialog1.AnyColor = True
    Me.ColorDialog1.SolidColorOnly = False
    Me.ColorDialog1.ShowHelp = True
End Sub
  

' This method opens the dialog and checks the DialogResult value. 
' If the result is OK, the text box's background color will be changed 
' to the user-selected color.
Private Sub Button1_Click(ByVal sender As System.Object,  _
    ByVal e As System.EventArgs) Handles Button1.Click
    Dim result As DialogResult = ColorDialog1.ShowDialog()
    If (result.Equals(DialogResult.OK)) Then
        TextBox1.BackColor = ColorDialog1.Color
    End If
End Sub
 
  
' This method is called when the HelpRequest event is raised, 
'which occurs when the user clicks the Help button on the ColorDialog object.
Private Sub ColorDialog1_HelpRequest(ByVal sender As Object, _ 
    ByVal e As System.EventArgs) Handles ColorDialog1.HelpRequest

    MessageBox.Show("Please select a color by clicking it." _
    & "This will change the BackColor property of the TextBox.")
End Sub

[C#] 
// This method initializes ColorDialog1 to allow any colors, 
// and combination colors on systems with 256 colors or less, 
// but will not allow the user to set custom colors.  The
// dialog will contain the help button.
private void InitializeColorDialog()
{
    this.ColorDialog1 = new System.Windows.Forms.ColorDialog();
    this.ColorDialog1.AllowFullOpen = false;
    this.ColorDialog1.AnyColor = true;
    this.ColorDialog1.SolidColorOnly = false;
    this.ColorDialog1.ShowHelp = true;
    
    // Associate the event-handling method with
    // the HelpRequest event.
    this.ColorDialog1.HelpRequest 
        += new System.EventHandler(ColorDialog1_HelpRequest);
}


// This method opens the dialog and checks the DialogResult value. 
// If the result is OK, the text box's background color will be changed 
// to the user-selected color.
private void Button1_Click(System.Object sender, System.EventArgs e)
{
    DialogResult result = ColorDialog1.ShowDialog();
    if (result.Equals(DialogResult.OK))
    {
        TextBox1.BackColor = ColorDialog1.Color;
    }
}

// This method is called when the HelpRequest event is raised, 
//which occurs when the user clicks the Help button on the ColorDialog object.
private void ColorDialog1_HelpRequest(object sender, System.EventArgs e)
{

    MessageBox.Show("Please select a color by clicking it. "
       + "This will change the BackColor property of the TextBox.");
}

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

CommonDialog クラス | CommonDialog メンバ | System.Windows.Forms 名前空間 | OnHelpRequest

  • Last updated on