Compartilhar via


Método IOleInPlaceActiveObject::ResizeBorder (oleidl.h)

Alerta o objeto de que ele precisa redimensionar seu espaço de borda.

Sintaxe

HRESULT ResizeBorder(
  [in] LPCRECT             prcBorder,
  [in] IOleInPlaceUIWindow *pUIWindow,
  [in] BOOL                fFrameWindow
);

Parâmetros

[in] prcBorder

Um ponteiro para uma estrutura RECT que contém o novo retângulo externo no qual o objeto pode solicitar espaço de borda para suas ferramentas.

[in] pUIWindow

Um ponteiro para um ponteiro de interface IOleInPlaceUIWindow para o objeto de janela de quadro ou documento cuja borda foi alterada.

[in] fFrameWindow

Esse parâmetro será TRUE se o objeto de janela de quadro estiver chamando IOleInPlaceActiveObject::ResizeBorder; caso contrário, será FALSE.

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
E_INVALIDARG
Os valores de parâmetro especificados não são válidos.
E_OUTOFMEMORY
Não há memória suficiente disponível para a operação.
E_UNEXPECTED
Erro inesperado.

Comentários

Anotações aos Chamadores

IOleInPlaceActiveObject::ResizeBorder é chamado pelo documento do contêiner de nível superior ou pelo objeto de janela de quadro quando o espaço de borda alocado ao objeto deve ser alterado. Como o objeto in-loco ativo não é informado sobre qual janela foi alterada (a janela no nível do quadro ou do documento), IOleInPlaceActiveObject::ResizeBorder deve ser passado o ponteiro para a interface IOleInPlaceUIWindow da janela.

Observações aos implementadores

Na maioria dos casos, o redimensionamento requer apenas que você cresça, reduza ou dimensione os adornos de quadro do objeto. No entanto, para adornos mais complicados, talvez seja necessário renegociar o espaço de borda com chamadas para IOleInPlaceUIWindow::SetBorderSpace e IOleInPlaceUIWindow::SetBorderSpace.
Nota Ao executar IOleInPlaceActiveObject::ResizeBorder, 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 IOleInPlaceActiveObject::ResizeBorder.
 

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

GetMessage

Ioleinplaceactiveobject

IOleInPlaceUIWindow::GetBorder

PeekMessage