CHOOSEFONT

A CHOOSEFONT estrutura contém informações que o ChooseFont função usa para inicializar a caixa de diálogo tipo de letra comum. 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.

typedef struct {/ / cf DWORD lStructSize; 
    HWND hwndOwner; 
    HDC hDC; 
    LPLOGFONT lpLogFont; 
    INT iPointSize; 
    DWORD Sinalizadores; 
    DWORD rgbColors; 
    LPARAM lCustData; 
    LPCFHOOKPROC lpfnHook; 
    LPCTSTR lpTemplateName; 
    HINSTANCE hInstance; 
    LPTSTR lpszStyle; 
    PALAVRA nFontType; 
    PALAVRA ___MISSING_ALIGNMENT__; 
    INT nSizeMin; 
    INT nSizeMax; 
} CHOOSEFONT 

 

Membros

lStructSize
Especifica o comprimento, em bytes, da estrutura.
hwndOwner
Identifica a janela que possui a caixa de diálogo. Esse membro pode ser qualquer válido identificador janela, ou ele pode ser NULL se a caixa de diálogo não possui nenhum proprietário.
hDC
Identifica o contexto de dispositivo (ou contexto de informações) da impressora cujas fontes serão listados na caixa de diálogo. Esse membro é usado somente se a sinalizadores membro especifica o sinalizador CF_PRINTERFONTS ou CF_BOTH; caso contrário, esse membro será ignorado.
lpLogFont
Ponteiro para um estrutura de LOGFONT . Se você definir o sinalizador CF_INITTOLOGFONTSTRUCT in o sinalizadores membro e inicializar os membros LOGFONT , a ChooseFont função inicializa a caixa de diálogo com uma fonte que é a correspondência mais próxima possível. Se o usuário clicar no botão OK , ChooseFont define os membros a LOGFONT estrutura com base nas seleções do usuário.
iPointSize
Especifica 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.
Sinalizadores
Um conjunto de bit sinalizadores que você pode usar para inicializar a caixa de diálogo tipo de letra comum. Quando a caixa de diálogo retorna, ele define esses sinalizadores para indicar a entrada do usuário. Esse membro pode ser uma combinação dos sinalizadores a seguir:
Bandeira Significado
CF_APPLY Faz com que a caixa de diálogo exibir o botão Aplicar. Você deve fornecer um procedimento gancho para processo 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 do LOGFONT estrutura que contém as seleções atuais para a fonte.
CF_ANSIONLY Este sinalizador é obsoleto. Para limitar as seleções de fonte para todos os scripts com exceção daqueles que utilizam conjuntos de caracteres OEM ou símbolo, use CF_SCRIPTSONLY. Para obter o comportamento de Windows 3.1 CF_ANSIONLY, use CF_SELECTSCRIPT e especifique ANSI_CHARSET no lfCharSet membro das LOGFONT estrutura apontada pelo lpLogFont.
CF_BOTH Faz com que a caixa de diálogo Listar as fontes de impressora e tela disponíveis. O hDC membro identifica o dispositivo contexto (ou contexto de informações) associado à impressora. Este sinalizador é uma combinação dos sinalizadores CF_SCREENFONTS e CF_PRINTERFONTS.
CF_TTONLY Especifica que o ChooseFont só deve enumerar e permitem a seleção de tipos de letra TrueType.
CF_EFFECTS Faz com que a caixa de diálogo exibir os controles que permitem que o usuário especifique riscado, sublinhado e opções de cor de texto. Se este sinalizador estiver definido, você pode usar o membro rgbColors para especificar a cor do texto inicial. Você pode usar os membros de lfStrikeOut e lfUnderline o LOGFONT estrutura apontada pelo lpLogFont para especificar as configurações iniciais das caixas de seleção riscado e sublinhado. ChooseFont pode usar esses membros para retornar as seleções do usuário.
CF_ENABLEHOOK Permite que o procedimento gancho especificado na lpfnHook membro dessa estrutura.
CF_ENABLETEMPLATE Indica que o hInstance e lpTemplateName Membros especificar um modelo de caixa de diálogo para usar no lugar do modelo padrão.
CF_ENABLETEMPLATEHANDLE Indica que o hInstance membro identifica um bloco dados que contém um modelo caixa diálogo pré-carregadas. O sistema ignora o lpTemplateName membro se este sinalizador for especificado.
CF_FIXEDPITCHONLY Especifica que o ChooseFont deve selecionar fontes densidade apenas fixa.
CF_FORCEFONTEXIST Especifica que o ChooseFont deve indicar uma condição de erro se o usuário tentar selecionar uma fonte ou estilo que não existe.
CF_INITTOLOGFONTSTRUCT Especifica que o ChooseFont deve usar o LOGFONT estrutura apontada pelo lpLogFont membro para inicializar os controles de caixa de diálogo.
CF_LIMITSIZE Especifica que o ChooseFont deve selecionar apenas os tamanhos de fonte dentro do intervalo especificado pelos membros nSizeMin e nSizeMax.
CF_NOOEMFONTS Mesmo que o sinalizador CF_NOVECTORFONTS.
CF_NOFACESEL Ao usar uma estrutura LOGFONT para inicializar os controles de caixa de diálogo, use este sinalizador para seletivamente impedir que a caixa de diálogo exibindo uma seleção inicial para a caixa de combinação de nome de tipo de letra. Isso é útil quando não há nenhum nome de fonte única que se aplica para a seleção de texto.
CF_NOSCRIPTSEL Desativa a caixa de combinação Script . Quando este sinalizador estiver definido, o membro lfCharSet a LOGFONT estrutura é definida como DEFAULT_CHARSET quando ChooseFont retorna. Este sinalizador é usado somente para inicializar a caixa de diálogo.
CF_NOSTYLESEL Ao usar uma estrutura LOGFONT para inicializar os controles de caixa de diálogo, use este sinalizador para seletivamente impedir que a caixa de diálogo exibindo uma seleção inicial para a caixa de combinação de estilo de fonte. Isso é útil quando não há nenhum estilo de fonte única que se aplica para a seleção de texto.
CF_NOSIZESEL Ao usar um estrutura de LOGFONT para inicializar os controles de caixa de diálogo, use este sinalizador para seletivamente impedir que a caixa de diálogo exibindo uma seleção inicial para a caixa de combinação de tamanho da fonte. Isso é útil quando não há nenhum tamanho de fonte única que se aplica para a seleção de texto.
CF_NOSIMULATIONS Especifica que ChooseFont não deveriam permitir gráficos simulações de fonte do dispositivo interface (GDI).
CF_NOVECTORFONTS Especifica que ChooseFont não deveriam permitir vetor seleções de fonte.
CF_NOVERTFONTS Faz com que a caixa de diálogo tipo de letra listar somente fontes orientadas horizontalmente.
CF_PRINTERFONTS Faz com que a caixa de diálogo lista apenas as fontes suportadas pela impressora associada com o contexto de dispositivo (ou contexto de informações) identificadas pelo membro hDC.
CF_SCALABLEONLY Especifica que o ChooseFont deve permitir somente a seleção de fontes escaláveis. (Fontes escaláveis incluem tipos de letra vector, fontes de impressora dimensionáveis, tipos de letra TrueType e dimensionados por outras tecnologias de fontes.)
CF_SCREENFONTS Faz com que a caixa de diálogo listar apenas as fontes de tela suportadas pelo sistema de.
CF_SCRIPTSONLY Especifica que o ChooseFont deveriam permitir seleção de fontes para todos os não-OEM e símbolo caracteres conjuntos, bem como o conjunto de caracteres ANSI. Isso substitui o valor CF_ANSIONLY.
CF_SELECTSCRIPT Quando especificado na entrada, apenas fontes com o conjunto de caracteres identificaram no membro lfCharSet a LOGFONT estrutura são exibidos. O usuário não poderá alterar a conjunto de caracteres especificado na caixa de combinação de Scripts.
CF_SHOWHELP Faz com que a caixa de diálogo Exibir no botão Ajuda . O hwndOwner membro deve especificar a janela para receber a HELPMSGSTRING registadas mensagens de caixa de diálogo envia quando o usuário clica no botão Ajuda.
CF_USESTYLE Especifica que os pontos de membro lpszStyle para um buffer que contém dados de estilo que ChooseFont deve usar para inicializar a caixa de combinação de fontedeestilo . Quando o usuário fecha a caixa de diálogo, de cópias de ChooseFont estilo dados para a seleção do usuário para esse buffer .
CF_WYSIWYG Especifica que o ChooseFont deve permitir apenas a seleção de fontes disponíveis na impressora e visor. Se este sinalizador for especificado, os sinalizadores CF_BOTH e CF_SCALABLEONLY também devem ser especificados.

