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

Recupera o estado de controle viúva e órfã para os parágrafos em um intervalo.

Sintaxe

HRESULT GetWidowControl(
  long *pValue
);

Parâmetros

pValue

Tipo: long*

Um valor tomBool que indica o estado do controle viúva e órfão. Pode ser um dos seguintes valores.

Valor Significado
tomTrue Impede a impressão de uma viúva ou órfã
tomFalse Permite a impressão de uma viúva ou órfã.
tomUndefined A propriedade de controle de viúva é indefinida.

Retornar valor

Tipo: HRESULT

Se ITextPara::GetWidowControl 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.
CO_E_RELEASED
O objeto de formatação de parágrafo é anexado a um intervalo que foi excluído.

Comentários

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

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

Confira também

Conceitual

ITextPara

Referência

SetWidowControl

Modelo de objeto de texto