Metodo IDeviceControl2::ActivateAtPosition (strmif.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il ActivateAtPosition metodo attiva il pulsante del menu sotto la posizione del puntatore del mouse.
Sintassi
HRESULT ActivateAtPosition(
[in] POINT point
);
Parametri
[in] point
Puntare nell'area della finestra client, nelle coordinate pixel dello schermo.
Valore restituito
Restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Il clic si è verificato nel rettangolo del pulsante evidenziato e il pulsante è stato attivato correttamente. |
|
Il punto si trova all'esterno dell'area video valida. |
|
Il pulsante è presente ma non funziona. |
|
Il navigatore DVD non è in un dominio di menu. |
|
Non c'è alcun pulsante di menu sotto la posizione del puntatore del mouse. |
|
L'operazione è inibita dal controllo UOP (User Operation). |
Commenti
Le coordinate del puntatore del mouse sono relative alla parte superiore sinistra dell'area client, che non è necessariamente l'area di visualizzazione video se il video è in formato letterabox.
Usare questo metodo quando l'utente passa attraverso un menu spostando il puntatore del mouse direttamente sui pulsanti di menu. Se l'utente usa i pulsanti relativi per spostarsi nel menu, usare ActivateButton anziché ActivateAtPosition.
Nella tabella seguente viene illustrato il nome del comando Allegato J a cui corrisponde il nome del metodo e i domini in cui questo metodo è valido.
| Nome comando J allegato | Domini validi |
| Nessuno |
|
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |
| Libreria | Strmiids.lib |
Vedi anche
Codici errore e esito positivo