rgbColors
Se o sinalizador CF_EFFECTS for definido, rgbColors especifica a cor do texto inicial. Quando ChooseFont retorna com êxito, esse membro contém o valor RGB da cor do texto do usuário selecionado.
lCustData
Especifica dados application-defined que o sistema passa para o procedimento gancho identificado pelo lpfnHook membro. Quando o sistema envia o WM_INITDIALOG mensagem para o procedimento gancho, lParam parâmetro a mensagem é que um ponteiro para a estrutura CHOOSEFONT especificado quando o diálogo foi criado. O procedimento de gancho pode usar esse ponteiro para obter o valor de lCustData.
lpfnHook
Ponteiro para um CFHookProc procedimento gancho que pode mensagens processo destinadas a caixa de diálogo. Esse membro é ignorado a menos que o sinalizador CF_ENABLEHOOK é definido na sinalizadores membro.
lpTemplateName
Ponteiro para uma seqüência de caracteres null-terminated que nomeia o recurso de modelo caixa diálogo no módulo identificado pelo hInstance membro. Este modelo é substituído para o padrão modelo caixa diálogo. Para recursos de caixa de diálogo numerada, lpTemplateName pode ser um valor retornado pela MAKEINTRESOURCE macro. Esse membro é ignorado a menos que o sinalizador CF_ENABLETEMPLATE é definido na sinalizadores membro.
hInstance
Se o sinalizador CF_ENABLETEMPLATEHANDLE é definido na sinalizadores membro, hInstance é o identificador de um objeto de memória que contém um modelo caixa diálogo. Se o sinalizador CF_ENABLETEMPLATE for definido, hInstance identifica um módulo que contém um modelo de caixa de diálogo nomeado pela lpTemplateName membro. Se nem o CF_ENABLETEMPLATEHANDLE nem CF_ENABLETEMPLATE é definida, esse membro será ignorado.
lpszStyle
Ponteiro para um buffer que contém dados de estilo. Se o sinalizador CF_USESTYLE for especificada, o ChooseFont usa os dados nesse buffer para inicializar a caixa de combinação de estilo de fonte. Quando o usuário fecha a caixa de diálogo, ChooseFont copia a Cadeia de caracteres na caixa de combinação de estilo de fonte para esse buffer.
nFontType
Especifica o tipo da fonte selecionada quando ChooseFont retorna. Esse membro pode ser uma combinação dos seguintes valores:
Valor Significado
BOLD_FONTTYPE A espessura da fonte está em negrito. Este informações são duplicadas no membro lfWeight do LOGFONT estrutura e é equivalente a FW_BOLD.
ITALIC_FONTTYPE O atributo de fonte em itálico é definido. Este informações são duplicadas no membro lfItalic a estrutura de LOGFONT.
PRINTER_FONTTYPE A fonte é uma fonte de impressora.
REGULAR_FONTTYPE A espessura da fonte é normal. Esta informação é duplicada na lfWeight membro da estrutura LOGFONT e é equivalente a FW_REGULAR.
SCREEN_FONTTYPE A fonte é uma fonte de tela.
SIMULATED_FONTTYPE A fonte é simulada pela interface dispositivo gráfico (GDI).

nSizeMin
Especifica o tamanho mínimo que um usuário pode selecionar. ChooseFont reconhece este membro somente se o sinalizador CF_LIMITSIZE for especificada.
nSizeMax
Especifica o tamanho máximo que um usuário pode selecionar. ChooseFont reconhece este membro somente se o sinalizador CF_LIMITSIZE for especificada.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declaradas no commdlg.h.
Unicode:Definidos como estruturas ANSI e Unicode.

Ver também

Visão geral de biblioteca de caixa de diálogo comum, estruturas de caixa de diálogo comuns, ChooseFont, LOGFONT, MAKEINTRESOURCE

Index