Método IOleInPlaceUIWindow::GetBorder (oleidl.h)

  • Artigo

Recupera o retângulo externo para barras de ferramentas e controles enquanto o objeto está ativo no local.

Sintaxe

HRESULT GetBorder(
  [out] LPRECT lprectBorder
);

Parâmetros

[out] lprectBorder

Um ponteiro para uma estrutura RECT em que o retângulo externo deve ser retornado. As coordenadas da estrutura são relativas à janela que está sendo representada pela interface.

Retornar valor

Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
INPLACE_E_NOTOOLSPACE
 O objeto não pode instalar barras de ferramentas neste objeto de janela.
E_OUTOFMEMORY
 Memória insuficiente disponível para esta operação.
E_UNEXPECTED
 Ocorreu um erro inesperado.

Comentários

Anotações para chamadores

A função IOleInPlaceUIWindow::GetBorder , quando chamada em um objeto de janela de documento ou quadro, retorna o retângulo externo (em relação à janela) em que o objeto pode colocar barras de ferramentas ou controles semelhantes.

Se o objeto for instalar essas ferramentas, ele deverá negociar espaço para as ferramentas nesse retângulo usando IOleInPlaceUIWindow::RequestBorderSpace e, em seguida, chamar IOleInPlaceUIWindow::SetBorderSpace para obter esse espaço alocado.

Nota Durante a execução de IOleInPlaceUIWindow::GetBorder, não faça chamadas para as funções PeekMessage ou GetMessage ou uma caixa de diálogo. Isso pode fazer com que o sistema fique em deadlock. Há outras restrições sobre quais métodos e funções de interface OLE podem ser chamados de dentro do GetBorder.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [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 oleidl.h

Confira também

Ioleinplaceuiwindow

IOleInPlaceUIWindow::RequestBorderSpace

IOleInPlaceUIWindow::SetBorderSpace