IDvdControl2::ActivateAtPosition メソッド (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
メソッドは ActivateAtPosition
、マウス ポインターの位置の下にあるメニュー ボタンをアクティブにします。
構文
HRESULT ActivateAtPosition(
[in] POINT point
);
パラメーター
[in] point
画面のピクセル座標で、クライアント ウィンドウ領域をポイントします。
戻り値
次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
強調表示されたボタンの四角形でクリックが発生し、ボタンが正常にアクティブ化されました。 |
|
ポイントは、有効なビデオ領域の外側にあります。 |
|
ボタンは存在しますが、機能していません。 |
|
DVD ナビゲーターがメニュー ドメインにありません。 |
|
マウス ポインターの位置の下にメニュー ボタンはありません。 |
|
操作は、ユーザー操作 (UOP) コントロールによって禁止されます。 |
注釈
マウス ポインターの座標は、クライアント領域の左上を基準にしています。これは、ビデオがレターボックス形式の場合は必ずしもビデオ表示領域ではありません。
マウス ポインターをメニュー ボタンの上に直接移動して、ユーザーがメニュー内を移動する場合は、このメソッドを使用します。 ユーザーが相対ボタンを使用してメニュー内を移動する場合は、 ではなく ActivateAtPosition
ActivateButton を使用します。
次の表は、このメソッド名が対応する Annex J コマンド名と、このメソッドが有効なドメインを示しています。
Annex J コマンド名 | 有効なドメイン |
なし |
|
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | strmif.h (Dshow.h を含む) |
Library | Strmiids.lib |