Referência de API — VB6

Documentação de referência do SDK VB6, extraída da fonte real em vb6\sdk\. Documenta apenas membros declarados Public (e Event, que em UserControl é exposto). Assinaturas reproduzidas como no código; a linha de propósito é inferida do corpo/uso.

O SDK VB6 é distribuído em nível de fonte (projeto NeXTFramework) ou como OCX único compilado. Referências externas usadas: ADODB 2.8, stdole2, e os OCX THREED32, MSMASK32, MSCOMCTL, MSCOMCT2.

Conceito em 1 minuto

O SDK é dirigido por metadados, não um gerador de código. Cada controle uc* na tela carrega dois metadados de projeto:

• DataField — a coluna que ele representa.
• TypeControl — o tipo do valor (TipoCaracter), que decide formatação e a

conversão para literal SQL (função central Conv).

O engine (modForms.bas) percorre os controles do Form em tempo de execução, monta o SQL e persiste. Auditoria (codusuario/time_stamp) só é gravada quando a coluna existe (CampoVerificarExistencia), usando o global gCodUsuario.

Nada é gerado em disco. A fonte da verdade é o metadado, lido a cada operação.

Quick-start (padrão low-code de um cadastro)

' 1) configurar a base uma vez (Sub Main / carga do app)
gConfigDB.DBProvider = DBPROVIDERMSACCESS      ' ou DBPROVIDERMYSQL / DBPROVIDERSQLSERV
gConfigDB.DBPath = App.Path & "\app.mdb"
AbreConexao True
SDKConfigPadrao

' 2) na tela, arraste controles low-code e defina no designer:
'    txtCodigo (ucCodigo) -> DataField="codcli", PK=True           (a PK)
'    txtNome   (ucText)   -> DataField="nome"
'    cboCidade (ucCombo)  -> DataField="codcidade", SQL="SELECT codcidade,nome FROM tbcidade"
'    ucToolbar1           -> DataTable="tbcliente", DataField="codcli"

' 3) o ucToolbar faz o CRUD automaticamente (Novo/Salvar/Navegar/Limpar).
'    O form escreve SÓ o que o toolbar nao faz: excluir + load-on-code.
Private Sub cmdToolbar_CommandClick(ByVal p_TypeCommand As TypeCommand)
    If p_TypeCommand = TC_Del Then
        FormExcluir Me, "tbcliente", txtCodigo, "codcli"
        Inicio
    End If
End Sub

Private Sub txtCodigo_Validate(Cancel As Boolean)   ' digitar o codigo carrega o registro
    FormLerRegistro Me, "tbcliente", txtCodigo, "codcli"
End Sub

Um cadastro CRUD completo custa ~3 linhas de código de CRUD (só o TC_Del). Novo/Salvar/Próximo/Anterior/Limpar são 100% automáticos no ucToolbar.

PARTE 1 — Funções (módulos e classes)

modMain.bas

• Public Sub Main() — ponto de entrada do projeto/host.

modForms.bas — Engine de formulários (CRUD automático)

Motor genérico que percorre os controles uc* de um Form (via DataField/ TypeControl) e monta SELECT/INSERT/UPDATE/DELETE automaticamente. Auditoria só é gravada quando a coluna existe; filtro por empresa só quando p_CodEmpresa > 0.

• Public Sub FormLerRegistro(ByRef p_Form As Form, ByVal p_Table As String, ByRef p_txtPK As Object, ByVal p_PK As String, Optional ByRef p_txtPKFK As ucText, Optional ByVal p_PKFK As String, Optional ByVal p_Operacao As QTipoOperacao = LerRegistro, Optional ByVal p_CodEmpresa As Long = 0) — lê um registro pela PK (ou PK+PKFK), preenche todos os controles ligados por DataField, carrega grids de detalhe e coloca o form em FEAlteracao. Suporta navegação Ler/Próximo/Anterior.
• Public Sub FormSalvar(ByRef p_Form As Form, ByVal p_Table As String, ByRef p_txtPK As VBControlExtender, ByVal p_PK As String, Optional ByRef p_txtPKFK As ucText, Optional ByVal p_PKFK As String, Optional ByVal p_CodEmpresa As Long = 0) — decide INSERT vs UPDATE (por valor/tipo da PK e verificação COUNT), monta o comando a partir dos controles ligados, executa em transação, salva grids de detalhe (objGrid.Save) e relê o registro. Gera PK nova via CodInicioPK/CodInicioPKMax quando necessário.
• Public Sub FormExcluir(ByRef p_Form As Form, ByVal p_Table As String, ByRef p_txtPK As Object, ByVal p_PK As String, Optional ByVal p_Confirmar As Boolean = True, Optional ByVal p_CodEmpresa As Long = 0) — exclui o registro pela PK (confirmação opcional), limpa os campos, põe o form em FENovo e atualiza grids em modo listagem.

