TVOT_LISTBOX
Importante
A plataforma de impressão moderna é o meio preferencial do Windows para se comunicar com as impressoras. Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft juntamente com PSA (Aplicativos de Suporte à Impressão) 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 Plataformade impressão moderna e o Guia de design do aplicativo de suporte de impressão.
O tipo de opção TVOT_LISTBOX consiste em uma caixa de listagem dentro de uma caixa de grupo.
Estrutura OPTITEM
Sel/pSel
Índice na matriz OPTPARAM que é apontada pelo membro pOptParam 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 string de texto a ser exibida na caixa de listagem. pOptParam[1]->pData aponta para a segunda string de texto a ser exibida na caixa de listagem. pOptParam[n]->pData aponta para a nª string de texto a ser exibida na caixa de listagem.
IconID
pOptParam[0]->IconID identifica um ícone a ser associado à primeira cadeia de caracteres de texto. pOptParam[1]->IconID identifica um ícone a ser associado à segunda cadeia de caracteres de texto. pOptParam[n]->IconID identifica um ícone a ser associado à nª cadeia de caracteres de texto.
lParam
Não usado.
Estrutura OPTTYPE
Tipo
TVOT_LISTBOX
Count
O número de estruturas OPTPARAM; ou seja, o número de cadeias de caracteres de texto a serem exibidas na caixa de listagem.
Estilo
Os seguintes sinalizadores de bits opcionais podem ser especificados.
| Sinalizador | Descrição |
|---|---|
| OTS_LBCB_INCL_ITEM_NONE | Se definido, o CPSUI incluirá uma cadeia de caracteres "Nenhuma" na caixa de listagem. Se um usuário selecionar "None", a união Sel/pSel será definida como menos um. |
| 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 é de exibição de árvore, 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 caracteres de texto em ordem alfabética. |
BegCtrlID
Se pDlgPage em COMPROPSHEETUI iidentificar 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 do controle | Controle do Windows |
|---|---|
| Conteúdo do BegCtrlID | Caixa de grupo |
| Conteúdo+1 do BegCtrlID | Texto do título |
| Conteúdo+2 do BegCtrlID | Caixa de listagem |
| Conteúdo+3 do BegCtrlID | Ícone da caixa de listagem |
| Conteúdo+4 do BegCtrlID | Caixa de seleção estendida ou botão estendido (opcional) |
| Conteúdo+5 do BegCtrlID | Caixa de seleção estendida ou ícone do botão estendido (opcional) |
Para obter mais informações, consulte Personalizando controles de janela com suporte para CPSUI.
Requisitos
Cabeçalho: compstui.h (incluir Compstui.h)