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

  • Artigo

Controla a supressão de viúvas e órfãos.

Sintaxe

HRESULT SetWidowControl(
  [in] long Value
);

Parâmetros

[in] Value

Tipo: long

Um valor tomBool que controla a supressão de viúvas e órfãos. Pode ser um dos valores possíveis a seguir.

Valor Significado
tomTrue
 Impede a impressão de viúvas e órfãos.
tomFalse
 Permite a impressão de viúvas e órfãos.
tomToggle
 O valor é alternado.
tomUndefined
 Nenhuma alteração.

Valor retornado

Tipo: HRESULT

Se ITextPara::SetWidowControl 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
 O 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

Esse método está incluído para compatibilidade com o Microsoft Word; ele não afeta como o controle de edição avançada exibe texto.

Uma viúva é criada quando a última linha de um parágrafo é impressa por si mesma na parte superior de uma página. Um órfão é quando a primeira linha de um parágrafo é impressa por si mesma na parte inferior de uma página.

Requisitos

   
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

Confira também

Conceitual

ITextPara

Referência

Modelo de objeto de texto