<Return[G]><Top>

GetMenuDefaultItem

Declare Function Api_GetMenuDefaultItem& Lib "user32" Alias "GetMenuDefaultItem" (ByVal hMenu&, ByVal fByPos&, ByVal gmdiFlags&)

Declare Function GetMenuDefaultItem Lib "user32" (ByVal hMenu As Long, ByVal fByPos As Long, ByVal gmdiFlags As Long)

指定されたメニューの既定のメニュー項目を調べる。

パラメータ
hMenu
    1 つのメニューのハンドルを指定する。このメニューの既定のメニュー項目を取得する。
fByPos
    既定のメニュー項目の識別子と位置のどちらを取得するかを指定する。

    FALSE(0)を指定すると、識別子が返る。それ以外の値を指定すると、位置が返る。
gmdiFlags
    メニュー項目の検索方法を指定する。0 または次の値の任意の組み合わせを指定する。

    値                                     

意味                                                                                                                                  

    GMDI_GOINTOPOPUPS

既定のメニュー項目がサブメニューを開く場合、対応するサブメニューの中も再帰的に検索する。

 

そのサブメニューに既定のメニュー項目がない場合、戻り値は、そのサブメニューを開くメニュー項目(つま

 

 り、最初に見つかった既定のメニュー項目)である。

 

既定では(つまり GMDI_GOINTPOPUPS フラグを指定しない場合)、サブメニューを開くかどうかにかか

 

わりなく、指定されたメニューの最初の既定の項目を返す。

    GMDI_USEDISABLED

無効のメニュー項目も検索対象とする。

    デフォルト既定では、この関数は無効や淡色表示のメニュー項目を検索対象としない。

戻り値
    関数が成功すると、メニュー項目の識別子または位置が返る。
    関数が失敗すると、-1 が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。