Caixa de entrada

Exibe uma solicitação numa caixa de diálogo, aguarda que o utilizador introduza texto ou clique num botão e devolve o conteúdo da caixa de texto.

Estrutura

InputBox(prompt[, título][, valor_padrão][, xpos][, ypos][, ficheiro_de_ajuda, contexto])

Parâmetros

mensagem - Expressão de cadeia de caracteres apresentada como mensagem na caixa de diálogo. O comprimento máximo do prompt é de aproximadamente 1024 caracteres, dependendo da largura dos caracteres utilizados. Se o prompt tiver mais do que uma linha, pode separar as linhas utilizando um carácter de retorno de carro (Chr(13)), um carácter de avanço de linha (Chr(10)) ou uma combinação de caracteres de retorno de carro e avanço de linha (Chr(13) & Chr(10)) entre cada linha.

título - Expressão de cadeia de caracteres exibida na barra de título da caixa de diálogo. Se não indicar um título, o nome da aplicação será colocado na barra de título.

padrão - Expressão de cadeia de caracteres apresentada na caixa de texto como resposta padrão, caso não seja introduzida qualquer outra informação. Se não especificar um valor por defeito, a caixa de texto é apresentada vazia.

xpos - Expressão numérica que especifica, em twips, a distância horizontal entre a margem esquerda da caixa de diálogo e a margem esquerda do ecrã. Se o parâmetro xpos for omitido, a caixa de diálogo é centrada horizontalmente.

ypos - Expressão numérica que especifica, em twips, a distância vertical entre a borda superior da caixa de diálogo e a parte superior do ecrã. Se o parâmetro ypos for omitido, a caixa de diálogo é posicionada verticalmente a cerca de um terço da altura do ecrã.

helpfile - Expressão de cadeia de caracteres que identifica o ficheiro de Ajuda a utilizar para fornecer Ajuda contextual à caixa de diálogo. Se for fornecido um ficheiro de ajuda, também deve ser fornecido o contexto.

contexto - Expressão numérica que identifica o número de contexto da Ajuda atribuído pelo autor da Ajuda ao tópico de Ajuda correspondente. Se for fornecido o contexto, também deve ser fornecido o ficheiro de ajuda.

Descrição

Quando tanto o ficheiro de ajuda como o contexto são fornecidos, é automaticamente adicionado um botão «Ajuda» à caixa de diálogo.

Se o utilizador clicar em OK ou premir a tecla ENTER, a função InputBox devolve o conteúdo da caixa de texto. Se o utilizador clicar em Cancelar, a função devolve uma cadeia de caracteres de comprimento zero ('').

Exemplo

O exemplo seguinte utiliza a função InputBox para apresentar uma caixa de entrada e atribuir a cadeia de caracteres à variável Input:

Dim Input

Input = InputBox("Introduza o seu nome")

MsgBox("Introduziu: " & Input) |