Funções de objeto

Este tópico descreve os valores constantes usados para descrever as funções de vários objetos de interface do usuário em um aplicativo. As constantes de função são definidas no arquivo Oleacc.h.

Você deve usar apenas as constantes de função listadas aqui; não adicione funções personalizadas ou funções que não são predefinidas.

Antes de usar essas funções de objeto, os desenvolvedores de aplicativos cliente devem usar a ferramenta Inspecionar para verificar se as funções de objeto estão sendo usadas por elementos da interface do usuário.

Para recuperar a função de um objeto, os clientes chamam o método IAccessible::get_accRole , que deve retornar um dos valores descritos na tabela. Para recuperar uma cadeia de caracteres localizada que descreve a função do objeto, os clientes chamam a função GetRoleText com o valor da função. As cadeias de caracteres localizadas para os valores de função estão no arquivo oleaccrc.dll.

Constante	Descrição
ROLE_SYSTEM_ALERT	O objeto representa um alerta ou uma condição sobre a qual um usuário deve ser notificado. Essa função é usada apenas para objetos que incorporam um alerta, mas não estão associados a outro elemento de interface do usuário, como uma caixa de mensagem, elemento gráfico, texto ou som.
ROLE_SYSTEM_ANIMATION	O objeto representa um controle de animação cujo conteúdo muda ao longo do tempo, como um controle que exibe uma série de quadros bitmap. Os controles de animação são exibidos quando os arquivos são copiados ou quando alguma outra tarefa demorada é executada.
ROLE_SYSTEM_APPLICATION	O objeto representa uma janela main para um aplicativo.
ROLE_SYSTEM_BORDER	O objeto representa uma borda de janela. Toda a borda é representada por um único objeto em vez de por objetos separados para cada lado.
ROLE_SYSTEM_BUTTONDROPDOWN	O objeto representa um botão que expande uma lista de itens.
ROLE_SYSTEM_BUTTONDROPDOWNGRID	O objeto representa um botão que expande uma grade.
ROLE_SYSTEM_BUTTONMENU	O objeto representa um botão que expande um menu.
ROLE_SYSTEM_CARET	O objeto representa o cursor do sistema.
ROLE_SYSTEM_CELL	O objeto representa uma célula dentro de uma tabela.
ROLE_SYSTEM_CHARACTER	O objeto representa um objeto gráfico semelhante a um desenho animado, como o Assistente do Microsoft Office, que é exibido para fornecer ajuda aos usuários de um aplicativo.
ROLE_SYSTEM_CHART	O objeto representa uma imagem gráfica usada para mapear dados.
ROLE_SYSTEM_CHECKBUTTON	O objeto representa um controle de caixa marcar: uma opção selecionada ou desmarcada independentemente de outras opções.
ROLE_SYSTEM_CLIENT	O objeto representa a área de cliente de uma janela. A Acessibilidade Ativa da Microsoft usará essa função como padrão se houver uma pergunta sobre a função de um elemento de interface do usuário.
ROLE_SYSTEM_CLOCK	O objeto representa um controle que exibe o tempo.
ROLE_SYSTEM_COLUMN	O objeto representa uma coluna de células dentro de uma tabela.
ROLE_SYSTEM_COLUMNHEADER	O objeto representa um cabeçalho de coluna, fornecendo um rótulo visual para uma coluna em uma tabela.
ROLE_SYSTEM_COMBOBOX	O objeto representa uma caixa de combinação: um controle de edição com uma caixa de listagem associada que fornece um conjunto de opções predefinidas.
ROLE_SYSTEM_CURSOR	O objeto representa o ponteiro do mouse do sistema.
ROLE_SYSTEM_DIAGRAM	O objeto representa uma imagem gráfica usada para diagramar dados.
ROLE_SYSTEM_DIAL	O objeto representa um botão ou discagem.
ROLE_SYSTEM_DIALOG	O objeto representa uma caixa de diálogo ou caixa de mensagem.
ROLE_SYSTEM_DOCUMENT	O objeto representa uma janela de documento. Uma janela de documento está sempre contida em uma janela do aplicativo. Essa função se aplica apenas a janelas MDI e refere-se ao objeto que contém a barra de título MDI.
ROLE_SYSTEM_DROPLIST	O objeto representa o controle de calendário, SysDateTimePick32. O componente de runtime do Microsoft Active Accessibility usa essa função para indicar que uma data ou um controle de calendário foi encontrado.
ROLE_SYSTEM_EQUATION	O objeto representa uma equação matemática.
ROLE_SYSTEM_GRAPHIC	O objeto representa uma imagem.
ROLE_SYSTEM_GRIP	O objeto representa um ponteiro especial do mouse que permite que um usuário manipule elementos de interface do usuário, como janelas. Um exemplo disso envolve redimensionar uma janela arrastando seu canto inferior direito.
ROLE_SYSTEM_GROUPING	O objeto agrupa logicamente outros objetos. Nem sempre há uma relação pai-filho entre o objeto de agrupamento e os objetos que ele contém.
ROLE_SYSTEM_HELPBALLOON	O objeto exibe um tópico de ajuda na forma de uma dica de ferramenta ou balão de ajuda.
ROLE_SYSTEM_HOTKEYFIELD	O objeto representa um campo de atalho de teclado que permite que o usuário insira uma combinação ou sequência de pressionamentos de tecla.
ROLE_SYSTEM_INDICATOR	O objeto representa um indicador, como um gráfico de ponteiro, que aponta para o item atual.
ROLE_SYSTEM_IPADDRESS	O objeto representa um controle de edição projetado para um endereço IP. O controle de edição é dividido em seções, cada uma para uma parte específica do endereço IP.
ROLE_SYSTEM_LINK	O objeto representa um link para outra coisa. Esse objeto pode parecer um texto ou um gráfico, mas funciona como um botão.
ROLE_SYSTEM_LIST	O objeto representa uma caixa de listagem, permitindo que o usuário selecione um ou mais itens.
ROLE_SYSTEM_LISTITEM	O objeto representa um item em uma caixa de listagem ou na parte de lista de uma caixa de combinação, caixa de listagem suspensa ou caixa de combinação suspensa.
ROLE_SYSTEM_MENUBAR	O objeto representa a barra de menus (posicionada abaixo da barra de título de uma janela) da qual os usuários selecionam menus.
ROLE_SYSTEM_MENUITEM	O objeto representa um item de menu: uma entrada de menu que o usuário pode optar por executar um comando, selecionar uma opção ou exibir outro menu. Funcionalmente, um item de menu é equivalente a um botão de push, um botão de opção, uma caixa de marcar ou um menu.
ROLE_SYSTEM_MENUPOPUP	O objeto representa um menu: uma lista de opções, cada uma com uma ação específica. Todos os tipos de menu devem ter função, incluindo os menus suspensos que são exibidos quando selecionados em uma barra de menus; e menus de atalho, que são exibidos clicando no botão direito do mouse.
ROLE_SYSTEM_OUTLINE	O objeto representa um contorno ou uma estrutura de árvore, como um controle de exibição de árvore, que exibe uma lista hierárquica e permite que o usuário expanda e recolha branches.
ROLE_SYSTEM_OUTLINEBUTTON	O objeto representa um item que navega como um item de estrutura de tópicos. As teclas SETA PARA CIMA e SETA PARA BAIXO são usadas para navegar pela estrutura de tópicos. No entanto, em vez de expandir e recolhimento quando a tecla LEFT e SETA para a direita é pressionada, esses menus se expandem ou recolhiam quando a tecla SPACEBAR ou ENTER é pressionada e o item tem foco.
ROLE_SYSTEM_OUTLINEITEM	O objeto representa um item em uma estrutura de estrutura ou estrutura de árvore.
ROLE_SYSTEM_PAGETAB	O objeto representa uma guia de página. O único filho de um controle guia de página é um objeto ROLE_SYSTEM_GROUPING que tem o conteúdo da página associada.
ROLE_SYSTEM_PAGETABLIST	O objeto representa um contêiner de controles de guia de página.
ROLE_SYSTEM_PANE	O objeto representa um painel dentro de um quadro ou uma janela de documento. Os usuários podem navegar entre os painéis e dentro do conteúdo do painel atual, mas não podem navegar entre itens de diferentes painéis. Portanto, os painéis representam um nível de agrupamento menor que quadros ou janelas de documento, mas maior que os controles individuais. O usuário navega entre os painéis pressionando TAB, F6 ou CTRL+TAB, dependendo do contexto.
ROLE_SYSTEM_PROGRESSBAR	O objeto representa uma barra de progresso, que mostra dinamicamente quanto de uma operação em andamento foi concluída. Esse controle não usa nenhuma entrada do usuário.
ROLE_SYSTEM_PROPERTYPAGE	O objeto representa uma folha de propriedades.
ROLE_SYSTEM_PUSHBUTTON	O objeto representa um controle de botão de pressão.
ROLE_SYSTEM_RADIOBUTTON	O objeto representa um botão de opção (anteriormente, um botão de opção). É uma de um grupo de opções mutuamente exclusivas. Todos os objetos que compartilham o mesmo pai e que têm esse atributo são considerados parte de um único grupo mutuamente exclusivo. Para dividir esses objetos em grupos separados, use ROLE_SYSTEM_GROUPING objetos.
ROLE_SYSTEM_ROW	O objeto representa uma linha de células dentro de uma tabela.
ROLE_SYSTEM_ROWHEADER	O objeto representa um cabeçalho de linha, que fornece um rótulo visual para uma linha de tabela.
ROLE_SYSTEM_SCROLLBAR	O objeto representa uma barra de rolagem vertical ou horizontal, que faz parte da área do cliente ou é usada em um controle.
ROLE_SYSTEM_SEPARATOR	O objeto é usado para dividir visualmente um espaço em duas regiões. Exemplos de objetos separadores incluem um item de menu separador e uma barra que divide painéis divididos dentro de uma janela.
ROLE_SYSTEM_SLIDER	O objeto representa um controle deslizante, que permite que o usuário ajuste uma configuração em incrementos específicos entre valores mínimos e máximos.
ROLE_SYSTEM_SOUND	O objeto representa um som do sistema, que está associado a vários eventos do sistema.
ROLE_SYSTEM_SPINBUTTON	O objeto representa uma caixa de rotação, que é um controle que permite que o usuário incremente ou decremente o valor exibido em um controle "buddy" separado associado à caixa de rotação.
ROLE_SYSTEM_SPLITBUTTON	O objeto representa um botão em uma barra de ferramentas que tem um ícone de lista suspensa que é diretamente adjacente ao botão.
ROLE_SYSTEM_STATICTEXT	O objeto representa texto somente leitura, como rótulos para outros controles ou instruções em uma caixa de diálogo. Não é possível modificar ou selecionar texto estático.
ROLE_SYSTEM_STATUSBAR	O objeto representa uma barra de status, que é uma área na parte inferior de uma janela e que exibe informações sobre a operação atual, o estado do aplicativo ou o objeto selecionado. A barra de status tem vários campos, que exibem diferentes tipos de informações.
ROLE_SYSTEM_TABLE	O objeto representa uma tabela que contém linhas e colunas de células e, opcionalmente, cabeçalhos de linha e cabeçalhos de coluna.
ROLE_SYSTEM_TEXT	O objeto representa um texto selecionável que permite edições ou é designado como somente leitura.
ROLE_SYSTEM_TITLEBAR	O objeto representa um título ou uma barra de legenda para uma janela.
ROLE_SYSTEM_TOOLBAR	O objeto representa uma barra de ferramentas, que é um agrupamento de controles que fornece acesso fácil a recursos usados com frequência.
ROLE_SYSTEM_TOOLTIP	O objeto representa uma dica de ferramenta que fornece dicas úteis.
ROLE_SYSTEM_WHITESPACE	O objeto representa espaço em branco entre outros objetos.
ROLE_SYSTEM_WINDOW	O objeto representa o quadro de janela, que contém objetos filho, como uma barra de título, um cliente e outros objetos de uma janela.

Requisitos

Requisito	Valor
parâmetro	Oleacc.h