Método IOleObject::SetHostNames (oleidl.h)

  • Artículo

Proporciona un objeto con los nombres de su aplicación contenedora y el documento compuesto en el que está incrustado.

Sintaxis

HRESULT SetHostNames(
  [in] LPCOLESTR szContainerApp,
  [in] LPCOLESTR szContainerObj
);

Parámetros

[in] szContainerApp

Puntero al nombre de la aplicación contenedora en la que se está ejecutando el objeto.

[in] szContainerObj

Puntero al nombre del documento compuesto que contiene el objeto. Si no desea mostrar el nombre del documento compuesto, puede establecer este parámetro en NULL.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente.

Comentarios

Notas de los autores de llamadas

Llame a IOleObject::SetHostNames solo para objetos incrustados, ya que para los objetos vinculados, el origen del vínculo proporciona su propia información de la ventana de edición y la barra de título independientes.

Notas para los implementadores

La aplicación de un objeto de IOleObject::SetHostNames debe incluir cualquier modificación en su interfaz de usuario que sea adecuada para el estado incrustado de un objeto. Estas modificaciones normalmente incluirán la adición y eliminación de comandos de menú y la modificación del texto mostrado en la barra de título de la ventana de edición.

El título de la ventana completa de un objeto incrustado en una aplicación contenedora SDI o una aplicación MDI con una ventana secundaria maximizada debe aparecer de la siguiente manera:

<object application name> - <object short type> in <container document>

De lo contrario, el título debe ser:

<object application name> - <container document>

El "tipo corto de objeto" hace referencia a una forma del nombre de un objeto lo suficientemente corto como para mostrarse en su totalidad en un cuadro de lista. Dado que estas cadenas de identificación no se almacenan como parte del estado persistente del objeto, se debe llamar a IOleObject::SetHostNames cada vez que se carga o ejecuta el objeto.

Requisitos

Requisito Value
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 oleidl.h

Consulte también

IOleObject

IOleObject::GetUserType