FormHabilitar e LimpaCampos, embora do "engine de forms", estão em modFuncoes.bas (abaixo).

modFuncoesDB.bas — Engine de banco (ADO)

• Public Function AbreConexao(Optional ByVal p_blnConexaoInicial As Boolean = False) As Boolean — abre a conexão ADO global (conBD) usando gConfigDB. Retorna sucesso.
• Public Sub ExecutaComandoADOConn(ByVal p_strCommand As String, Optional ByRef p_conDb As ADODB.Connection = Nothing) — executa um comando SQL direto numa Connection.
• Public Function ExecutaComando(ByRef p_strComando As String, Optional ByRef p_conDb As ADODB.Connection = Nothing, Optional ByVal p_blnGravaLog As Boolean = True) As Long — executa INSERT/UPDATE/DELETE via ADODB.Command; retorna nº de afetados; log opcional; trata reconexão MySQL.
• Public Function ExecutaComandoArray(ByRef p_arrSQL() As String) As Long — executa um array de comandos SQL em sequência; retorna total afetado.
• Public Function RecuperaRegistroUnicoValor(ByVal p_strSQL As String, Optional p_OutraBaseDados As ADODB.Connection = Nothing) As Variant — retorna o primeiro campo do primeiro registro (escalar).
• Public Sub RecuperaRegistros(ByRef p_QRecordSet As ADODB.Recordset, ByRef p_Comando As String, Optional ByVal p_RetornaDesconectado As Boolean = True, Optional p_OutraBaseDados As ADODB.Connection = Nothing, Optional ByVal p_blnGravarLog As Boolean = True, Optional ByVal p_blnKeySetOptmistic As Boolean = False, Optional ByVal p_RecordSetIncusaoAlteracao As Boolean = False) — abre um Recordset (por padrão desconectado) de um SELECT.
• Public Function AdaptaQueryMySQL(ByRef p_strQuery As String) As String — adapta a query para dialeto MySQL.
• Public Function AdaptaQuerySQLServer(ByRef p_strQuery As String) As String — adapta a query para dialeto SQL Server.
• Public Function CampoVerificarExistencia(ByVal p_strTabela As String, ByVal p_strCampo As String) As Boolean — verifica se uma coluna existe (auditoria condicional).
• Public Function LastInsertId() As Long — último ID auto-incremento inserido.
• Public Function CodInicioPK(ByVal p_strTabela As String, ByVal p_strPK As String, ByVal p_blnUtilizarMax As Boolean, Optional ByVal p_lngValorDefault As Long) As Double — próximo valor de PK (via tbpk quando gPKAvancado, ou MAX(pk)+1).
• Public Function CodInicioPKMax(ByVal p_strTabela As String, ByVal p_strPK As String, Optional ByVal p_strPKFK As String, Optional ByVal p_lngCodPKFK As Long) As Double — próximo PK dentro de agrupamento por PKFK (chave composta).

modFuncoes.bas — Utilitários gerais / engine de UI

Seleção dos membros mais usados (o módulo é extenso):

