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

  • Artigo

Notifica o objeto da janela de encaixe de que o espaço de borda do quadro foi alterado. Em resposta a esse método, a implementação de IDockingWindow deve chamar SetBorderSpaceDW, mesmo que nenhum espaço de borda seja necessário ou uma alteração não seja necessária.

Sintaxe

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

Parâmetros

prcBorder

Tipo: LPCRECT

Ponteiro para uma estrutura RECT que contém o espaço de borda disponível do quadro.

punkToolbarSite

Tipo: IUnknown*

Ponteiro para a interface IUnknown do site. O objeto de janela de encaixe deve chamar o método QueryInterface para essa interface, solicitando IID_IDockingWindowSite. Em seguida, o objeto da janela de encaixe usa essa interface para negociar seu espaço de borda. É responsabilidade do objeto da janela de encaixe liberar essa interface quando ela não for mais necessária.

fReserved

Tipo: BOOL

Reservado. Esse parâmetro sempre deve ser zero.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O parâmetro prcBorder contém todo o espaço de borda disponível do quadro. O objeto da janela de encaixe deve negociar seu espaço de borda e, em seguida, usar essas informações para se posicionar.

Por exemplo, se o objeto da janela de encaixe exigir 25 pixels na parte superior do espaço da borda, ele deverá negociar para isso por meio das seguintes etapas:

  1. Aloque uma estrutura BORDERWIDTHS e defina seu membro superior como 25.
  2. Chame RequestBorderSpaceDW para solicitar o espaço.
  3. Se a solicitação for aprovada por RequestBorderSpaceDW, chame SetBorderSpaceDW para alocar o espaço.
O objeto da janela de encaixe pode posicionar sua janela em prcBorder-left> e prcBorder-top>. A largura da janela do objeto da janela de encaixe é determinada pela subtração prcBorder-left> de prcBorder-right>. Sua altura está contida no membro superior da estrutura BORDERWIDTHS .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shlobj.h)
DLL Shell32.dll (versão 4.71 ou posterior)

Confira também

IDeskBand

IDockingWindow

IDockingWindowFrame

IDockingWindowSite