Compartilhar via

Estrutura CHOOSEFONTA (commdlg.h)

  • Artigo

Contém informações que a função ChooseFont usa para inicializar a caixa de diálogo Fonte. Depois que o usuário fecha a caixa de diálogo, o sistema retorna informações sobre a seleção do usuário nessa estrutura.

Sintaxe

typedef struct tagCHOOSEFONTA {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HDC          hDC;
  LPLOGFONTA   lpLogFont;
  INT          iPointSize;
  DWORD        Flags;
  COLORREF     rgbColors;
  LPARAM       lCustData;
  LPCFHOOKPROC lpfnHook;
  LPCSTR       lpTemplateName;
  HINSTANCE    hInstance;
  LPSTR        lpszStyle;
  WORD         nFontType;
  WORD         ___MISSING_ALIGNMENT__;
  INT          nSizeMin;
  INT          nSizeMax;
} CHOOSEFONTA;

Membros

lStructSize

Tipo: DWORD

O comprimento da estrutura, em bytes.

hwndOwner

Tipo: HWND

Um identificador para a janela que possui a caixa de diálogo. Esse membro pode ser qualquer identificador de janela válido ou pode ser NULL se a caixa de diálogo não tiver proprietário.

hDC

Tipo: HDC

Esse membro é ignorado pela função ChooseFont.

Windows Vista e Windows XP/2000: um identificador para o contexto do dispositivo ou contexto de informações da impressora cujas fontes serão listadas na caixa de diálogo. Esse membro será usado somente se o Flags membro especificar o sinalizador CF_PRINTERFONTS ou CF_BOTH; caso contrário, esse membro será ignorado.

lpLogFont

Tipo: LPLOGFONT

Um ponteiro para uma estrutura de LOGFONT. Se você definir o sinalizador CF_INITTOLOGFONTSTRUCT no Flags membro e inicializar os outros membros, a função ChooseFont inicializa a caixa de diálogo com uma fonte que corresponde aos membros LOGFONT. Se o usuário clicar no botão OK, ChooseFont definirá os membros da estrutura LOGFONT com base nas seleções do usuário.

iPointSize

Tipo: INT

O tamanho da fonte selecionada, em unidades de 1/10 de um ponto. A função ChooseFont define esse valor depois que o usuário fecha a caixa de diálogo.

Flags

Tipo: DWORD

Um conjunto de sinalizadores de bits que você pode usar para inicializar a caixa de diálogo Fonte. Quando a caixa de diálogo é retornada, ela define esses sinalizadores para indicar a entrada do usuário. Esse membro pode ser um ou mais dos valores a seguir.

Valor Significado
CF_APPLY
0x00000200L
 Faz com que a caixa de diálogo exiba o botão Aplicar. Você deve fornecer um procedimento de gancho para processar mensagens WM_COMMAND para o botão aplicar . O procedimento de gancho pode enviar a mensagem WM_CHOOSEFONT_GETLOGFONT para a caixa de diálogo para recuperar o endereço da estrutura que contém as seleções atuais para a fonte.
CF_ANSIONLY
0x00000400L
 Esse sinalizador está obsoleto. Para limitar as seleções de fonte a todos os scripts, exceto aqueles que usam os conjuntos de caracteres OEM ou Symbol, use CF_SCRIPTSONLY. Para obter o comportamento de CF_ANSIONLY original, use CF_SELECTSCRIPT e especifique ANSI_CHARSET no membro lfCharSet da estrutura de LOGFONT apontada por lpLogFont.
CF_BOTH
0x00000003
 Esse sinalizador é ignorado para enumeração de fonte.

Windows Vista e Windows XP/2000: Faz com que a caixa de diálogo liste as fontes de impressora e tela disponíveis. O hDC membro é um identificador para o contexto do dispositivo ou contexto de informações associado à impressora. Esse sinalizador é uma combinação dos sinalizadores CF_SCREENFONTS e CF_PRINTERFONTS.
CF_EFFECTS
0x00000100L
 Faz com que a caixa de diálogo exiba os controles que permitem que o usuário especifique as opções de cor de strikeout, sublinhado e texto. Se esse sinalizador estiver definido, você poderá usar o rgbColors membro para especificar a cor do texto inicial. Você pode usar o lfStrikeOut e membros lfUnderline da estrutura apontados por lpLogFont para especificar as configurações iniciais das caixas de seleção de strikeout e sublinhado. ChooseFont pode usar esses membros para retornar as seleções do usuário.
CF_ENABLEHOOK
0x00000008L
 Habilita o procedimento de gancho especificado no lpfnHook membro dessa estrutura.
CF_ENABLETEMPLATE
0x00000010L
 Indica que os membros hInstance e lpTemplateName especificam um modelo de caixa de diálogo a ser usado no lugar do modelo padrão.
CF_ENABLETEMPLATEHANDLE
0x00000020L
 Indica que o membro hInstance identifica um bloco de dados que contém um modelo de caixa de diálogo pré-carregado. O sistema ignorará o membro lpTemplateName se esse sinalizador for especificado.