• Public Sub FormHabilitar(ByRef p_objForm As Form, ByVal p_iEstadoForm As FormEstado, Optional ByVal p_strCampoCodigo As String = "txtCodigo", Optional ByVal p_strBotaoComando As String = "cmdBotoes", Optional ... ) — habilita/desabilita campos e botões da toolbar conforme o estado CRUD (FormEstado). Núcleo do engine de UI. (Vários parâmetros opcionais mapeiam índices de botões; ver fonte.)
• Public Sub LimpaCampos(ByRef p_objForm As Form, Optional ByVal p_blnLimparListView As Boolean = True) — limpa todos os controles ligados do form (e ListViews opcionalmente).
• Public Sub SetaFoco(ByRef Controle As Object, Optional ByVal p_blnEmpty As Boolean = False) — coloca foco num controle (opc. limpando-o).
• Public Sub SetaMouse(Optional ByVal p_Tipo As MousePointerConstants = vbArrowHourglass) — altera o cursor (ampulheta por padrão).
• Public Sub Mensagem(ByVal Mens As String, Optional ByVal Complemento As String) — mensagem padronizada ao usuário.
• Public Sub TrataErro(ByVal p_Formulario As String, Optional ByVal p_strMensagem As String = "", ...) — trata/mostra/loga erro padrão.
• Public Function TrataErroCritico(ByVal p_Formulario As String, Optional ByVal p_blnRollBackTrans As Boolean = True) As VbMsgBoxResult — erro crítico com rollback opcional.
• Public Sub GravaLogErro(...) / Public Sub GravaLogComando(ByVal Comando As String) — logs de erro/transação.
• Public Sub MostraInicio() / Public Sub MostraFim() — mensagens de início/fim de registros.
• Public Function FormShow(ByVal p_NomeForm As String, Optional ByVal p_blnModal As Boolean = False) As Boolean — exibe um form pelo nome (modal opcional).
• Public Function FormShow2(ByVal p_Form As Form, Optional ByVal p_blnModal As Boolean = False) As Boolean — exibe uma instância de form já carregada.
• Public Function FormLoad(ByVal p_strNmForm As String) As Boolean — carrega (Load) um form pelo nome.
• Public Function FormFindControl(ByRef p_Formulario As Form, ByVal p_strControlName As String) As Boolean — verifica se um controle existe no form pelo nome.
• Validações: Public Function CheckCPF(ByVal CPF As String) As Boolean; Public Function CheckCNPJ(ByVal CNPJ As String) As Boolean; Public Function VerificaCPFCNPJ(ByRef Controle As Control, ByVal TipoPessoa As TipoPessoa, ...); Public Function ConsisteData(ByVal Campo As String, Optional ByVal p_blnPermiteBranco As Boolean = False, Optional ByVal p_blnMostraMsg As Boolean = True) As Boolean; Public Function ConsisteHora(ByVal p_strHora As String, Optional ByVal p_blnPermiteBranco As Boolean = False) As Boolean; Public Function ValidarPeriodoDatas(ByVal p_strDataInicial As String, ByVal p_strDataFinal As String) As Boolean; Public Function ValidarDigitoEAN13(ByVal p_strEAN13) As Boolean.
• Digitação/formatação: Public Function InibeCaracteres(ByVal ValorAsc As Long, ByVal Tipo As QTipoCaracter) As Long; Public Sub FormatarCampo(ByRef p_Controle As TextBox, ByRef p_Panel As SSPanel, ByVal p_TipoCampo As FormatarCampoTipo, ...); Public Sub FormataData(ByRef ControleTexto As Object).
• Diversos: Public Sub AbreURL(ByVal p_strURL As String); Public Sub WhatsAppAbrir(ByVal p_strFone As String, Optional ByVal p_strMsg As String); Public Function RetornarHostName() As String; Public Function UBound2(ByRef p_Array As Variant) As Long; funções de processo Windows (VerificarProcessoWindows, TerminarProcessoWindows).

modFuncoesCombo.bas — ComboBox nativo

• Public Sub CarregarComboSQL(ByRef p_objCombo As ComboBox, ByVal p_SQL As String, Optional ByVal p_lngCodigoSel As Long, ...) — popula o combo a partir de um SELECT (código/descrição) e seleciona um código.
• Public Sub CarregarComboArray(ByRef p_objCombo As ComboBox, ByRef p_Array As Variant, Optional ByVal p_lngCodigoSel As Long, ...) — popula o combo a partir de um array.
• Public Sub ProcuraCombo(ByRef Combo As ComboBox, ByVal Valor As Variant, ...) — seleciona no combo o item cujo ItemData/texto corresponde ao valor.
• Public Function RetornarValorCombo(ByRef p_objCombo As ComboBox, Optional ByVal p_blnRetornarListIndexSeNaoSelecionado As Boolean = False) As Long — retorna o ItemData do item selecionado (ou ListIndex).

modFuncoesData.bas — Datas e horas

