OBJECT SET STYLE SHEET

OBJECT SET STYLE SHEET ( {* ;} objeto ; nomFolhaEstilo )

Parâmetro	Tipo		Descrição
*	Operador	→	Se especificado, objeto é um nome de objeto (cadeia) Se omitido, objeto é um campo ou uma variável
objeto	any	→	Nome de objeto (se * for especificado) ou Campo ou variável (se * for omitido)
nomFolhaEstilo	Text	→	Nome da folha de estilo

Esse comando não é seguro para thread e não pode ser usado em código adequado.

Descrição

O comando OBJECT SET STYLE SHEET modifica, para o processo atual, a folha de estilo associada ao objeto(s) designado(s) pelos parâmetros objeto e * . Uma folha de estilo modifica a fonte, o tamanho de fonte e o estilo de fonte.

Ao passar o parâmetro opcional * se indica que o parâmetro objeto é um nome de objeto (cadeia). Se não passar este parâmetro, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, passa uma referência de campo ou variável no lugar de uma cadeia (campo ou variável objeto unicamente).

Passe no parâmetro nomFolhaEstilo, o nome da folha de estilo a aplicar ao objeto. Também pode passar:

• O nome de uma folha de estilos existente (se a folha de estilo não existe, se devolve um erro, que pode interceptar utilizando um método instalado pelo comando ON ERR CALL).
• Uma cadeia vazia ("") para não aplicar a folha destilo e ao objeto.
• uma das constantes a seguir encontradas no tema "Estilos de fonte" para aplicar a folha de estilos automática:
  | Constante | Tipo | Valor | Comentário |
  | --------------------------------- | ------ | ----------------------------------- | ---------------------------------------------------------------------------------------------------------- |
  | Automatic style sheet | Cadeia | __automatic__ | Usado como padrão para todos os objetos |
  | Automatic style sheet_additional | Cadeia | __automatic_additional_text__ | Suportado por texto estático, campos e variaáveis somente. Usado para texto adicional em caixas de diálogo |
  | Automatic style sheet_main | Cadeia | __automatic_main_text__ | Suportado apenas para texto estático, campos e variáveis. Usado para texto principal em caixas de diálogo. |

Se uma folha de estilo já tinha sido associada ao objeto em modo Desenho, a chamada deste comando a substitui para o processo atual.

Se durante a sessão, utiliza os comandos ST SET ATTRIBUTES, ST SET TEXT ou OBJECT SET FONT, OBJECT SET FONT SIZE no objeto com o propósito de modificar sua fonte ou o tamanho de fonte, a referência a folha de estilos se apaga automaticamente do objeto - inclusive se atribui os mesmos atributos que os da folha de estilos. No entanto, se modificar o estilo (negrito, cursiva, etc.), por exemplo com os comandos ST SET ATTRIBUTES ou OBJECT SET FONT STYLE, se adicionam estas novas propriedades a folha de estilo pela duração da sessão.

Nota de compatibilidade

Em arquitetura de projeto, só as três folhas de estilo automáticas são compatíveis com esse comando

Ver também

Estilos de fonte
GET STYLE SHEET INFO
LIST OF STYLE SHEETS
OBJECT Get style sheet