TVOT_LISTBOX

Artigo
03/08/2023

Importante

Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft, juntamente com aplicativos de suporte de impressão (PSA), para personalizar a experiência de impressão em 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 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
Indexe na matriz OPTPARAM 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 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 nª cadeia de caracteres 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 sinalizadores de bits opcionais a seguir podem ser especificados.

Sinalizador	Descrição
OTS_LBCB_INCL_ITEM_NONE	Se definido, CPSUI inclui uma cadeia de caracteres "Nenhum" 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 desenhará 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 não treeview, ela é exibida como uma caixa de combinação em vez de uma caixa de listagem.
OTS_LBCB_SORT	Se definido, CPSUI exibirá cadeias de caracteres de texto em ordem alfabética.

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

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