Método IOleInPlaceUIWindow::GetBorder (oleidl.h)
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 |
|---|---|
|
O objeto não pode instalar barras de ferramentas neste objeto de janela. |
|
Memória insuficiente disponível para esta operação. |
|
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 |