Share via

Método IDockingWindow::ResizeBorderDW (shobjidl_core.h)

  • Artículo

Notifica al objeto de ventana de acoplamiento que ha cambiado el espacio de borde del marco. En respuesta a este método, la implementación de IDockingWindow debe llamar a SetBorderSpaceDW, incluso si no se requiere ningún espacio de borde o no es necesario un cambio.

Sintaxis

HRESULT ResizeBorderDW(
  LPCRECT  prcBorder,
  IUnknown *punkToolbarSite,
  BOOL     fReserved
);

Parámetros

prcBorder

Tipo: LPCRECT

Puntero a una estructura RECT que contiene el espacio de borde disponible del marco.

punkToolbarSite

Tipo: IUnknown*

Puntero a la interfaz IUnknown del sitio. El objeto de ventana de acoplamiento debe llamar al método QueryInterface para esta interfaz, solicitando IID_IDockingWindowSite. Después, el objeto de ventana de acoplamiento usa esa interfaz para negociar su espacio de bordes. Es responsabilidad del objeto de ventana de acoplamiento liberar esta interfaz cuando ya no sea necesario.

fReserved

Tipo: BOOL

Reservado. Este parámetro siempre debe ser cero.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El parámetro prcBorder contiene todo el espacio de borde disponible del marco. El objeto de ventana de acoplamiento debe negociar su espacio de borde y, a continuación, usar esta información para colocarse a sí mismo.

Por ejemplo, si el objeto de ventana de acoplamiento requiere 25 píxeles en la parte superior del espacio de borde, debe negociar para ello mediante los pasos siguientes:

  1. Asigne una estructura BORDERWIDTHS y establezca su miembro superior en 25.
  2. Llame a RequestBorderSpaceDW para solicitar el espacio.
  3. Si RequestBorderSpaceDW aprueba la solicitud, llame a SetBorderSpaceDW para asignar el espacio.
Después, el objeto de ventana de acoplamiento puede colocar su ventana en prcBorder-left> y prcBorder-top>. El ancho de la ventana del objeto de ventana de acoplamiento se determina restando prcBorder-left de prcBorder-right>>. Su alto se encuentra en el miembro superior de la estructura BORDERWIDTHS .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shlobj.h)
Archivo DLL Shell32.dll (versión 4.71 o posterior)

Consulte también

IDeskBand

IDockingWindow

IDockingWindowFrame

IDockingWindowSite