• Public Function FData(ByVal Qdata As Variant, Optional ByVal p_blnHora As Boolean = False) As String — formata data (DD/MM/AAAA, hora opcional) para exibição.
• Public Function FDataMySQL(ByVal p_strData As String, Optional ByVal p_blnHora As Boolean = False) As String — formata para literal MySQL (AAAA-MM-DD).
• Public Function FDataYMD(...) As String / Public Function FDataDMA(...) As String — conversões Y-M-D / D/M/A.
• Public Function FHora(ByVal p_strValor As Variant, Optional ByVal p_blnConsiste As Boolean = False) As String — formata hora (consistência opcional).
• Public Function AdicionarDiasData(ByVal p_strData As String, ByVal p_intDias As Long, Optional ByVal p_blnDataComercial As Boolean = True) As String — soma dias (com opção de dias úteis).
• Public Function RetornarTimeStamp(Optional ByVal p_strFData As String, Optional ByVal p_intNumAdicionar As Long, ...) As String — timestamp atual/derivado para auditoria.
• Public Function FDataTimeStamp(ByVal p_strTimeStamp As String, Optional ByVal p_blnHora As Boolean = True, ...) As String — formata timestamp para exibição.
• Public Function RetornarUltimoDiaMes(ByVal p_lngMes As Long, ByVal p_lngAno As Long) As Long; Public Function RetornarDiaSemana(...); Public Function VerificarDataUtil(ByVal p_strData As String) As Boolean; Public Function RetornaDataDiaUtil(ByVal p_strData As String) As String; Public Function CompararDatas(...) As Long; Public Function ExtensoData(...); Public Function ExtensoMonth(...); Public Sub RetornarPeriodoInicialFinal(...).

modFuncoesString.bas — Strings, números, moeda, hash, base64

Convenção: F* formata para exibição; D* desformata/converte para armazenamento.

• Conversão central: Public Function Conv(ByVal Campo As Variant, ByVal Tipo As TipoCaracter, ...) — converte/escapa um valor para literal SQL conforme TipoCaracter (numérico, data, moeda, procura/LIKE, etc.). Usada por todo o engine.
• Public Function ENulo(ByRef Valor As Variant, Optional ByVal Tipo As TipoCaracter = Alfanumerico, Optional ByVal p_blnConvertNull As Boolean = False, Optional ByVal p_lngTamMax As Long) As Variant — trata Null/vazio, retornando default por tipo.
• Moeda/qtde/peso: FMoeda, DMoeda/DMoedaP/DMoedaDbl, FQtde/DQtde, FPeso/DPeso/DPesoDbl, Arredondar/Arredondar2.
• Máscaras: FormataCep, FormataTelefone, FormataCPFCNPJ, FormataIE; fiscais FCFOP/DCFOP, FNCM/DNCM, FCEST/DCEST.
• Texto: AllTrim, LimitaTexto, AlinhaTexto, Zeros, CNumerico, RetirarCaracteresEspeciais, RetirarEspacos/RetirarEspacosDuplicados/RetirarEnter, Concatenar, RastreiaString, QtdeCaracteres, SplitLinha, URLEncode.
• Extenso/XML/HTML: ExtensoValor, ExtensoNF, FTagXML/FTagXML2, RetornarValorXMLTag, ConverterCaracteresHTML, CorteHTML.
• Cripto/hash/base64: Criptografa(usuario, senha, Modo, ...), SHA1, sha1hex, HexaToString/StringToHexa, Base64Encode/Base64ToText/TextToBase64, ConvertFileToBase64/ConvertBase64ToFile.
• Public Function ConvertFieldType(ByVal p_FieldType As DataTypeEnum) As TipoCaracter — mapeia tipo ADO para TipoCaracter.

modFuncoesListView.bas — ListView (MSCOMCTL)

• Public Sub lvwLimpar(ByRef p_lvwListView As ListView, Optional ByVal p_blnAjustar As Boolean = False, ...) — limpa o ListView.
• Public Sub lvwAjustar(ByRef LV As ListView, Optional ByVal p_intColFixa As Long, Optional ByVal p_intColFixa2 As Long, ...) — ajusta larguras (colunas fixas opcionais).
• Public Sub lvwAdicionarItem(ByRef p_lvwListView As ListView, ByRef p_strTexto As String, ...) — adiciona um item.
• Public Sub lvwAdicionarSubItem(ByRef p_lvwListView As ListView, ByRef p_strTexto As String, ...) — adiciona um subitem à linha corrente.

modRelatorio.bas — Relatório genérico

