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

Artigo
03/13/2024

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