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

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