CommonDialog.HelpRequest CommonDialog.HelpRequest CommonDialog.HelpRequest CommonDialog.HelpRequest Event

定義

ユーザーがコモン ダイアログ ボックスの [?] ボタンをクリックすると発生します。Occurs when the user clicks the Help button on a common dialog box.

public:
 event EventHandler ^ HelpRequest;
public event EventHandler HelpRequest;
member this.HelpRequest : EventHandler 
Public Custom Event HelpRequest As EventHandler 

次のコード例は、プロパティColorDialogAnyColor設定するオブジェクトAllowFullOpenを初期化する方法を示しています。The following code example demonstrates initializing a ColorDialog object setting the AnyColor, AllowFullOpen properties. オブジェクトColorDialogでは、ユーザーがカスタム色を設定することを許可していませんが、基本的な色の完全なセットを表示することができます。The ColorDialog object does not allow the user to set a custom color, but it allows the full set of basic colors to be displayed. このSolidColorOnlyプロパティを false に設定すると、256以下の色で、システム上の他の色の組み合わせである色を表示できます。By setting the SolidColorOnly property to false, it allows the display of colors that are combinations of other colors on systems with 256 or less colors. また、この例ではShowHelp 、ダイアログボックスのHelpRequestプロパティを設定し、イベントを処理する方法も示しています。The example also shows setting the ShowHelp property and handling a HelpRequest event for a dialog box. この例を実行するには、フォームに次のコードを貼りInitializeColorDialog付け、フォームのコンストラクターまたはLoadメソッドでメソッドを呼び出します。To run the example, paste the following code in a form and call the InitializeColorDialog method in the form's constructor or Load method. この例では、 Clickボタンのイベントが、この例で定義されているイベントハンドラーに接続されている必要があります。This example requires that the Click event of the button is connected to the event handler defined in the example.

// 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.
void InitializeColorDialog()
{
   this->ColorDialog1 = gcnew 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 +=
      gcnew System::EventHandler( this, &Form1::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.
void Button1_Click( System::Object^ sender, System::EventArgs^ e )
{
   ::DialogResult result = ColorDialog1->ShowDialog();
   if ( result == ::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.
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." );
}
// 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.");
}

' 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

注釈

イベントの処理の詳細については、「イベントの処理と発生」を参照してください。For information about handling events, see Handling and Raising Events.

適用対象

こちらもご覧ください