Estrutura CHOOSEFONTA (commdlg.h)
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
Digite: 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 membro Flags especificar o sinalizador CF_PRINTERFONTS ou CF_BOTH ; caso contrário, esse membro será ignorado.
lpLogFont
Tipo: LPLOGFONT
Um ponteiro para uma estrutura LOGFONT . Se você definir o sinalizador CF_INITTOLOGFONTSTRUCT no membro Flags e inicializar os outros membros, a função ChooseFont inicializará a caixa de diálogo com uma fonte que corresponda 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 retorna, ela define esses sinalizadores para indicar a entrada do usuário. Esse membro pode ser um ou mais dos valores a seguir.
| Valor | Significado |
|---|---|
|
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 da fonte. |
|
Esse sinalizador é 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 LOGFONT apontada por lpLogFont. |
|
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 tela e impressora disponíveis. O membro hDC é 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 . |
|
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 membro rgbColors para especificar a cor do texto inicial. Você pode usar os membros lfStrikeOut e lfUnderline da estrutura apontada por lpLogFont para especificar as configurações iniciais das caixas de strikeout e sublinhar marcar. ChooseFont pode usar esses membros para retornar as seleções do usuário. |
|
Habilita o procedimento de gancho especificado no membro lpfnHook dessa estrutura. |
|
Indica que os membros hInstance e lpTemplateName especificam um modelo de caixa de diálogo a ser usado no lugar do modelo padrão. |
|
Indica que o membro hInstance identifica um bloco de dados que contém um modelo de caixa de diálogo pré-carregada. O sistema ignorará o membro lpTemplateName se esse sinalizador for especificado. |
|
ChooseFont deve enumerar e permitir a seleção apenas de fontes de tom fixo. |
|
ChooseFont deverá 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. |
|
O ChooseFont também deve exibir fontes definidas como Ocultar em Fontes Painel de Controle. Windows Vista e Windows XP/2000: Esse sinalizador não tem suporte até o Windows 7. |
|
ChooseFont deve usar a estrutura apontada pelo membro lpLogFont para inicializar os controles da caixa de diálogo. |
|
ChooseFont deve selecionar apenas tamanhos de fonte dentro do intervalo especificado pelos membros nSizeMin e nSizeMax . |
|
O mesmo que o sinalizador CF_NOVECTORFONTS . |
|
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. |
|
Desabilita a caixa de combinação Script . Quando esse sinalizador é definido, o membro lfCharSet da estrutura LOGFONT é definido como DEFAULT_CHARSET quando ChooseFont retorna. Esse sinalizador é usado apenas para inicializar a caixa de diálogo. |
|
ChooseFont não deve exibir nem permitir a seleção de simulações de fonte. |
|
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. |
|
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 da Fonte . Isso é útil quando não há um único estilo de fonte que se aplique à seleção de texto. |
|
ChooseFont não deve permitir seleções de fonte de vetor. |
|
Faz com que a caixa de diálogo Fonte liste apenas fontes orientadas horizontalmente. |
|
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 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 . |
|
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. |
|
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. |
|
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 . |
|
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 . |
|
Faz com que a caixa de diálogo exiba o botão Ajuda . O membro hwndOwner deve especificar a janela para receber as mensagens registradas HELPMSGSTRING que a caixa de diálogo envia quando o usuário clica no botão Ajuda . |
|
ChooseFont só deve enumerar e permitir a seleção de fontes TrueType. |
|
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 da 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.
Nota Para globalizar seu aplicativo, você deve especificar o estilo usando os membros lfWeight e lfItalic da estrutura LOGFONT apontada por lpLogFont. O nome do estilo pode mudar dependendo do idioma da interface do usuário do sistema.
|
|
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 tela. Se esse sinalizador for especificado, os sinalizadores CF_SCREENSHOTS e CF_PRINTERFONTS ou 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 do 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 CFHookProc que pode processar mensagens destinadas à caixa de diálogo. Esse membro é ignorado, a menos que o sinalizador CF_ENABLEHOOK seja definido no membro Flags .
lpTemplateName
Tipo: LPCTSTR
O nome do recurso de modelo da caixa de diálogo no módulo identificado pelo membro hInstance . Esse modelo é substituído pelo modelo de caixa de diálogo padrão. Para recursos numerados da caixa de diálogo, lpTemplateName pode ser um valor retornado pela macro MAKEINTRESOURCE . Esse membro é ignorado, a menos que o sinalizador CF_ENABLETEMPLATE seja definido no membro Flags .
hInstance
Tipo: HINSTANCE
Se o sinalizador CF_ENABLETEMPLATEHANDLE estiver definido no membro Flags , 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 chamado pelo membro lpTemplateName . Se nem CF_ENABLETEMPLATEHANDLE nem CF_ENABLETEMPLATE estiverem definidos, 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 da Fonte . Quando o usuário fecha a caixa de diálogo, ChooseFont copia a cadeia de caracteres na caixa de combinação Estilo da 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 |
|---|---|
|
A espessura da fonte está em negrito. Essas informações são duplicadas no membro lfWeight da estrutura LOGFONT e são equivalentes a FW_BOLD. |
|
O atributo de fonte itálico está definido. Essas informações são duplicadas no membro lfItalic da estrutura LOGFONT . |
|
A fonte é uma fonte de impressora. |
|
O peso da fonte é normal. Essas informações são duplicadas no membro lfWeight da estrutura LOGFONT e são equivalentes a FW_REGULAR. |
|
A fonte é uma fonte de tela. |
|
A fonte é simulada pela GDI (interface gráfica do dispositivo). |
___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 CF_LIMITSIZE for especificado.
nSizeMax
Tipo: INT
O tamanho de ponto máximo que um usuário pode selecionar. ChooseFont reconhecerá esse membro somente se o sinalizador CF_LIMITSIZE for especificado.
Comentários
Observação
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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| 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 |
Confira também
Biblioteca de caixas de diálogo comuns
Conceitual
Referência
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de