Método ITextHost::TxGetViewInset (textserv.h)

Solicita as dimensões do espaço em branco ao redor do texto na janela do host de texto.

Sintaxe

HRESULT TxGetViewInset(
  LPRECT prc
);

Parâmetros

prc

Tipo: LPRECT

O tamanho do conjunto, nas coordenadas do cliente. Os membros superior, inferior, esquerdo e direito da estrutura RECT indicam até que ponto em cada direção o desenho deve ser indefinido.

Retornar valor

Tipo: HRESULT

O valor retornado é S_OK.

Comentários

O inset de exibição é a quantidade de espaço em cada lado entre o retângulo do cliente e o retângulo de exibição. O retângulo de exibição (também chamado de retângulo formatação) é o retângulo no qual o texto deve ser formatado.

Os conjuntos de exibição são passados em uma estrutura RECT , mas isso não é realmente um retângulo. Ele deve ser tratado como quatro valores independentes a serem subtraídos em cada lado do retângulo do cliente para figurar o retângulo de exibição.

Os conjuntos de exibição são passados em HIMETRIC (cada unidade HIMETRIC corresponde a 0,01 milímetro) para que não dependam do retângulo do cliente e do contexto do dispositivo de renderização.

Os conjuntos de exibição podem ser negativos em ambos os lados do retângulo do cliente, levando a um retângulo de exibição maior do que o retângulo do cliente. Em seguida, o texto deve ser recortado no retângulo do cliente. Se o retângulo de exibição for mais largo que o retângulo do cliente, o host poderá adicionar uma barra de rolagem horizontal ao controle.

Objetos de serviços de texto de linha única ignoram o limite direito do retângulo de exibição ao formatar texto.

O inset de exibição está disponível no host o tempo todo, ativo ou inativo.

Requisitos

Confira também

ITextHost

Visão geral dos controles de edição avançada sem janelas