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

Artigo
03/05/2024

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