• Public Function GerarRelatorioSQL(ByVal p_SQL As String, ByVal p_Titulo As String, Optional ByVal p_Formato As String = "HTML") As String — executa um SELECT e gera arquivo de relatório (HTML/TXT); retorna o caminho.
• Public Sub AbrirArquivo(ByVal p_Path As String) — abre um arquivo no aplicativo associado.

modGDI.bas — Wrapper GDI+ (suporte aos controles gráficos)

Majoritariamente interno. Públicas: ColorARGB, ColorSetAlpha, GetRGB_GDIP2VB/GetRGB_VB2GDIP, GetEncoderClsid/GetDecoderClsid, DEFINE_GUID, PtrToStrW/PtrToStrA, GetPropValue.

modDeclaracoesSDK.bas — Declarações globais

Enums: TipoCampo (TCVarChar=0 … TCDouble=15), QTipoCaracter (Letras/Numeros/CaracterEspecial), QTipoOperacao (LerRegistro=0/ProximoRegistro=1/RegistroAnterior=2), RetornoOperacao, FormatarCampoTipo (fctMoeda=1/fctQtde=2/fctData=3/fctHora=4/fctString=5), FormatarCampoEvento, Conv_Car, Alinhamento (alEsquerda/alDireita/alCentro), Criptografia_Modo, TipoPessoa (tpFisica=0/tpJuridica=1).

Types + globais:

• CONFIG_DATABASE = { DBProvider, DBPath, DBServer, DBUser, DBPassword, DBDatabase, DBPort } (String) → Public gConfigDB As CONFIG_DATABASE.
• CONFIG_GERAL = { CasasDecimaisValor, CasasDecimaisQtde, CasasDecimaisPeso, GravarUpper, ProcuraAvancada, ValidarCNPJCPF, LogErros, LogTransacao, PathLog } → Public gConfig As CONFIG_GERAL.
• ERR_CLS → Public gErr As ERR_CLS. PROCESSENTRY32 (Win32).

Globais: strQuery (query montada pelo engine), gCodUsuario As Long (0 = sem auditoria), conBD As ADODB.Connection, Conexao As clsConexao, gPKAvancado As Boolean (False=MAX+1, True=tabela tbpk), gDebug As Boolean.

Consts: DBPROVIDERMSACCESS="Microsoft.Jet.OLEDB.4.0", DBPROVIDERMYSQL="MSDASQL.1", DBPROVIDERSQLSERV="SQLOLEDB.1", cNOMESOFTWARE="NeXT LowCode SDK", operadores OPLIKE/OPDATA, mensagens MSGxxx, tags de estado, cURLWHATSAPPAPI, etc.

Sub: Public Sub SDKConfigPadrao() — aplica defaults sensatos em gConfig.

clsConexao.cls

Wrapper da conexão ADO que rastreia estado transacional via eventos.

• Public WithEvents conexaoBD As ADODB.Connection — a conexão observada.
• Public blnTrans As Boolean — True enquanto há transação aberta.

clsStringBuilder.cls

Construtor de strings eficiente (chunk buffer).

• Propriedades: length (Get), Capacity (Get), ChunkSize (Get/Let), ToString (Get), TheString (Get/Let).
• Métodos: Append/AppendByVal/AppendLine, Clear, Insert/InsertByVal, Remove, Find, HeapMinimize.

NeXTSDK.cls — Fachada pública (GlobalMultiUse)

Expõe a API ao host; cada método delega ao módulo qualificado. Hospeda também os enums de domínio globais do projeto:

• TipoCaracter: Alfanumerico=0, Numerico=1, DataDMY=2, Procura=3, ProcuraFull=4, ValorNumerico=5, Quantidade=6, DataTimeStamp=8, AlfanumericoBranco=9, NumericoNotNull=10, ProcuraNumerico=11, Peso=15, HoraMinSeg=17, AlfanumericoCaixaAltaBaixa=18, AlfanumericoBrancoNull=19, QuantidadeNotNull=20, ValorNumericoNotNull=21, DataDMYHora=22, ValorNumerico4Casas=23, ValorNumerico2Casas=27, SemFormatacao=99
• FormEstado: FEInclusao=1, FEAlteracao=2, FEExclusao=3, FENovo=4, FEConsulta=5

Membros (e a quem delegam):

