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

  • Artigo

Aloca espaço para a borda solicitada na chamada para IOleInPlaceUIWindow::RequestBorderSpace.

Sintaxe

HRESULT SetBorderSpace(
  [in] LPCBORDERWIDTHS pborderwidths
);

Parâmetros

[in] pborderwidths

Ponteiro para uma estrutura BORDERWIDTHS que contém a largura solicitada das ferramentas, em pixels. Pode ser NULL, indicando que o objeto não precisa de espaço.

Retornar valor

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

Código de retorno Descrição
OLE_E_INVALIDRECT
 O retângulo não está dentro das especificações retornadas por IOleInPlaceUIWindow::GetBorder.

Comentários

O objeto deve chamar IOleInPlaceUIWindow::SetBorderSpace. Ele pode fazer qualquer um dos seguintes procedimentos:

  • Use suas próprias barras de ferramentas, solicitando espaço de borda de um tamanho específico.
  • Não use barras de ferramentas, mas force o contêiner a remover suas barras de ferramentas passando uma estrutura BORDERWIDTHS válida que contém nada além de zeros no parâmetro pborderwidths .
  • Não use barras de ferramentas, mas permita que o contêiner in-loco deixe suas barras de ferramentas para cima passando NULL como o parâmetro pborderwidths .
A estrutura BORDERWIDTHS usada nessa chamada geralmente teria sido passada em uma chamada anterior para IOleInPlaceUIWindow::RequestBorderSpace, que deve ter retornado S_OK.

Se um objeto precisar renegociar o espaço na borda, ele poderá chamar IOleInPlaceUIWindow::SetBorderSpace novamente com as novas larguras. Se a chamada para IOleInPlaceUIWindow::SetBorderSpace falhar, o objeto poderá fazer uma negociação completa para o espaço de borda com chamadas para IOleInPlaceUIWindow::GetBorder, IOleInPlaceUIWindow::RequestBorderSpace e IOleInPlaceUIWindow::SetBorderSpace.

Nota Ao executar IOleInPlaceUIWindow::SetBorderSpace, 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á mais restrições sobre quais métodos e funções de interface OLE podem ser chamados de dentro de IOleInPlaceUIWindow::SetBorderSpace.
 

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::GetBorder

IOleInPlaceUIWindow::RequestBorderSpace