
Classe: TSrvObjectClasse abstrata herdada por todos os componentes visuais ClassName<p>Retorna o nome da classe.</p>TSrvObject(): ClassName ( ) --> cClasse cClasse(caracter)- Retorna o nome da classe.
oObject:ClassName() // Result: "TButton" CoorsUpdate<p>Atualiza o posicionamento (vertical superior, horizontal esquerda, vertical inferior e horizontal direita) do objeto.</p>TSrvObject(): CoorsUpdate ( ) --> Disable<p>Desabilita o objeto.</p>TSrvObject(): Disable ( ) --> Enable<p>Habilita o objeto.</p>TSrvObject(): Enable ( ) --> FreeChildren<p>Elimina/Libera todos os objetos da classe onde este método é chamado.</p>TSrvObject(): FreeChildren ( ) --> GetClientRectRetorna as coordenadas de posicionamento e dimensão (vertical superior, horizontal à esquerda, vertical inferior e horizontal à direita) do objeto.TSrvObject(): GetClientRect ( ) --> aCoords aCoords()- Retorna um array com as coordenadas de posicionamento e dimensão (vertical superior, horizontal esquerda, vertical inferior e horizontal direita) do objeto.
O retorno é o valor real do objeto criado, que na verdade é diferente do parâmetro da criação. Isso porque o sistema sempre duplica os valores passados no momento da criação. oObject:GetClientRect() // Result: {10,10,240,340} GetFont<p>Retorna a fonte do objeto.</p>TSrvObject(): GetFont ( ) --> oFont oFont()- Retorna o objeto do tipo TFont utilizado para definir as características da fonte aplicada na exibição do conteúdo do controle visual.
GetText<p>Retorna o título do objeto contido na propriedade cCaption.</p>TSrvObject(): GetText ( ) --> cCaption cCaption(caracter)- Retorna o título do objeto.
Hide<p>Torna o objeto invisível.</p>TSrvObject(): Hide ( ) --> hWHandle<p>Retorna o handle do objeto.</p>TSrvObject(): hWHandle ( ) --> nHdl nHdl()- Retorna o handle do objeto.
oObject:hWHandle() // Result: 3001 lCanGotFocus<p>Define se o objeto pode ou não receber foco.</p>TSrvObject(): lCanGotFocus ( < lFoco> ) --> Nome | Tipo | Descrição | Obrigatório | Referência | lFoco | Lógico | Indica se, verdadeiro (.T.), o objeto pode receber foco; caso contrário, falso (.F.). | X | |
Move<p>Move o objeto.</p>TSrvObject(): Move ( [ nTop], [ nLeft], [ nWidth], [ nHeight], [ uParam5], [ lRealCoords] ) --> Nome | Tipo | Descrição | Obrigatório | Referência | nTop | Numérico | Indica a posição ao topo. | | | nLeft | Numérico | Indica a posição à esquerda. | | | nWidth | Numérico | Indica a largura do objeto. | | | nHeight | Numérico | Indica a altura do objeto. | | | uParam5 | Qualquer | Compatibilidade | | | lRealCoords | Lógico | Indica se as bordas do objeto serão consideradas no cálculo de movimentação. | | |
oObject:Move(oObject:nTop,oObject:nLeft,498,250,,.T.) Owner<p>Retorna o objeto do tipo tWindow ou tDialog utilizado na criação desta classe.</p>TSrvObject(): Owner ( ) --> xObjeto xObjeto()- Retorna o objeto do tipo tWindow ou tDialog onde este foi criado.
Refresh<p>Atualiza as propriedades do objeto no TOTVS Smart Client.</p>TSrvObject(): Refresh ( ) --> SaveAsBMP<p>Salva uma cópia do objeto no formato Bitmap (*.BMP).</p>TSrvObject(): SaveAsBMP ( ) --> lOk lOk(logico)- Retorna verdadeiro (.T.), se a imagem for salva com sucesso; caso contrário, retorna falso (.F.).
oObject:SaveAsBMP("c:\Dir\Imagem.BMP") SetColor<p>Define as cores do objeto.</p>TSrvObject(): SetColor ( [ nClrFore], [ nClrBack] ) --> Nome | Tipo | Descrição | Obrigatório | Referência | nClrFore | Numérico | Indica a cor da fonte. | | | nClrBack | Numérico | Indica a cor de fundo do objeto. | | |
oObject:SetColor(CLR_BLACK,CLR_WHITE) SetCoors<p>Define as coordenadas (à esquerda, ao topo, largura e altura) do objeto utilizando a classe TRect.</p>TSrvObject(): SetCoors ( < oRect> ) --> Nome | Tipo | Descrição | Obrigatório | Referência | oRect | Objeto | Indica o objeto do tipo TRect é utilizado para definir as coordenadas. | X | |
Para mais informações sobre a parametrização, consulte a documentação da classe TRect. oRect := TRect():New(32,2,100,100)oObject:SetCoors(oRect) SetCSS Aplica estilo no objeto utilizando o CSS (Cascading Style Sheets)
SintaxeTSrvObject(): SetCSS ( < cCssText> ) --> Nil
|
Parâmetros/ElementosNome | Tipo | Descrição | Obrigatório | Referência |
---|
cCSS | Caracter | Indica o texto com formato CSS para o objeto. | X | |
RetornoNil (Nulo) ObservaçõesO guia de estilo é de propriedade da Qt Company, e pode ser consultado no link: http://qt-project.org/doc/qt-4.8/stylesheet-examples.html. Para a aplicação do estilo é necessário associar o componente ADVPL ao seu equivalente Qt, conforme tabela abaixo: ExemplooButton1 := TButton():New( 002, 002, "Botão 01",oDlg,{|| alert("Botão 01") }, 40,10,,,.F.,.T.,.F.,,.F.,,,.F. )
oButton1:SetCss("QPushButton:pressed { background-color: qlineargradient(x1: 0, y1: 0, x2: 0, y2: 1, stop: 0 #dadbde, stop: 1 #f6f7fa); }")
|
Tabela de componentes (DePara). Válida para SmartClient 131227A ou superior.Componente ADVPL | Equivalente Qt |
---|
TButton SButton TBrowseButton TBtnBmp TBtnBmp2 THButton | QPushButton | TCBrowse BrGetDDb MsBrGetDBase MsSelBr TSBrowse TWBrowse VCBrowse | QTableWidget | TCColumn | QTableWidgetItem | TCheckBox | QCheckBox | TComboBox | QComboBox | TFolder | QTabBar | TGet | QLineEdit | TGrid | QTableView | TGroup | QGroupBox | TListBox | QListWidget | TMeter | QProgressBar | TMsgBar | QStatusBar | TMsgItem | QLabel | TMultiGet | QTextEdit | TPanel | QLabel | TRadMenu | QRadioButton | TSay | QLabel | TScrollArea TScrollBox | QScrollArea | TSimpleEditor | QTextEdit | TSlider | QSlider | TSpinBox | QSpinBox | TSplitter | QSplitter | TToolBox | QToolBox | TTree | QTreeWidget |
SetDisable<p>Habilita ou desabilita o objeto.</p>TSrvObject(): SetDisable ( < lEnable> ) --> Nome | Tipo | Descrição | Obrigatório | Referência | lEnable | Lógico | Indica se o habilita (.T.) ou desabilita (.F.) o objeto. | X | |
SetEnable<p>Habilita ou desabilita o objeto.</p>TSrvObject(): SetEnable ( < lEnable> ) --> Nome | Tipo | Descrição | Obrigatório | Referência | lEnable | Lógico | Indica se o habilita (.T.) ou desabilita (.F.) o objeto. | X | |
SetFocus<p>Altera o foco da entrada de dados para o objeto.</p>TSrvObject(): SetFocus ( ) --> SetFont<p>Define a fonte do objeto.</p>TSrvObject(): SetFont ( < oFont> ) --> Nome | Tipo | Descrição | Obrigatório | Referência | oFont | Objeto | Indica o objeto do tipo TFont utilizado para definir as características da fonte aplicada na exibição do conteúdo do controle visual. | X | |
oFont := TFont():New('Courier new',,-16,.T.)oObject:SetFont( oFont ) SetProperty<p>Permite alterar o valor de qualquer propriedade do objeto.</p>TSrvObject(): SetProperty ( < cProp>, < xValue> ) --> Nome | Tipo | Descrição | Obrigatório | Referência | cProp | Caracter | Indica o nome da propriedade do objeto. | X | | xValue | Qualquer | Indica o valor que será atribuído à propriedade. | X | |
oObject:SetProperty( "cName", novoValor ) SetText<p>Define o texto do objeto.</p>TSrvObject(): SetText ( < cTexto> ) --> Nome | Tipo | Descrição | Obrigatório | Referência | cTexto | Caracter | Indica o texto do objeto. | X | |
SetUpdatesEnabled<p>Habilita ou desabilita a atualização do objeto.</p>TSrvObject(): SetUpdatesEnabled ( [ lEnable] ) --> Nome | Tipo | Descrição | Obrigatório | Referência | lEnable | Lógico | Indica se habilita (.T.) ou desabilita (.F.) a atualização do objeto. | | |
Utilize esse método quando um determinado conjunto de operações são necessárias mas a visualização de seus passos não. Exemplo: É necessário adicionar 20 itens num objeto do tipo Browse e a visualização da inserção não é relevante ao processo. // Desabilita a atualizaçãooObject:SetUpdatesEnabled( .F. )for nX := 1 to 20 ... insere// Habilita a atualizaçãooObject:SetUpdatesEnabled( .T. ) oObject:SetUpdatesEnabled( .F. ) Show<p>Torna o objeto visível.</p>TSrvObject(): Show ( ) --> Propriedade | Descrição | Tipo | aControls | Indica o array de objetos criados nesta classe. | Vetor | bGotFocus | Indica o bloco de código que será executado quando o objeto ganha foco. | Bloco de código | bHelp | Indica o bloco de código que será executado ao pressionar F1 quando o foco estiver no objeto. | Bloco de código | bLClicked | Indica o bloco de código que será executado quando clicar, com o botão esquerdo do mouse, sobre o objeto. | Bloco de código | bLDblClick | Indica o bloco de código que será executado quando clicar duas vezes, com o botão esquerdo do mouse, sobre o objeto. | Bloco de código | bLostFocus | Indica o bloco de código que será executado quando o objeto perde foco. | Bloco de código | bRClicked | Indica o bloco de código que será executado quando clicar, com o botão direito do mouse, sobre o objeto. | Bloco de código | bValid | Indica o bloco de código de validação que será executado quando o conteúdo do objeto for modificado. Retorna verdadeiro (.T.), se o conteúdo é válido; caso contrário, falso (.F.). | Bloco de código | bWhen | Indica o bloco de código que será executado quando a mudança de foco da entrada de dados, no objeto criado, estiver sendo realizada. Se o retorno for verdadeiro (.T.), o objeto continua habilitado; caso contrário, falso (.F.). | Bloco de código | cCaption | Indica o título ou conteúdo do objeto. | Caracter | cMsg | Indica a mensagem que será apresentada na barra de status, da janela principal, quando o objeto ganha foco. | Caracter | cName | Indica o nome do objeto. | Caracter | cReadVar | Indica o conteúdo da variável atribuída internamente ao objeto. | Caracter | cTooltip | Indica a mensagem que será apresentada quando o objeto exibir sua dica de contexto (tooltip). | Caracter | lActive | Indica se o objeto está (.T.) ou não (.F.) ativo. | Lógico | lCanGotFocus | Indica se objeto pode (.T.) ou não (.F.) receber foco. | Lógico | lVisible | Indica se o objeto é visível (.T.) ou invisível (.F.). | Lógico | lVisible | Indica se o objeto está (.T.) ou não (.F.) visível. | Lógico | nBottom | Indica a altura em pixels. | Numérico | nClientHeight | Indica a altura em pixels. | Numérico | nClientWidth | Indica a largura em pixels. | Numérico | nClrPane | Indica a cor de fundo do objeto. | Numérico | nClrText | Indica a cor do texto do objeto. | Numérico | nHeight | Indica a altura em pixels do objeto. | Numérico | nLeft | Indica a coordenada horizontal em pixels. | Numérico | nRight | Indica a largura em pixels. | Numérico | nTop | Indica a coordenada vertical em pixels. | Numérico | nWidth | Indica a largura em pixels do objeto. | Numérico | nWnd | Indica o manipulador (Handle) do objeto. | Numérico | oCargo | Indica o conteúdo associado ao objeto. | Objeto | oCursor | Indica o tipo de ponteiro do mouse. | Objeto | oFont | Indica o objeto do tipo TFont utilizado para definir as características da fonte aplicada na exibição do conteúdo do controle visual. | Objeto | oParent | Indica a janela ou controle visual onde o objeto será criado. | Objeto | oWnd | Indica o objeto do tipo tDialog ou tWindow onde se encontra este objeto.
Esta propriedade é utilizada apenas para consulta. Qualquer atribuição feita programaticamente nesta propriedade com um objeto de interface válido é ignorada, e qualquer atribuição de objeto inválido ( não pertencente à hierarquia de tDialog ou tWindow ) vai gerar uma ocorrência de erro fatal Advpl "Invalid class type passed to method or property!". | Objeto |
Esta classe não pode ser instanciada diretamente. Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 |