• AbreConexao(Optional pConexaoInicial As Boolean = False) As Boolean → FuncoesDB.AbreConexao.
• ExecutaComando(ByRef pSQL As String, Optional pGravaLog As Boolean = True) As Long → FuncoesDB.ExecutaComando.
• FormLerRegistro(pForm As Object, pTable As String, ptxtPK As Object, pPK As String, Optional pOperacao As Long = 0) → modForms.FormLerRegistro.
• FormSalvar(pForm As Object, pTable As String, ptxtPK As Object, pPK As String) → modForms.FormSalvar.
• FormExcluir(pForm As Object, pTable As String, ptxtPK As Object, pPK As String) → modForms.FormExcluir.
• FormHabilitar(pForm As Object, pEstado As FormEstado) → Funcoes.FormHabilitar.
• LimpaCampos(pForm As Object, Optional pLimparListView As Boolean = True) → Funcoes.LimpaCampos.
• SetaFoco(pControle As Object, Optional pEmpty As Boolean = False) → Funcoes.SetaFoco.
• SetaMouse(Optional pTipo As MousePointerConstants = vbArrowHourglass) → Funcoes.SetaMouse.
• TrataErro(pFormulario As String, Optional pMensagem As String = "") → Funcoes.TrataErro.
• SDKConfigPadrao() → modDeclaracoesSDK.SDKConfigPadrao.
• ConfigurarBanco(pProvider As String, Optional pPath, pServer, pDatabase, pUser, pPassword, pPort As String) — preenche gConfigDB.
• Propriedades: PKAvancado (Get/Let → gPKAvancado), CodUsuario (Get/Let → gCodUsuario), ProviderMSAccess/ProviderMySQL/ProviderSQLServer (Get → consts).
• ConsultarEscalar(pSQL As String) As String — 1º campo da 1ª linha.
• FormatarMoeda(pValor As Double) As String → FMoeda; MoedaParaNumero(pTexto As String) As Double → DMoedaDbl.
• ProcurarRegistro(pTitulo As String, pSQL As String) As String — abre frmLookupSDK e retorna a chave escolhida.
• RelatorioSQL(pSQL As String, pTitulo As String, Optional pFormato As String = "HTML") As String — gera relatório e exibe.

PARTE 2 — Controles OCX (uc*)

Convenções comuns. Os controles data-bound compartilham propriedades padrão de UserControl VB6 (passthrough): Name, hwnd, Enabled, Font, BackColor, ForeColor, ToolTipText, Caption, Container, Tag etc. Abaixo destacam-se as propriedades de metadados/binding e específicas, mais métodos e eventos. Todos expõem os eventos de persistência InitProperties/ReadProperties/WriteProperties (padrão do VB6), omitidos das tabelas. Validate() é um método (Function As Boolean), não um evento.

ucText — caixa de texto genérica

Métodos: Refresh, Size(Width, Height), ValidateControls, Validate() As Boolean. Eventos: (só persistência).

ucCodigo — campo de código/PK com procura

Enums: TypeFind (TF_Nenhum=0, TF_Clientes=1, TF_Produtos=2, TF_NF=3, TF_Fornecedores=4); TypeDetail (TD_Nenhum=0, TD_Cliente=1, TD_Produto=2, TD_Transportador=3).

Métodos: Size, Refresh, ValidateControls, Validate() As Boolean, ExibirNome(p_Name As String). Eventos: Procura() — clique no botão de procura.

ucMask — campo com máscara (MaskEdBox)

Propriedades: DataField, DataTable, TypeControl, Mask (String), Format (String), PromptInclude (Boolean), PromptChar (String), Text, Value (Get). Métodos: Refresh, Validate() As Boolean. Eventos: Change().

ucMemo — texto multilinha

Propriedades: DataField, DataTable, TypeControl, Text, Value (Get), MaxLength. Métodos: Refresh, Validate() As Boolean. Eventos: (só persistência).

ucCPFCNPJ — documento (Física/Jurídica + máscara)

Status: stub de design na fonte atual. Não expõe propriedade/método/evento Public (só um handler privado de foco). Sem binding exposto por ora.

ucNumeroSpin — numérico com spin

Métodos: Refresh, Validate() As Boolean. Eventos: Change().

ucData — campo de data (com calendário)

Propriedades: DataField, DataTable, TypeControl (Get), Text, NowIsEmpty (Boolean, Get/Let) (se vazio assume data atual), BackColorOnFocus (OLE_COLOR), Container (Get/Set). Métodos: Size, Refresh, ValidateControls, Validate() As Boolean. Eventos: (só persistência).

ucHora — campo de hora

