Compartir a través de

Método IOleInPlaceSiteWindowless::SetFocus (ocidl.h)

  • Artículo

Establece el foco del teclado para un objeto activo de la interfaz de usuario sin ventana.

Sintaxis

HRESULT SetFocus(
  [in] BOOL fFocus
);

Parámetros

[in] fFocus

Si es TRUE, establece el foco del teclado en el objeto que llama. Si es FALSE, quita el foco del teclado del objeto que llama, siempre que el objeto tenga el foco.

Valor devuelto

Este método devuelve S_OK si el foco del teclado se ha dado correctamente al objeto . Si se llama a este método para liberar el foco, nunca deben producirse errores. Otros posibles valores devueltos son los siguientes.

Código devuelto Descripción
S_FALSE
 El foco de teclado se denegó al objeto.

Comentarios

Un objeto sin ventana llama a este método cada vez que un objeto con ventana llamaría a la función SetFocus . A través de esta llamada, el objeto sin ventanas obtiene el foco del teclado y puede responder a los mensajes de la ventana. Normalmente, esta llamada se realiza durante el proceso de activación de la interfaz de usuario y dentro de los métodos de notificación IOleInPlaceActiveObject::OnDocWindowActivate con TRUE e IOleInPlaceActiveObject::OnFrameWindowActivate con TRUE.

En respuesta a esta llamada, el contenedor establece el foco de Windows en la ventana que se usa para obtener mensajes de teclado (normalmente la ventana contenedora) y redirige los mensajes de teclado posteriores al objeto sin ventana que solicitó el foco.

Un objeto sin ventanas también llama al método IOleInPlaceSiteWindowless::SetFocus con el parámetro fFocus establecido en FALSE para liberar el foco del teclado sin asignarlo a ningún otro objeto. En este caso, el contenedor debe llamar a la función SetFocus con un parámetro NULL para que ninguna ventana tenga el foco.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ocidl.h

Consulte también

IOleInPlaceActiveObject

IOleInPlaceSiteWindowless