Estrutura CHOOSEFONTW (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 tagCHOOSEFONTW {
DWORD lStructSize;
HWND hwndOwner;
HDC hDC;
LPLOGFONTW lpLogFont;
INT iPointSize;
DWORD Flags;
COLORREF rgbColors;
LPARAM lCustData;
LPCFHOOKPROC lpfnHook;
LPCWSTR lpTemplateName;
HINSTANCE hInstance;
LPWSTR lpszStyle;
WORD nFontType;
WORD ___MISSING_ALIGNMENT__;
INT nSizeMin;
INT nSizeMax;
} CHOOSEFONTW;
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
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
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 |
---|---|
|
Faz com que a caixa de diálogo exiba o botão Aplicar. Você deve fornecer um procedimento de gancho para processar mensagens |
|
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 |
|
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. |
|
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 |
|
Habilita o procedimento de gancho especificado no lpfnHook membro 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é-carregado. 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 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. |
|
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. |
|
|
|
ChooseFont deve selecionar apenas tamanhos de fonte dentro do intervalo especificado pelos membros nSizeMin e nSizeMax. |
|
O mesmo que o sinalizador de 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 |
|
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 |
|
Ao usar uma estrutura |
|
|
|
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 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. |
|
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 |
|
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. |
|
ChooseFont só deve enumerar e permitir a seleção de fontes TrueType. |
|
O membro |
|
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
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
lCustData
Tipo: LPARAM
Dados definidos pelo aplicativo que o sistema passa para o procedimento de gancho identificado pelo membro lpfnHook
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
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,
hInstance
Tipo: HINSTANCE
Se o sinalizador
lpszStyle
Tipo: LPTSTR
Os dados de estilo. Se o sinalizador
nFontType
Tipo: word
O tipo da fonte selecionada quando ChooseFont retorna. Esse membro pode ser um ou mais dos valores a seguir.
___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
da Biblioteca de Caixas de Diálogo Comuns
Conceitual
de referência de