Propriedades: DataField, DataTable, TypeControl (Get), Text, NowIsEmpty (Boolean), Container (Get/Set). Métodos: Size, Refresh, ValidateControls, Validate() As Boolean. Eventos: (só persistência).

ucCheck — checkbox (grava 0/1)

Propriedades: DataField, DataTable, Value (Long, Get/Let). Métodos: Refresh, ValidateControls, Size. Eventos: Click(), MouseDown(Button, Shift, X, y).

ucOption — radio button

Propriedades: Caption (String), Value (Long), DataField, DataTable, Enabled, ForeColor/BackColor, Font (Get/Set), Name (Get). Métodos: (só acessores). Eventos: Click().

ucCombo — combo SQL-driven com detalhe

Enums: TypeComboEnum (TC_Nenhum=0, TC_CondicaoPagto=7, TC_Funcionario=8, TC_CFOP=10, TC_UF=50, TC_TipoOperacao=51, TC_RegrasFiscais=52, TC_ClassTrib=53, TC_CSTIBSCBS=54, TC_NFSePadrao=55); ComandoConstants (Com_Nenhum=0, Com_ParcelasReceber=1); DetalheConstants (Det_Nenhum=0, Det_Cliente=1, Det_CondicaoPagto=7, Det_Funcionario=8, Det_CFOP=10, Det_TipoOperacao=51, Det_RegrasFiscais=52, Det_ClassTrib=53, Det_CSTIBSCBS=54, Det_Generico=99); DescricaoLayoutEnum (DL_DescricaoeCodigo=0, DL_SomenteDescricao=1, DL_SomenteCodigo=2).

Métodos: Recarregar() (recarrega conforme SQL/TypeCombo/FK), Clear(), AddItem(p_Item As String), Refresh, ValidateControls, Size, Validate() As Boolean. Eventos: Change(), Click(), MouseDown(...), ComandoClick(p_Index As Long), DetalheClick(p_Index As Long) (abre cadastro relacionado).

ucGrid — grade (listagem ou master-detail)

Métodos: Limpar([p_blnAjustarColunas]), ClearColumns, AddColumn(p_Name, p_Align, [p_Width=1500], [p_Field], [p_Control], [p_Tipo=0]), AplicarColunas, MapColumnField(p_Column, p_Field, p_Control), ClearControls, RemoveRow([p_lngRow]), AddRow([p_lngRow]), AddRowCol(p_Col As Collection), AddRowArray(p_Array() As String), AddRowEmpty() As Long, Save() As Boolean, Load() As Boolean, Atualizar([p_SQL]), Validate() As Boolean, ColIndex(p_Field) As Long, GetValue(p_Row, p_Field) As String, SetValue(p_Row, p_Field, p_Value), Refresh. Eventos: ItemClick(Item As ListItem), ItemCheck(Item As ListItem), Selecionou(Codigo As String).

ucAddRemove — barra Adicionar/Remover de um ucGrid

Enum: TypeAddRemove (TC_Add, TC_Remove, TC_Clear, TC_ClearAll = 0..3).

Eventos: AddRemoveClick(p_TypeAddRemove As TypeAddRemove).

ucToolbar — barra CRUD padrão

Enum: TypeCommand (TC_New, TC_Save, TC_Del, TC_Next, TC_Previous, TC_Baixa, TC_Print, TC_Print2, TC_Excel, TC_Nota, TC_PDF, TC_Anexo, TC_Procura, TC_Help, TC_Limpar, TC_Exit = 0..15).

Propriedades: binding DataField (String), DataTable (String), ControlFocus (String); e para cada botão um par Enable/Visible (Boolean, Get/Let): New*, Save*, Del*, Next*, Prev*, Baixa*, Print*, Print2*, Excel*, Nota*, PDF*, Attach*, Find*, Help*, Clear*, Exit*. Métodos: LabelCaption(p_Command As TypeCommand, p_Caption As String). Eventos: CommandClick(p_TypeCommand As TypeCommand).

Auto-CRUD: com DataTable/DataField/ControlFocus definidos no designer e a PK em txtCodigo (convenção), o toolbar executa Novo/Salvar/Navegar/Limpar automaticamente após disparar CommandClick. O TC_Del fica vazio de propósito (o host trata a exclusão destrutiva).

ucImagem — imagem com binding

Métodos: (só acessores). Eventos: nenhum público. Persiste o caminho da imagem.

ucFrame — container/moldura (não data-bound)