CF_FIXEDPITCHONLY
0x00004000L

ChooseFont deve enumerar e permitir a seleção apenas de fontes de tom fixo.
CF_FORCEFONTEXIST
0x00010000L

ChooseFont deve indicar uma condição de erro se o usuário tentar selecionar uma fonte ou estilo que não esteja listado na caixa de diálogo.
CF_INACTIVEFONTS
0x02000000L

ChooseFont deve exibir fontes definidas como Ocultar no Painel de Controle de Fontes.

Windows Vista e Windows XP/2000: Esse sinalizador não tem suporte até o Windows 7.
CF_INITTOLOGFONTSTRUCT
0x00000040L

ChooseFont deve usar a estrutura apontada pelo membro lpLogFont para inicializar os controles da caixa de diálogo.
CF_LIMITSIZE
0x00002000L

ChooseFont deve selecionar apenas tamanhos de fonte dentro do intervalo especificado pelos membros nSizeMin e nSizeMax.
CF_NOOEMFONTS
0x00000800L
 O mesmo que o sinalizador de CF_NOVECTORFONTS.
CF_NOFACESEL
0x00080000L
 Ao usar uma estrutura LOGFONT para inicializar os controles da caixa de diálogo, use esse sinalizador para impedir que a caixa de diálogo exiba uma seleção inicial para a caixa de combinação de nome da fonte. Isso é útil quando não há um único nome de fonte que se aplique à seleção de texto.
CF_NOSCRIPTSEL
0x00800000L
 Desabilita a caixa de combinação Script. Quando esse sinalizador é definido, o membro lfCharSet da estrutura de LOGFONT é definido como DEFAULT_CHARSET quando ChooseFont retorna. Esse sinalizador é usado apenas para inicializar a caixa de diálogo.
CF_NOSIMULATIONS
0x00001000L

ChooseFont não deve exibir nem permitir a seleção de simulações de fonte.
CF_NOSIZESEL
0x00200000L
 Ao usar uma estrutura para inicializar os controles da caixa de diálogo, use esse sinalizador para impedir que a caixa de diálogo exiba uma seleção inicial para a caixa de combinação Tamanho da Fonte . Isso é útil quando não há um único tamanho de fonte que se aplique à seleção de texto.
CF_NOSTYLESEL
0x00100000L
 Ao usar uma estrutura LOGFONT para inicializar os controles da caixa de diálogo, use esse sinalizador para impedir que a caixa de diálogo exiba uma seleção inicial para a caixa de combinação estilo de fonte . Isso é útil quando não há um único estilo de fonte que se aplique à seleção de texto.
CF_NOVECTORFONTS
0x00000800L

ChooseFont não deve permitir seleções de fonte de vetor.
CF_NOVERTFONTS
0x01000000L
 Faz com que a caixa de diálogo Fonte liste apenas fontes orientadas horizontalmente.
CF_PRINTERFONTS
0x00000002
 Esse sinalizador é ignorado para enumeração de fonte.

Windows Vista e Windows XP/2000: Faz com que a caixa de diálogo liste apenas as fontes compatíveis com a impressora associada ao contexto do dispositivo ou ao contexto de informações identificado pelo membro do hDC. Ele também faz com que o rótulo de descrição do tipo de fonte apareça na parte inferior da caixa de diálogo Fonte.
CF_SCALABLEONLY
0x00020000L
 Especifica que ChooseFont deve permitir apenas a seleção de fontes escalonáveis. Fontes escalonáveis incluem fontes de vetor, fontes de impressora escalonáveis, fontes TrueType e fontes dimensionadas por outras tecnologias.
CF_SCREENFONTS
0x00000001
 Esse sinalizador é ignorado para enumeração de fonte.

Windows Vista e Windows XP/2000: Faz com que a caixa de diálogo liste apenas as fontes de tela compatíveis com o sistema.
CF_SCRIPTSONLY
0x00000400L

ChooseFont deve permitir a seleção de fontes para todos os conjuntos de caracteres não OEM e Symbol, bem como o conjunto de caracteres ANSI. Isso substitui o valor CF_ANSIONLY.
CF_SELECTSCRIPT
0x00400000L
 Quando especificado na entrada, somente fontes com o conjunto de caracteres identificado no membro lfCharSet da estrutura LOGFONT são exibidas. O usuário não terá permissão para alterar o conjunto de caracteres especificado na caixa de combinação scripts .
CF_SHOWHELP
0x00000004L
 Faz com que a caixa de diálogo exiba o botão Ajuda. O membro hwndOwner deve especificar a janela para receber o HELPMSGSTRING mensagens registradas que a caixa de diálogo envia quando o usuário clica no botão Ajuda.
CF_TTONLY
0x00040000L

ChooseFont só deve enumerar e permitir a seleção de fontes TrueType.
CF_USESTYLE
0x00000080L
 O membro lpszStyle é um ponteiro para um buffer que contém dados de estilo que ChooseFont deve usar para inicializar a caixa de combinação estilo de fonte . Quando o usuário fecha a caixa de diálogo, ChooseFont copia dados de estilo para a seleção do usuário para esse buffer.
