Partilhar via


TVOT_LISTBOX

Importante

A moderna plataforma de impressão é o meio preferido do Windows para comunicar com as impressoras. Recomendamos que utilize o controlador de classe da caixa de entrada IPP da Microsoft, juntamente com as Aplicações de Suporte de Impressão (PSA), para personalizar a experiência de impressão no Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.

Para obter mais informações, consulte o guia de design do aplicativo de suporte Print.

O tipo de opção TVOT_LISTBOX consiste em uma caixa de listagem dentro de uma caixa de grupo.

Estrutura OPTITEM

Sel/pSel
Indexe na matriz deOPTPARAMapontada pelo pOptParam membro da estrutura OPTTYPE da opção. Isso especifica o parâmetro de opção selecionado no momento.

Matriz de estrutura OPTPARAM (membro pOptParam de OPTTYPE)

pData
pOptParam[0]->pData aponta para a primeira cadeia de caracteres de texto a ser exibida na caixa de listagem. pOptParam[1]->pData aponta para a segunda cadeia de caracteres de texto a ser exibida na caixa de listagem. pOptParam[n]->pData aponta para a nth string de texto a ser exibida na caixa de listagem.

IconID
pOptParam[0]->IconID identifica um ícone a ser associado à primeira cadeia de texto. pOptParam[1]->IconID identifica um ícone a ser associado à segunda cadeia de texto. pOptParam[n]->IconID identifica um ícone a ser associado à nth string de texto.

lParam
Não utilizado.

Estrutura OPTTYPE

Tipo
TVOT_LISTBOX

Contagem
O número de estruturas OPTPARAM; ou seja, o número de cadeias de texto a serem exibidas na caixa de listagem.

Estilo
Os seguintes sinalizadores de bits opcionais podem ser especificados.

Bandeira Descrição
OTS_LBCB_INCL_ITEM_NONE Se definido, o CPSUI inclui uma cadeia de caracteres "Nenhuma" na caixa de listagem. Se um usuário selecionar "Nenhum", a união Sel/pSel será definida como negativa.
OTS_LBCB_NO_ICON16_IN_ITEM Se definido, o CPSUI não desenha o ícone de cada parâmetro de opção (IconID em OPTPARAM) ao exibir o valor do parâmetro na caixa de listagem.
OTS_LBCB_PROPPAGE_LBUSECB Quando a opção é exibida em uma página de folha de propriedades que não é treeview, ela é exibida como uma caixa de combinação em vez de uma caixa de listagem.
OTS_LBCB_SORT Se definido, o CPSUI exibe cadeias de texto em ordem alfabética.

BegCtrlID
Se pDlgPage em COMPROPSHEETUI identificar uma página fornecida pelo CPSUI ou se DlgTemplateID em DLGPAGE identificar um modelo fornecido pelo CPSUI, BegCtrlID não será usado. Caso contrário, BegCtrlID deve conter o primeiro identificador de controle de um conjunto numerado sequencialmente de identificadores de controle. Os identificadores de controle devem identificar os seguintes controles do Windows:

Identificador de controle Controlo do Windows
BegCtrlID conteúdo Caixa de grupo
BegCtrlID conteúdo+1 Texto do título
BegCtrlID conteúdo+2 Caixa de listagem
BegCtrlID conteúdo+3 Ícone da caixa de listagem
BegCtrlID conteúdo+4 Caixa de seleção estendida ou botão de pressão estendido (opcional)
BegCtrlID conteúdo+5 Caixa de seleção estendida ou ícone de botão estendido (opcional)

Para obter informações adicionais, consulte Personalizando controles de janela CPSUI-Supported.

Requerimentos

Cabeçalho: compstui.h (incluir Compstui.h)

Ver também

OPTITEM

OPTPARAM

OPTTYPE