Controle CONTROL

Define um controle definido pelo usuário.

CONTROL text, id, class, style, x, y, width, height [, extended-style]

Classe

Nome redefinido, cadeia de caracteres ou um valor inteiro sem sinal de 16 bits que define a classe . Pode ser qualquer uma das classes de controle; para obter uma lista das classes de controle, consulte a primeira lista seguindo esta descrição. Se o valor for um nome redefinido fornecido pelo aplicativo, ele deverá ser uma cadeia de caracteres entre aspas duplas (").

Estilo

Nome redefinido ou valor inteiro que especifica o estilo do controle fornecido. O significado exato do estilo depende do valor da classe . As seções que seguem esta descrição mostram as classes de controle e os estilos correspondentes.

Para obter mais informações sobre a sintaxe geral de uma instrução de controle, consulte Parâmetros de controle comuns.

Comentários

As seis classes de controle possíveis são descritas nas seções a seguir.

A classe de controle button

Um controle de botão é uma pequena janela filho retangular que o usuário pode ativar ou desativar clicando nele com o mouse. Os controles de botão podem ser usados sozinhos ou em grupos e podem ser rotulados ou exibidos sem texto. Os controles de botão normalmente alteram a aparência quando o usuário clica neles.

Os estilos de botão são descritos no seguinte tópico: Estilos de botão.

A classe de controle Caixa de Combinação

Os controles de caixa de combinação consistem em um campo de seleção semelhante a um controle de edição mais uma caixa de listagem. A caixa de listagem pode ser exibida em todos os momentos ou pode ser descartada quando o usuário seleciona uma "caixa pop" ao lado do campo de seleção.

Dependendo do estilo da caixa de combinação, o usuário pode ou não editar o conteúdo do campo de seleção. Se a caixa de listagem estiver visível, digitar caracteres na caixa de seleção fará com que a primeira entrada que corresponde aos caracteres digitados seja realçada. Por outro lado, selecionar um item na caixa de listagem exibe o texto selecionado no campo de seleção.

Os estilos de controle de caixa de combinação são descritos no seguinte tópico: Estilos de caixa de combinação.

A classe editar controle

Um controle de edição é uma janela filho retangular na qual o usuário pode inserir texto do teclado. O usuário seleciona o controle e dá a ele o foco de entrada, clicando no mouse dentro dele ou pressionando a tecla TAB. O usuário pode inserir texto quando o controle exibe um ponto de inserção piscando. O mouse pode ser usado para mover o cursor e selecionar caracteres a serem substituídos ou para posicionar o cursor para inserir caracteres. A chave BACKSPACE pode ser usada para excluir caracteres.

Os controles de edição usam a fonte de tom fixo e exibem caracteres Unicode. Eles expandem caracteres de guia para quantos caracteres de espaço forem necessários para mover o cursor para a próxima parada de tabulação. Presume-se que as paradas de tabulação estejam em cada posição de oitavo caractere.

Os estilos de controle de edição são descritos no seguinte tópico: Editar Estilos de Controle.

A classe de controle List Box

Os controles de caixa de listagem consistem em uma lista de cadeias de caracteres. O controle é usado sempre que um aplicativo precisa apresentar uma lista de nomes, como nomes de arquivo, que o usuário pode exibir e selecionar. O usuário pode selecionar uma cadeia de caracteres apontando para a cadeia de caracteres com o mouse e clicando em um botão do mouse. Quando uma cadeia de caracteres é selecionada, ela é realçada e uma mensagem de notificação é passada para a janela pai. Uma barra de rolagem pode ser usada com um controle de caixa de listagem para rolar listas muito longas ou muito largas para a janela de controle.

Os estilos de controle de caixa de listagem são descritos no seguinte tópico: Estilos de caixa de listagem.

A classe de controle Scroll-Bar

Um controle de barra de rolagem é um retângulo que contém um polegar de rolagem e tem setas de direção em ambas as extremidades. A barra de rolagem envia uma mensagem de notificação para seu pai sempre que o usuário clica no mouse no controle. O pai é responsável por atualizar a posição do polegar, se necessário. Os controles de barra de rolagem têm a mesma aparência e função que as barras de rolagem usadas em janelas comuns. Mas, ao contrário das barras de rolagem, os controles de barra de rolagem podem ser posicionados em qualquer lugar dentro de uma janela e usados sempre que necessário para fornecer entrada de rolagem para uma janela.

Os estilos de barra de rolagem são descritos no seguinte tópico: Estilos de controle de barra de rolagem.

A classe de controle estático

Controles estáticos são campos de texto simples, caixas e retângulos que podem ser usados para rotular, caixa ou separar outros controles. Os controles estáticos não recebem nenhuma entrada e não fornecem nenhuma saída.

Os estilos de controle estático são descritos no seguinte tópico: Estilos de controle estático.