Compartilhar via


Estrutura DEVNAMES (commdlg.h)

Contém cadeias de caracteres que identificam os nomes de porta de driver, dispositivo e saída de uma impressora. Essas cadeias de caracteres devem ser cadeias de caracteres ANSI quando a versão ANSI de PrintDlg ou PrintDlgEx é usada e deve ser cadeias de caracteres Unicode quando a versão Unicode de PrintDlg ou PrintDlgEx é usada. As funções PrintDlgEx e PrintDlg usam essas cadeias de caracteres para inicializar a folha de propriedades de impressão definida pelo sistema ou a caixa de diálogo Imprimir. Quando o usuário fecha a folha de propriedades ou a caixa de diálogo, as informações sobre a impressora selecionada são retornadas nessa estrutura.

Sintaxe

typedef struct tagDEVNAMES {
  WORD wDriverOffset;
  WORD wDeviceOffset;
  WORD wOutputOffset;
  WORD wDefault;
} DEVNAMES;

Membros

wDriverOffset

Tipo: WORD

O deslocamento, em caracteres, do início dessa estrutura para uma cadeia de caracteres terminada em nulo que contém o nome do arquivo (sem a extensão) do driver do dispositivo. Na entrada, essa cadeia de caracteres é usada para determinar a impressora a ser exibida inicialmente na caixa de diálogo.

wDeviceOffset

Tipo: WORD

O deslocamento, em caracteres, desde o início dessa estrutura até a cadeia de caracteres terminada em nulo que contém o nome do dispositivo.

wOutputOffset

Tipo: WORD

O deslocamento, em caracteres, desde o início dessa estrutura até a cadeia de caracteres terminada em nulo que contém o nome do dispositivo para o meio de saída físico (porta de saída).

wDefault

Tipo: WORD

Indica se as cadeias de caracteres contidas na estrutura DEVNAMES identificam a impressora padrão. Essa cadeia de caracteres é usada para verificar se a impressora padrão não foi alterada desde a última operação de impressão. Se qualquer uma das cadeias de caracteres não corresponder, uma mensagem de aviso será exibida informando ao usuário que o documento pode precisar ser reformatado. Na saída, o membro wDefault será alterado somente se a caixa de diálogo Configuração de Impressão for exibida e o usuário escolher o botão OK . O sinalizador DN_DEFAULTPRN será usado se a impressora padrão tiver sido selecionada. Se uma impressora específica for selecionada, o sinalizador não será usado. Todos os outros sinalizadores neste membro são reservados para uso interno pelo procedimento da caixa de diálogo para a folha de propriedades Imprimir ou a caixa de diálogo Imprimir .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho commdlg.h (inclua Windows.h)

Confira também

Biblioteca de caixas de diálogo comuns

Conceitual

Printdlg

Printdlgex

Referência