Control.IsMnemonic メソッド

  • [アーティクル]

指定した文字が、指定した文字列内のコントロールに割り当てられたニーモニック文字かどうかを確認します。

Public Shared Function IsMnemonic( _
   ByVal charCode As Char, _   ByVal text As String _) As Boolean
[C#]
public static bool IsMnemonic(charcharCode,stringtext);
[C++]
public: static bool IsMnemonic(__wchar_tcharCode,String* text);
[JScript]
public static function IsMnemonic(
   charCode : Char,text : String) : Boolean;

パラメータ

  • charCode
    テスト対象の文字。
  • text
    検索対象の文字列。

戻り値

charCode 文字が、コントロールに割り当てられたニーモニック文字である場合は true 。それ以外の場合は false 。

解説

ニーモニック文字は、 String 内の最初の "&" のインスタンスの直後の文字です。

使用例

[Visual Basic, C#] ProcessMnemonic メソッドをオーバーライドするボタン クラスを拡張し、カスタム動作を示す方法を次のコード例に示します。また、この例では、 CanSelect プロパティと IsMnemonic プロパティも使用しています。この例を実行するには、次のコードを、同じファイル内のフォーム クラスの後に貼り付けます。そして、MnemonicButton 型のボタンをフォームに追加します。

 
' This button is a simple extension of the button class that overrides
' the ProcessMnemonic method.  If the mnemonic is correctly entered,  
' the message box will appear and the click event will be raised.  
Public Class MyMnemonicButton
    Inherits Button

    ' This method makes sure the control is selectable and the 
    ' mneumonic is correct before displaying the message box
    ' and triggering the click event.
    Protected Overrides Function ProcessMnemonic( _
        ByVal inputChar As Char) As Boolean

        If (CanSelect And IsMnemonic(inputChar, Me.Text)) Then
            MessageBox.Show("You've raised the click event " _
                & "using the mnemonic.")
            Me.PerformClick()
            Return True
        End If
        Return False
    End Function

End Class

[C#] 
// This button is a simple extension of the button class that overrides
// the ProcessMnemonic method.  If the mnemonic is correctly entered,  
// the message box will appear and the click event will be raised.  
public class MyMnemonicButton:
    Button

    // This method makes sure the control is selectable and the 
    // mneumonic is correct before displaying the message box
    // and triggering the click event.
{
    protected override bool ProcessMnemonic(char inputChar)
    {

        if (CanSelect&&IsMnemonic(inputChar, this.Text))
        {
            MessageBox.Show("You've raised the click event " +
                "using the mnemonic.");
            this.PerformClick();
            return true;
        }
        return false;
    }

}

[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 ファミリ

.NET Framework セキュリティ:

参照

Control クラス | Control メンバ | System.Windows.Forms 名前空間 | ProcessMnemonic