Metodo IOleInPlaceSiteWindowless::OnDefWindowMessage (ocidl.h)

Articolo
08/25/2023

Richiama l'elaborazione predefinita per tutti i messaggi passati a un oggetto.

Sintassi

HRESULT OnDefWindowMessage(
  [in]  UINT    msg,
  [in]  WPARAM  wParam,
  [in]  LPARAM  lParam,
  [out] LRESULT *plResult
);

Parametri

[in] msg

Identificatore del messaggio della finestra fornito al contenitore da Windows.

[in] wParam

Parametro per il messaggio della finestra fornito al contenitore da Windows.

[in] lParam

Parametro per il messaggio della finestra fornito al contenitore da Windows.

[out] plResult

Puntatore al codice di risultato per il messaggio della finestra.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
S_FALSE	L'elaborazione predefinita del contenitore per il messaggio della finestra non è stata richiamata. Vedere la nota per gli implementatori di seguito.

Commenti

Un oggetto senza finestra può richiamare in modo esplicito l'elaborazione predefinita per un messaggio di finestra chiamando questo metodo. Un contenitore invia messaggi finestra ai relativi oggetti senza finestra chiamando IOleInPlaceObjectWindowless::OnWindowMessage. L'oggetto restituisce in genere S_FALSE per indicare che non ha elaborato il messaggio. Il contenitore può quindi eseguire il comportamento predefinito per il messaggio chiamando la funzione DefWindowProc .

L'oggetto può invece chiamare questo metodo sull'oggetto sito del contenitore per richiamare in modo esplicito l'elaborazione predefinita. L'oggetto può quindi intervenire autonomamente se il contenitore non gestisce il messaggio.

Note per gli implementatori

Il contenitore deve passare i messaggi della finestra seguenti alla relativa routine di finestra predefinita (funzione DefWindowProc ) e restituire S_OK. Si noti che *plResult deve contenere il valore restituito da DefWindowProc.

WM_CHAR
WM_DEADCHAR
WM_IMExxx
WM_KEYDOWN
WM_KEYUP
WM_MOUSEMOVE
WM_SYSCHAR
WM_SYSDEADCHAR
WM_SYSKEYUP
WM_XBUTTONDOWN
WM_XBUTTONUP
WM_XBUTTONDBLCLK

Il contenitore può elaborare i messaggi della finestra come propri e restituire S_OK o non eseguire alcuna operazione e restituire S_FALSE.

WM_CONTEXTMENU
WM_HELP
WM_SETCURSOR

Se il contenitore restituisce S_FALSE, l'oggetto può intervenire per elaborare il messaggio della finestra autonomamente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

IOleInPlaceObjectWindowless::OnWindowMessage

IOleInPlaceSiteWindowless

Condividi tramite