<Return[G]><Top>

GetProp

Declare Function Api_GetProp& Lib "user32" Alias "GetPropA" (ByVal hWnd&, ByVal lpString$)

Declare Function GetProp Lib "user32" Alias "GetPropA" (ByVal hwnd As Long, ByVal lpString As String) As Long

指定されたウィンドウのプロパティリストからデータハンドルを取得する。指定された文字列は、取得するべきハンドルを識別する。あらかじめ SetProp 関数を呼び出して、この文字列とハンドルをプロパティリストに追加しておかなければならない。

パラメータ
hWnd
    検索するべきプロパティリストを保持しているウィンドウのハンドルを指定する。
lpString
    NULL 文字で終わる文字列へのポインタ、または文字列を識別する 1 個のアトムを指定する。

    アトムを指定する場合、GlobalAddAtom 関数で作成したグローバルアトムを指定しなければならない。

    このアトムは 16 ビット値なので、lpString パラメータの下位ワード(low-order word)でアトムを指定し、上位ワード(high-order word)

    で 0 を指定する。
 

戻り値
    指定された文字列がプロパティリスト内に存在する場合、その文字列に関連付けられているデータハンドルが返る。

    それ以外の場合、NULL が返る。