Método ITextPara::SetKeepTogether (tom.h)

Artigo
03/13/2024

Controla se as quebras de página são permitidas dentro de um parágrafo em um intervalo.

Sintaxe

HRESULT SetKeepTogether(
  [in] long Value
);

Parâmetros

[in] Value

Tipo: long

Indica se as quebras de página são permitidas dentro de um parágrafo em um intervalo. Pode ser um dos valores possíveis a seguir.

Valor	Significado
tomTrue	Quebras de página não são permitidas dentro de um parágrafo.
tomFalse	Quebras de página são permitidas dentro de um parágrafo.
tomUndefined	A propriedade é indefinida.

Retornar valor

Tipo: HRESULT

Se ITextPara::SetKeepTogether for bem-sucedido, ele retornará S_OK. Se o método falhar, ele retornará um dos seguintes códigos de erro COM. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno	Descrição
Valor	Significado
E_INVALIDARG	Argumento inválido.
E_ACCESSDENIED	Acesso de gravação negado.
E_OUTOFMEMORY	Memória insuficiente.
CO_E_RELEASED	O objeto de formatação de parágrafo é anexado a um intervalo que foi excluído.

Comentários

Essa propriedade corresponde ao efeito PFE_KEEP descrito na estrutura PARAFORMAT2 .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tom.h
DLL	Msftedit.dll