Propriedades: hwnd (Get), BackColor, ForeColor, Enabled, Font (Get/Set), BorderStyle, Caption, ToolTipText, Name (Get). Métodos: Refresh. Eventos: Click(), DblClick().

ucLabelText — rótulo read-only ligado a coluna

Propriedades: DataField, DataTable, Text, Caption, Alignment, FillStyle/FillColor (sem TypeControl). Métodos: Refresh, Size. Eventos: Click(), DblClick().

ucLabelPlus — rótulo avançado GDI+ (imagem/gradiente/callout)

Rótulo renderizado em GDI+ com ícone (fonte de ícones), sombra, gradiente, borda arredondada, callout/balão, blur acrílico, rotação e carga de imagem por URL; binding leve por SQL. Conjunto muito extenso de propriedades (grupos: Caption, Cor/fundo, Borda, Sombra, Callout, Imagem, Ícone, HotLine, Interação). Métodos-chave: CarregarSQL(pSQL), Draw(hdc, hGraphics, PosX, PosY), Refresh, LoadPicture(SrcImg) As Boolean, PictureFromURL(sUrl, [UseCache], [DrawProgress]) As Boolean, PictureGetStream() As Byte(), PictureDelete(), DrawLine(...), Polygon(...). Eventos: Click, DblClick, MouseDown/Move/Up, MouseEnter/Leave/Over/Out, PrePaint/PostPaint, KeyPress/KeyUp/KeyDown, OLEDragDrop/OLEDragOver, PictureDownloadProgress/Complete/Error, TabFocus.

Controles gráficos (dashboards)

Visualização em GDI+, carga por SQL. Todos expõem Image([Width], [Height]) As IPicture, Refresh, GetWindowsDPI() As Double, RGBtoARGB(...) e os eventos Click, DblClick, MouseDown/Move/Up.

• ucChartBar — barras/linhas, múltiplas séries, legenda, eixos. Métodos: Clear, AddSerie(SerieName, SerieColor, Values As Collection, [cCustomColors]), UpdateSerie(...), AddAxisItems(AxisItems As Collection, ...), CarregarSQL([pSQL]). Props: SQL, Title/TitleFont, ChartStyle, LabelsPositions, LegendAlign, AxisMax/AxisMin, cores/linhas.
• ucChartArea — área/linha. Métodos: Clear, AddLineSeries(SerieName, Values As Collection, SerieColor), AddAxisItems(...), CarregarSQL([pSQL]). Props: SQL, AxisMax/AxisMin, LegendAlign, cores/linhas.
• ucPieChart — pizza/rosca. Métodos: Clear, AddItem(ItemName, Value, ItemColor, [Special]), GetCenterPie(X, y), CarregarSQL([pSQL]). Props: Count (Get), ItemColor(Index), DonutWidth, Rotation, ChartStyle, LabelsPositions, LegendAlign. Evento extra: ItemClick(Index As Long).
• ucTreeMaps — treemap. Métodos: Clear, CarregarSQL(pSQL), AddLineSeries(SerieName, SerieColor, cValues As Collection, [cLabels], [cIconsFonts], [cKeys], [cCustomColors]). Props: LabelsPositions, IconsPositions/IconFont, LegendAlign, ShowToolTips, CornerRound. Evento extra: ItemClick(Key As Variant).
• ucProgressCircular — progresso circular/gauge animado. Métodos: CarregarSQL(pSQL), AddPaletteColors(lPalette()), GetPaletteColors() As Long(), DrawGradientArc(...). Props: Value (Single), Min/Max, Angle/StartAngle/GradientAngle, Caption1/Caption2 (+ForeColor/Font), DisplayInPercent, ShowAnimation/AnimationInterval, estilos de anel (PF_*/PB_*/Center*).

Observações finais

• ucCPFCNPJ é o único controle sem membro público (stub de design na fonte atual).
• Os controles data-bound expõem eventos de domínio específicos (Procura,

ComandoClick, DetalheClick, CommandClick, AddRemoveClick, ItemClick, ItemCheck, Selecionou, Change), não os eventos genéricos Click/Mouse*. Os controles gráficos e ucLabelPlus usam Public Event (incluindo Click/Mouse*).

• Validate() é método (Function As Boolean), não evento.
• Eventos de persistência (InitProperties/ReadProperties/WriteProperties) foram

omitidos por serem padrão do VB6 UserControl.