estrutura FORM_INFO_2

Contém informações sobre um formulário de impressão localizável.

Sintaxe

typedef struct _FORM_INFO_2 {
  DWORD   Flags;
  LPTSTR  pName;
  SIZEL   Size;
  RECTL   ImageableArea;
  LPCSTR  pKeyword;
  DWORD   StringType;
  LPCTSTR pMuiDll;
  DWORD   dwResourceId;
  LPCTSTR pDisplayName;
  LANGID  wLangId;
} FORM_INFO_2, *PFORM_INFO_2;

Membros

Sinalizadores

As propriedades do formulário. Os valores a seguir são definidos, mas apenas um pode ser definido. Quando o FORM_INFO_2 é retornado por GetForm ou EnumForms, Flags é definido como o valor atual no banco de dados de formulários.

Valor	Significado
FORM_USER	Se esse sinalizador de bits estiver definido, o formulário será definido pelo usuário. Formulários com esse conjunto de sinalizadores são definidos no Registro.
FORM_BUILTIN	Se esse sinalizador de bit estiver definido, o formulário será parte do spooler. As definições de formulário com esse sinalizador definido não aparecem no Registro. Formulários internos não podem ser modificados, portanto, esse sinalizador não deve ser definido quando a estrutura é passada para AddForm ou SetForm.
FORM_PRINTER	Se esse sinalizador de bits estiver definido, o formulário será associado a uma determinada impressora e sua definição será exibida no Registro.

pName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do formulário. O nome do formulário não pode exceder 31 caracteres.

Tamanho

A largura e a altura da forma em milésimos de milímetros.

ImageableArea

A largura e a altura, em milésimos de milímetros, da área da página na qual a impressora pode imprimir.

pKeyword

Um ponteiro para um identificador de cadeia de caracteres não localizável do formulário. Quando passado para AddForm ou SetForm, isso dá ao chamador um meio de identificar o formulário em todas as localidades.

StringType

Especifica como um nome de exibição localizado para o formulário é obtido em runtime. Os valores a seguir são definidos. Somente um pode ser definido em qualquer chamada fornecida para AddForm ou SetForm. Tanto STRING_MUIDLL quanto STRING_LANGPAIR podem ser definidos nas FORM_INFO_2 (s) retornadas por GetForm ou EnumForms. Consulte Observações.

Valor	Significado
STRING_NONE	Não há nenhum nome de exibição localizado.
STRING_MUIDLL	O nome de exibição é extraído da DLL de recursos localizados da Interface do Usuário Multilíngue especificada em pMuiDll. A ID está no membro dwResourceId .
STRING_LANGPAIR	O nome de exibição e a ID do idioma são fornecidos diretamente pelo pDisplayName e o idioma é especificado por wLangId.

pMuiDll

A DLL de recurso localizado da Interface do Usuário Multilíngue que contém o nome de exibição localizado.

dwResourceId

A ID do recurso do nome de exibição do formulário em pMuiDll.

pDisplayName

O nome de exibição do formulário no idioma especificado por wLangId.

wLangId

O idioma do pDisplayName.

Comentários

Em uma chamada para AddForm ou SetForm:

• Se StringType for STRING_NONE, pMuiDll e pDisplayName deverão ser NULL e dwResourceId e wLangId deverão ser 0.
• Se StringType for STRING_MUIDLL, pDisplayName deverá ser NULL e wLangId deverá ser 0.
• Se StringType for STRING_LANGPAIR, pMuiDll deverá ser NULL e dwResourceId deverá ser 0.

Para um FORM_INFO_2 retornado por uma chamada para GetForm ou EnumForms:

• Se StringType for STRING_MUIDLL e STRING_LANGPAIR, pMuiDll, pDisplayName, dwResourceId e wLangId terão valores válidos.
• Se StringType for apenas STRING_MUIDLL, pMuiDll e dwResourceId terão valores válidos. pDisplayName será NULL e wLangId será 0.
• Se StringType for apenas STRING_LANGPAIR, pDisplayName e wLangId terão valores válidos. pMuiDll será NULL e dwResourceId será 0.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	Winspool.h (inclua Windows.h)
Nomes Unicode e ANSI	_FORM_INFO_2W (Unicode) e ANSI (_FORM_INFO_2A )

Confira também

Impressão

Estruturas de API do Spooler de Impressão

Interface do Usuário Multilíngue

AddForm

GetForm

EnumForms

SetForm