Método AddCollectionItem

Prototipo

AddCollectionItem Proto hHandle:HANDLE, lpszString:LPSTR

Sintaxis

Invoke AddCollectionItem, hHandle, lpszString

Función

Agrega un nuevo ítem (cadena) a una colección.

Parámetros

hHandle

"Handle" de la colección.

lpszString

Puntero a la dirección efectiva de la cadena acabada en cero que debe agregarse.

Valor de retorno

Eax devuelve el índice en base cero de la cadena agregada.

OBSERVACIONES: Si la colección ha sido creada con el parámetro bSorted puesto a TRUE (vea el método CreateCollection) la cadena se inserta en la colección y la colección se ordena alfabéticamente. De lo contrario, la cadena se agrega al final de la colección.

OBSERVACIONES: El método AddCollectionItem agregará lpszString como una cadena Unicode si la aplicación se está ejecutando como Unicode, o como una cadena ANSI si no (vea el método IsAppUnicode). Puede utilizar AddCollectionItemA para agregar cadenas ANSI, o AddCollectionItemW para agregar cadenas Unicode.