Observação Para globalizar seu aplicativo, especifique o estilo usando os membros lfWeight e lfItalic da estrutura LOGFONT apontada pelo lpLogFont. O nome do estilo pode ser alterado dependendo da linguagem de interface do usuário do sistema.
 
CF_WYSIWYG
0x00008000L
 Obsoleto. ChooseFont ignora esse sinalizador.

Windows Vista e Windows XP/2000: ChooseFont deve permitir apenas a seleção de fontes disponíveis na impressora e na exibição. Se esse sinalizador for especificado, os sinalizadores CF_SCREENSHOTS e CF_PRINTERFONTSou CF_BOTH também deverão ser especificados.

rgbColors

Tipo: COLORREF

Se o sinalizador CF_EFFECTS estiver definido, rgbColors especificar a cor do texto inicial. Quando ChooseFont retorna com êxito, esse membro contém o valor RGB da cor de texto selecionada pelo usuário. Para criar um valor de cor COLORREF, use a macro RGB .

lCustData

Tipo: LPARAM

Dados definidos pelo aplicativo que o sistema passa para o procedimento de gancho identificado pelo membro lpfnHook . Quando o sistema envia a mensagem WM_INITDIALOG para o procedimento de gancho, o parâmetro lParam da mensagem é um ponteiro para a estrutura CHOOSEFONT especificada quando a caixa de diálogo foi criada. O procedimento de gancho pode usar esse ponteiro para obter o valor lCustData.

lpfnHook

Tipo: LPCFHOOKPROC

Um ponteiro para um procedimento de gancho de CFHookProc que pode processar mensagens destinadas à caixa de diálogo. Esse membro é ignorado, a menos que o sinalizador de CF_ENABLEHOOK seja definido no membro sinalizadores do .

lpTemplateName

Tipo: LPCTSTR

O nome do recurso de modelo da caixa de diálogo no módulo identificado pelo membro do hInstance. Esse modelo é substituído pelo modelo de caixa de diálogo padrão. Para recursos da caixa de diálogo numerada, lpTemplateName pode ser um valor retornado pela macro MAKEINTRESOURCE. Esse membro é ignorado, a menos que o sinalizador de CF_ENABLETEMPLATE seja definido no membro sinalizadores do .

hInstance

Tipo: HINSTANCE

Se o sinalizador CF_ENABLETEMPLATEHANDLE estiver definido no membro sinalizadores , hInstance será um identificador para um objeto de memória que contém um modelo de caixa de diálogo. Se o sinalizador CF_ENABLETEMPLATE estiver definido, hInstance será um identificador para um módulo que contém um modelo de caixa de diálogo nomeado pelo membro lpTemplateName. Se nem CF_ENABLETEMPLATEHANDLE nem CF_ENABLETEMPLATE estiver definido, esse membro será ignorado.

lpszStyle

Tipo: LPTSTR

Os dados de estilo. Se o sinalizador CF_USESTYLE for especificado, ChooseFont usará os dados nesse buffer para inicializar a caixa de combinação estilo de fonte . Quando o usuário fecha a caixa de diálogo, ChooseFont copia a cadeia de caracteres na caixa de combinação estilo de fonte nesse buffer.

nFontType

Tipo: word

O tipo da fonte selecionada quando ChooseFont retorna. Esse membro pode ser um ou mais dos valores a seguir.

Valor Significado
BOLD_FONTTYPE
0x0100
 O peso da fonte é negrito. Essas informações são duplicadas no membro lfWeight da estrutura de LOGFONT e são equivalentes a FW_BOLD.
ITALIC_FONTTYPE
0x0200
 O atributo de fonte itálico está definido. Essas informações são duplicadas no membro lfItalic da estrutura de LOGFONT.
PRINTER_FONTTYPE
0x4000
 A fonte é uma fonte de impressora.
REGULAR_FONTTYPE
0x0400
 O peso da fonte é normal. Essas informações são duplicadas no membro lfWeight da estrutura de LOGFONT e são equivalentes a FW_REGULAR.
SCREEN_FONTTYPE
0x2000
 A fonte é uma fonte de tela.
SIMULATED_FONTTYPE
0x8000
 A fonte é simulada pela GDI (interface do dispositivo gráfico).

___MISSING_ALIGNMENT__

nSizeMin

Tipo: INT

O tamanho mínimo do ponto que um usuário pode selecionar. ChooseFont reconhecerá esse membro somente se o sinalizador de CF_LIMITSIZE for especificado.

nSizeMax

Tipo: INT

O tamanho máximo do ponto que um usuário pode selecionar. ChooseFont reconhecerá esse membro somente se o sinalizador de CF_LIMITSIZE for especificado.

Observações

Nota

O cabeçalho commdlg.h define CHOOSEFONT como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho commdlg.h

Consulte também

ChooseFont

da Biblioteca de Caixas de Diálogo Comuns

Conceitual

MAKEINTRESOURCE

de referência de